ユースケース

eBay の販売済み事例で中古品を査定し、再販価格を決める

Q: 販売済み出品はどれくらい前までさかのぼれますか？

daysToScrape で指定します。既定は 30 日です。

Q: どの eBay サイトを使えますか？

ebaySite には ebay.com、ebay.co.uk、ebay.de、ebay.fr、ebay.it、ebay.es、ebay.ca、ebay.com.au を指定できます。

Q: 状態や価格で絞り込めますか？

はい。itemCondition には any、new、used を指定でき、minPrice と maxPrice は販売価格で絞り込みます。sortOrder は結果ページの順序を変えます。

Q: 販売済み出品は何件まで取得できますか？

1 回の実行の件数は count で指定し、実行の上限 max_results は最大 500 件です。

eBay で実際に売れた価格を、販売価格・送料・状態・終了日付きの JSON で取得し、在庫の評価や再販価格の設定に活用できます。

API キーを取得ドキュメントを読む

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

希望価格は願望にすぎません。電子機器を転売している、遺品整理の掘り出し物を売っている、コレクションに保険をかけている。そんなときに必要なのは、ここ数週間に買い手が実際に支払った金額です。eBay はそれを販売済みの出品として保持していますが、検索は 1 回ずつです。Lovely Router が代わりに読み取ります。キーワードを送ると販売済みの出品 1 件につき 1 つの JSON オブジェクトが返り、プリペイド残高から出品 1 件ごとに課金されます。スクリプト、スプレッドシートのジョブ、AI エージェントのどこからでも、1 つの API キーで実行できます。

AI エージェントに任せる

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

eBay の販売済み事例で中古品を査定し、再販価格を決める. 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>

仕組み

査定したいものをリストにする
品目ごとに 1 つのキーワードを用意します。型番がいちばん確実です。在庫に合わせて itemCondition を加え、検索結果にノイズが多い場合は価格帯も指定します。
上限を付けてツールを実行する
POST /v1/tools/ebay-sold/run に送ります。count に販売済み出品の件数を、daysToScrape にさかのぼる日数を、max_results に実行の上限を指定します。実行は最大費用を残高から仮押さえし、販売結果を JSON で返します。
中央値を取る
部品取りだけの取引などの外れ値を除いてから、販売価格の中央値（発送する場合は送料を加えたもの）を比較対象にします。日付付きで保存します。

1 回のリクエストで販売済みの価格を取得する

eBay の販売済み出品は、keywords に検索語を受け取り、各項目が同じフィルターで別々の検索になります。ebaySite で国別のサイトを選び、daysToScrape でさかのぼる期間（既定は 30）を、itemCondition で any、new、used を、count で出品の件数を指定します。

Shell

curl https://lovelyrouter.com/v1/tools/ebay-sold/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "keywords": ["rtx 4080"],
      "count": 3
    },
    "max_results": 3
  }'

60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。1 回の実行で最大 500 件の販売済み出品を取得できます。

販売済み出品ごとの内容

項目グループ	取得できる内容
価格	売れた価格
送料	送料
状態	新品、中古、または出品時の表記
時期	販売の終了日

レシピ

在庫を評価する。

在庫にあるすべての型番を itemCondition を used にして実行し、30 日間の販売価格の中央値を取って、自社の販売価格の横に書き込みます。

何を買うかを決める。

まとめ買いの前に、ロットの希望価格と、その中の各品目の販売価格の中央値を比べます。

価格の推移を追う。

同じキーワードを毎週 daysToScrape を 30 にして実行し、中央値を保存して、商品の再販価格が下がっているかどうかを確認します。

保険や鑑定に使う。

コレクションについて、比較可能な取引の日付付きテーブルを作り、評価額の根拠資料にします。

国どうしを比べる。

同じキーワードを ebay.co.uk と ebay.com で実行し、在庫を海外に送る前に中央値を比べます。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「gpus.txt にある型番ごとに、eBay の中古の販売済み出品を 30 件ずつ取得し、それぞれの販売価格の中央値と販売件数を教えてください。max_results は合計件数に設定してください。」