ユースケース

Facebook Marketplace で中古品・リセールの価格を調べる

Q: 特定の都市を検索できますか？

はい。都市は Marketplace のリンクの一部で、例では nyc の部分です。コピーしたリンクを urls に渡します。

Q: 1 回の実行で何件の出品を読み取れますか？

最大 200 件です。max_results に希望の件数を設定します。

Facebook Marketplace の検索を、タイトル・価格・所在地・写真つきの JSON に変換。中古品の値付け、お買い得品の発見、地域のリセール市場の規模把握に使えます。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで

中古品を転売している、下取り価格を決めたい、あるいは自分の街で中古品がいくらで売れるのかを知りたい。そんなとき、Facebook Marketplace の希望価格こそが相場です。ところが、それは手作業でしか見られないフィードの中にあります。Lovely Router がそのフィードを代わりに読み取ります。Marketplace の検索またはカテゴリのリンクを送れば、出品 1 件につき 1 つの JSON オブジェクトが返り、プリペイド残高から出品 1 件ごとに課金されます。スクリプト、スプレッドシート用ジョブ、AI エージェントのどこからでも、1 つの API キーで呼び出せます。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

Facebook Marketplace で中古品・リセールの価格を調べる. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>

仕組み

検索リンクを作る
自分の街で商品を Marketplace 検索するか、カテゴリを開いて、アドレスをコピーします。
上限を付けてツールを実行する
リンクを urls に入れ、max_results（実行が読み取る出品数）を添えて POST /v1/tools/facebook-marketplace/run に送ります。実行は最大費用を残高から仮押さえします。
価格帯を計算する
出品全体の中央値とばらつきを求めます。毎週再実行すれば、価格が動いているかどうかがわかります。

1 回のリクエストで Marketplace の出品を取得する

Facebook Marketplace を検索するツールは、Marketplace の検索またはカテゴリのリンクを urls に受け取ります。上限はリクエストの max_results です。

Shell

curl https://lovelyrouter.com/v1/tools/facebook-marketplace/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "urls": [
        "https://www.facebook.com/marketplace/nyc/search?query=bike"
      ]
    },
    "max_results": 20
  }'

所在地はリンクの一部なので、別の市場の価格を調べるには、アドレスの都市の部分を変更します。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

出品ごとの内容

フィールド群	取得できる内容
商品	出品のタイトル
価格	希望価格
所在地	商品が出品されている場所
写真	出品の写真

希望価格は成約価格ではありません。1 件ではなく多数の出品の中央値を使い、割高な出品や売れ残っている出品があることを前提にしてください。

レシピ

下取り価格を決める。

これから買い取るモデルを検索して 100 件の出品を読み、希望価格の下位四分位から金額を提示します。

相場より安い品を見つける。

各出品の価格を同じ検索の中央値と比べ、大きく下回るものをフラグ付けします。

都市を比較する。

アドレスの都市の部分を変えて同じクエリを実行し、どこで最も高く売れるかを確認します。

転売用の在庫を仕入れる。

転売しているモデルを毎日検索して出品を保存し、新しいものだけを確認します。

カテゴリの規模を測る。

検索が返す出品数と価格のばらつきを数えて、参入する価値があるかを判断します。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「Facebook Marketplace でシカゴの中古ロードバイクを検索して 100 件の出品を読み、希望価格の中央値と最も安い 5 件を教えてください。max_results は 100 に設定してください。」