Spiral gives your agent every tool with one account. Browse the tools →

opencode · E-commerce

How to Use Facebook Marketplace listing search in opencode

Search Facebook Marketplace listings for titles, asking prices, locations, photos, listing links, and availability flags. Use it to compare local offers or find sourcing candidates before reviewing individual listings.

Prompts to try with Facebook Marketplace listing search in opencode

Copy an example into opencode, or ask in your own words.

Use Facebook Marketplace listing search for standing desks around Austin, Texas. Add a table to this project showing returned titles, asking prices, cities, primary photos, and listing links.

Facebook Marketplace listing searchopencode
Try asking
  • Use Facebook Marketplace listing search for cordless drills around Chicago, Illinois. Write an export in this project that follows pagination, removes duplicate listing IDs, and saves titles, asking prices, and URLs.

  • Use Facebook Marketplace listing search for bicycles around Portland, Oregon. Add logic to this project's existing monitor that compares asking prices by listing ID and reports observed reductions.

  • Use Facebook Marketplace listing search for commercial shelving around Dallas and Fort Worth, Texas. Build a comparison view in this project that groups returned listings by city and removes overlapping IDs.

  • Use Facebook Marketplace listing search for sectional sofas around Phoenix, Arizona. Update this project's importer to preserve listing links, primary photo URLs, and nullable listing dates.

How to set up Facebook Marketplace listing search in opencode

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

    opencode mcp add spiral --global --url https://api.spiral.ai/mcp
  2. Sign in

    Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    opencode mcp list

Use the Spiral skill

  1. Send opencode this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Facebook Marketplace listing search

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "scrapecreators",
        "model": "scrapecreators/facebook-marketplace-search",
        "input": {
          "lat": 30.2677,
          "lng": -97.7475
        }
      }'

Then paste one of the prompts above: opencode finds Facebook Marketplace listing search on Spiral, shows the price and runs it.

Facebook Marketplace listing search providers and prices

Spiral runs Facebook Marketplace listing search through ScrapeCreators. Open a card for today's price, with every fee included.

ScrapeCreatorsE-commerce
Facebook Marketplace · Marketplace Search
scrapecreators/facebook-marketplace-search

Settings you can ask for

Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Lata number

Latitude for the search location

Lnga number

Longitude for the search location

Sort bysuggested, distance_ascend, creation_time_descend, price_ascend, or price_descend

Facebook Marketplace sort option. creation_time_descend usually orders the first pages newest first, but Facebook can insert newer listings on later cursor pages.

Conditionnew, used_like_new, used_good, or used_fair

Condition filter

Max pricea number

Maximum listing price

Min pricea number

Minimum listing price

Radius kma number

Search radius in kilometers

Date listedall, 1, 7, 30, last_24_hours, last_7_days, or last_30_days

Facebook Marketplace date filter. Uses the same calendar-day buckets as the UI, so last_24_hours can include listings from the prior calendar day.

Availabilityavailable, sold, or all

Availability filter

Delivery methodall, local_pickup, or shipping

Delivery filter

Every API field of Facebook Marketplace · Marketplace Search is on its tool page: open its card above.

What can you do with Facebook Marketplace listing search in opencode?

Build a local sourcing table with Facebook Marketplace listing links, asking prices, locations, and photos. Use listing IDs to merge pages and compare repeated searches without duplicating offers.

Build a local asking-price comparison

Compare returned standing-desk listings around Austin by title, asking price, and city. Link each comparable offer to its original listing for review.

Find equipment for a business

Search Chicago for commercial shelving and assemble a purchasing shortlist with listing links, primary photos, locations, and asking prices.

Watch for newly observed inventory

Repeat a Milwaukee cordless-drill search and compare listing IDs with earlier results. Report newly observed offers without assuming their first appearance is their publication date.

Detect asking-price changes

Compare asking prices for the same listing IDs across repeated Portland bicycle searches. Produce a review list of offers whose observed price fell.

Compare sourcing locations

Search the same product around Dallas and Fort Worth, then compare the returned offers by city and asking price. Remove overlapping IDs before counting listings.

Create a listing review worksheet

Turn returned Phoenix sectional-sofa listings into rows containing title, asking price, city, photo link, and original listing URL for a furniture buyer.

Facebook Marketplace listing search success rate and speed on Spiral

Success and speed over the last 24 hours, across every run of these tools on Spiral.

Success rate
99.8%
Fastest median run time
4.3s
Runs, last 24 hours
531
ToolSuccessMedian timeRuns
Facebook Marketplace · Marketplace Search99.8%4.3s531

Questions about Facebook Marketplace listing search in opencode

Can opencode use Facebook Marketplace listing search?

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Facebook Marketplace listing search like any built-in tool.

How much does Facebook Marketplace listing search cost in opencode?

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

Do I need a ScrapeCreators account to use Facebook Marketplace listing search in opencode?

No. Spiral runs Facebook Marketplace listing search on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

How long does it take to set up Facebook Marketplace listing search in opencode?

About two minutes: add the server, then sign in, then check it.

Does opencode wait while Facebook Marketplace listing search runs?

Facebook Marketplace listing search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

What Facebook Marketplace data does the search return?

It returns public listing summaries with titles, asking prices, locations, primary photos, listing links, and availability flags. It does not provide private account data.

How fresh are Facebook Marketplace results?

ScrapeCreators says it fetches the latest available information when you request it. Facebook's newest-first results can still change order between identical searches, and newer listings can appear beyond the first page.

How many listings does one search return?

Page size can vary: the provider's September 15, 2026 test returned 24 rows on the first page and 12 on the second. Two IDs overlapped, leaving 34 unique listings, so count results after deduplication.

Will every result fall inside the requested area?

The radius is not a strict geographic guarantee. The provider's Austin test used a 65 km radius but still returned a San Antonio listing; check returned locations before including listings in a local comparison.

Does public visibility mean automated collection is permitted?

Meta says automated collection from its products requires prior permission. A listing being publicly visible does not remove that requirement.

Get started

Start using Facebook Marketplace listing search in opencode

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into opencode:

Set up opencode

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options