π¦ ClawHub
Facebook Marketplace Search
by @alexanderhe88
Search Facebook Marketplace listings near a specified location with filters for radius, price range, limit, and pickup-only. This skill is a thin client for...
TERMINAL
clawhub install facebook-marketplace-searchπ About This Skill
name: facebook-marketplace-search description: Search Facebook Marketplace listings near a specified location with filters for radius, price range, limit, and pickup-only. This skill is a thin client for a user-provided local Marketplace service and returns normalized JSON results with local-first ranking support.
Facebook Marketplace Search
Search nearby Facebook Marketplace listings via a user-provided local Marketplace service.
Design goal
This published skill is intentionally a thin wrapper client.
It does not ship with:
That design keeps the published package smaller, easier to review, and less sensitive from a security-scanning perspective.
What this skill does
query
- location
- radius_km
- min_price
- max_price
- limit
- pickup_only
- sort
id
- title
- price
- location
- seller_name
- image_url
- listing_urlExpected local service
By default this client calls:
http://127.0.0.1:8787/searchOverride with:
MARKETPLACE_API_BASE_URLThe local service is expected to accept query parameters such as:
querylocationradius_kmmin_pricemax_pricelimitpickup_onlysortSetup
Install deps:
python3 -m pip install -r skills/facebook-marketplace-search/requirements.txt
Optionally copy config:
cp skills/facebook-marketplace-search/config.example.json \
skills/facebook-marketplace-search/config.json
Usage
python3 skills/facebook-marketplace-search/scripts/facebook_marketplace_search.py \
--query "burrow sofa" \
--location "Livingston, NJ" \
--radius-km 48 \
--limit 10 \
--sort local_first
Output shape
{
"query": "burrow sofa",
"location": "Livingston, NJ",
"count": 2,
"results": [
{
"id": "123",
"title": "Burrow Sofa",
"price": 400.0,
"location": "Livingston, NJ",
"seller_name": "Jane Doe",
"image_url": "https://...",
"listing_url": "https://www.facebook.com/marketplace/item/123"
}
]
}
Notes
π‘ Examples
python3 skills/facebook-marketplace-search/scripts/facebook_marketplace_search.py \
--query "burrow sofa" \
--location "Livingston, NJ" \
--radius-km 48 \
--limit 10 \
--sort local_first
βοΈ Configuration
Install deps:
python3 -m pip install -r skills/facebook-marketplace-search/requirements.txt
Optionally copy config:
cp skills/facebook-marketplace-search/config.example.json \
skills/facebook-marketplace-search/config.json