ユースケース

キーワードで eBay の競合価格と販売者のオファーをモニタリングする

eBay をキーワード検索し、現在の出品を価格・状態・販売者・送料付きの JSON で取得。競合の動きを把握し、自分の商品の価格設定に役立てられます。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで
eBaylovelyjsonitems[0]"title": "Keychron K8 mechanica…"price": "74.99""condition": "Pre-owned""seller": "keyboard_depot""shipping": "Free shipping"

eBay で販売している、あるいは eBay から仕入れているなら、つける価格は今出品されているものに左右されます。競合の販売者が何人いるか、最安値がどこまで下がっているか、送料無料かどうか。商品ごとに手作業で確認するのは遅く、夕方には古くなっています。Lovely Router が eBay の検索を代わりに実行します。キーワードを送ると出品 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>
01

仕組み

010203
  1. 検索語をリストにする

    販売または仕入れの商品ごとに 1 つのキーワードを用意します。型番、商品名、商品番号、引用符で囲んだ「完全一致のフレーズ」などです。

  2. 上限を付けてツールを実行する

    POST /v1/tools/ebay-listings/run に、eBay のサイト、任意の価格や状態のフィルター、実行の上限である max_results を付けて送ります。実行は最大費用を残高から仮押さえし、出品を JSON で返します。

  3. 自分の価格と比べる

    キーワードごとに、最安値、価格の中央値、送料無料で出している販売者の数を求めます。市場が動いたら、価格を改定するかアラートを出します。

02

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

eBay の出品を検索は、keywords に検索語を受け取り(各項目が別々の検索になります)、ebaySite に国別のサイトを受け取ります。minPrice、maxPrice(サイトの通貨で指定)、condition で絞り込めます。このツールは、各検索の結果の 1 ページ目を読み取ります。

curl https://lovelyrouter.com/v1/tools/ebay-listings/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "keywords": ["mechanical keyboard"],
      "ebaySite": "www.ebay.com"
    },
    "max_results": 20
  }'

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

03

出品ごとの内容

項目グループ取得できる内容
価格出品価格(サイトの通貨)
状態新品、中古など、eBay が表示するその他の状態
販売者販売している人
送料送料または条件
04

レシピ

毎日の価格ウォッチ。

毎朝、主要な 30 個のキーワードを実行し、キーワードごとの最安値と中央値を保存して、設定した割合以上に下がったらアラートを出します。

送料無料の項目を確認する。

キーワードごとに送料無料の出品の割合を数え、送料を自社価格に含めるかどうかを判断します。

新品と中古を比べる。

同じキーワードを condition フィルターの新品と中古で実行して差を確認し、再生品の在庫の価格を決めます。

別の国を見る。

ebaySite を www.ebay.co.uk や www.ebay.de に切り替え、国をまたいで発送する前に、それぞれの通貨で価格を比べます。

市場より安く仕入れる。

maxPrice を設定し、同じキーワードの中央値を大きく下回る出品を探します。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「products.txt にある 15 個のキーワードで eBay を検索し、それぞれの最安値、価格の中央値、販売者の数を表にしてください。max_results は 60 に設定してください。」

05

他のデータと組み合わせる

現在の出品は、売り手の希望価格です。残りは次のツールで補えます。

  • ebay-sold は、商品が実際にいくらで売れたかを示します。買い手が受け入れた価格です。

複数のマーケットプレイスを 1 つのジョブで扱う場合は、EC インテリジェンスをご覧ください。

06

料金

料金は出品 1 件ごとにかかります。実行を開始すると最大費用(呼び出し料金 + 出品単価 × max_results)が仮押さえされ、実際に返った分で精算されて、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返した出品の分だけを支払い、開始時に拒否された実行は無料です。

30 個のキーワードを 20 件ずつ監視すると、出品 600 件分として課金されます。サブスクリプションや月額の最低利用料はなく、$5 からチャージでき、1 つの残高でツールとモデルの両方を支払えます。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。

07

よくある質問

?
どの eBay サイトに対応していますか?+

ebaySite には www.ebay.com、www.ebay.co.uk、www.ebay.de、www.ebay.fr、www.ebay.it、www.ebay.es、www.ebay.ca、www.ebay.com.au を指定できます。価格はサイトの通貨で返ります。

キーワードごとに何件の出品を取得できますか?+

このツールは各検索の結果の 1 ページ目を読み取り、1 回の実行で合計最大 60 件の出品を返します。

商品番号や完全一致のフレーズで検索できますか?+

はい。keywords には、検索語、商品番号、引用符で囲んだ「完全一致のフレーズ」といった eBay の構文を指定できます。

商品が実際にいくらで売れたかはわかりますか?+

いいえ、現在の出品を返します。販売済みの取引には eBay の販売済み出品を使ってください。

状態で絞り込めますか?+

はい、condition フィールドで絞り込めます。新品と中古は、すべてのカテゴリで使えます。

サブスクリプションは必要ですか?+

いいえ。プリペイド残高にクレジットを追加し、実行ごとに残高から差し引かれます。失敗した実行は返した結果の分だけを支払い、自動で更新されるものは何もありません。

チャネルをまたいで価格を設定するなら、EC インテリジェンス、レビューモニタリング、そしてツールカタログもご覧ください。

モデル・データ・エージェントを 1 つのプリペイドキーで

サブスクリプションなし。チャージして必要な分だけ使い、すべての請求をログで確認できます。