[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Facebook Marketplace listing search](https://spiral.ai/integrations/opencode/facebook-marketplace-listing-search)

# 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.

|  |  |
| --- | --- |
| Model | Facebook Marketplace listing search |
| Available through | ScrapeCreators |
| Category | E-commerce |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Facebook Marketplace listing search in opencode

- 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.
- 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.

```bash
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.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
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.

```bash
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.

```bash
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.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## Facebook Marketplace listing search tools and prices

- [Facebook Marketplace · Marketplace Search](https://spiral.ai/tools/scrapecreators/scrapecreators/facebook-marketplace-search) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| query |  | — | Search keyword. Required unless category_id is provided. |
| cursor |  | — | Opaque pagination cursor returned from the previous response. Pass it back as-is. |
| sort_by | suggested, distance_ascend, creation_time_descend, price_ascend, 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. |
| condition | new, used_like_new, used_good, used_fair | — | Condition filter |
| max_price |  | — | Maximum listing price |
| min_price |  | — | Minimum listing price |

## 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.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## Facebook Marketplace listing search in other agents

- [Amp](https://spiral.ai/integrations/amp/facebook-marketplace-listing-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/facebook-marketplace-listing-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/facebook-marketplace-listing-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/facebook-marketplace-listing-search)
- [Cline](https://spiral.ai/integrations/cline/facebook-marketplace-listing-search)
- [Codex](https://spiral.ai/integrations/codex/facebook-marketplace-listing-search)
- [Cursor](https://spiral.ai/integrations/cursor/facebook-marketplace-listing-search)
- [Devin](https://spiral.ai/integrations/devin/facebook-marketplace-listing-search)
- [dots](https://spiral.ai/integrations/dots/facebook-marketplace-listing-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/facebook-marketplace-listing-search)
- [Gemini](https://spiral.ai/integrations/gemini/facebook-marketplace-listing-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/facebook-marketplace-listing-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/facebook-marketplace-listing-search)
- [goose](https://spiral.ai/integrations/goose/facebook-marketplace-listing-search)
- [Grok](https://spiral.ai/integrations/grok/facebook-marketplace-listing-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/facebook-marketplace-listing-search)
- [Hermes](https://spiral.ai/integrations/hermes/facebook-marketplace-listing-search)
- [Instinct](https://spiral.ai/integrations/instinct/facebook-marketplace-listing-search)
- [Manus](https://spiral.ai/integrations/manus/facebook-marketplace-listing-search)
- [Muse](https://spiral.ai/integrations/muse/facebook-marketplace-listing-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/facebook-marketplace-listing-search)
- [n8n](https://spiral.ai/integrations/n8n/facebook-marketplace-listing-search)
- [Notion](https://spiral.ai/integrations/notion/facebook-marketplace-listing-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/facebook-marketplace-listing-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/facebook-marketplace-listing-search)
- [Raycast](https://spiral.ai/integrations/raycast/facebook-marketplace-listing-search)
- [VS Code](https://spiral.ai/integrations/vscode/facebook-marketplace-listing-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/facebook-marketplace-listing-search)
- [Zapier](https://spiral.ai/integrations/zapier/facebook-marketplace-listing-search)

## More opencode guides

- [Facebook Marketplace item details](https://spiral.ai/integrations/opencode/facebook-marketplace-item-details)
- [Facebook Marketplace location search](https://spiral.ai/integrations/opencode/facebook-marketplace-location-search)
- [Etsy similar listings](https://spiral.ai/integrations/opencode/etsy-similar-listings)
- [Fanatics product details](https://spiral.ai/integrations/opencode/fanatics-product-details)
- [Etsy shop sections](https://spiral.ai/integrations/opencode/etsy-shop-sections)
- [Fanatics product search](https://spiral.ai/integrations/opencode/fanatics-product-search)

## 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.

