オンラインで販売している、価格改定や仕入れのツールを作っている、あるいはカテゴリを調査している。そんなときに必要なのは、必要なときにいつでも更新できる商品データです。今日の価格、販売者、売れ筋ランキング、そして同じ商品が先月いくらで売れたか。Lovely Router はこれらを Amazon、eBay、AliExpress、Shopee、TikTok Shop、Facebook Marketplace から JSON で返し、プリペイド残高から商品または出品 1 件ごとに課金します。cron ジョブ、バックエンド、AI エージェントのどこからでも、Amazon のスクレイピングを自前で組むことなく、1 つの API キーで呼び出せます。
AI エージェントに任せる
このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。
Pull product, price, review and best-seller data from Amazon, eBay (including sold prices), AliExpress, Shopee, TikTok Shop and 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 products, keywords or ASINs, the marketplaces and countries, and what to track>仕組み
追跡する対象をリストにする
ASIN や Amazon の商品 URL、ベストセラーのカテゴリ URL、eBay のキーワード、Shopee や TikTok Shop の商品リンク、Marketplace の検索 URL などです。
上限を付けてツールを実行する
入力を
max_resultsと一緒にPOST /v1/tools/{id}/runに送ります。実行は最大費用を残高から仮押さえし、商品を JSON で返します。保存して比較する
各実行の価格をタイムスタンプ付きで保存します。前回の実行と比べれば、価格の変化、新しい販売者、ランキングの変動を捉えられます。
1 回のリクエストで Amazon の商品データを取得する
Amazon の商品詳細は、Params に ASIN または商品 URL を受け取ります。ASIN だけを渡すと website に指定した Amazon サイトから読み取り、完全な URL を渡すと常にその URL のドメインが使われるため、1 回の実行で複数のマーケットプレイスをカバーできます。
curl https://lovelyrouter.com/v1/tools/amazon-product/run \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{
"input": {
"Params": ["B00091S3K4", "https://www.amazon.de/dp/B00091S3K4"],
"website": "amazon.com",
"zipCode": "10010"
},
"max_results": 2
}'items の各商品には、価格、評価、特徴、画像、販売者、ランキングが含まれます。amazon.com では、deliverTo と zipCode で配送先を指定でき、Amazon が表示する商品、価格、在庫状況が変わります。currency を指定すると、Amazon が対応している場合に価格の通貨換算を依頼できます。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。
Tip
同じ ASIN でも、Amazon の国別サイトが違えば別の商品の場合があります。ASIN を取得したサイトを website に指定するか、完全な商品 URL を渡してください。
ツール
ASIN で Amazon の商品ページ全体を取得：価格、評価、特徴、画像、出品者、ランキング。
Amazon の ASIN に対するカスタマーレビュー：星評価、タイトル、本文、日付、認証購入。レビューは 1 ページ 10 件単位（入力の maxPages）。
カテゴリ別の Amazon 売れ筋ランキング：順位、タイトル、価格、評価、ASIN。
キーワードで eBay の出品を取得：価格、状態、出品者、送料。
eBay で実際に売れた価格：販売価格、送料、状態、終了日。価格調査や査定向け。
AliExpress 検索の商品：価格、注文数、評価、ストア。
国を指定してキーワードで Shopee の商品を取得。
URL で TikTok Shop の商品ページを取得：価格、販売数、評価、ショップ、バリエーション。
Facebook マーケットプレイスの検索・カテゴリ URL の出品：タイトル、価格、場所、写真。
| ツール | 送るもの | 各結果の内容 |
|---|---|---|
amazon-product | Params（ASIN または URL）、website、deliverTo、zipCode、currency | 価格、評価、特徴、画像、販売者、ランキング |
amazon-reviews | input：商品ごとに {asin, domainCode, sortBy, maxPages} を 1 つ | 星の数、タイトル、本文、日付、認証済み購入かどうか |
amazon-bestsellers | ベストセラー、新着ランキング、ほしい物ランキングのカテゴリの urls | 順位、タイトル、価格、評価、ASIN |
ebay-listings | keywords、ebaySite、minPrice、maxPrice、condition | 価格、状態、販売者、送料（検索結果の 1 ページ目） |
ebay-sold | keywords、ebaySite、daysToScrape（最大 90）、itemCondition | 販売価格、送料、状態、終了日 |
aliexpress-products | searchQueries または productUrls、sortBy | 価格、注文数、評価、ストア |
shopee-products | searchTerms または startUrls、country、sortBy | タイトル、価格、割引、評価、所在地、ショップ |
tiktok-shop-product | productUrls、region | 価格、販売数、評価、ショップ、バリエーション |
facebook-marketplace | Marketplace の検索またはカテゴリの urls | タイトル、価格、所在地、写真 |
レシピ
毎朝、自前のスケジューラーから ASIN リストに対して amazon-product を実行します。1 回の実行はツールの実行ごとの上限以下のバッチに分けます。ASIN ごとに価格、販売者、ランキングを保存し、価格が下限を割り込んだときや新しい販売者が現れたときにアラートを出します。
"keywords": ["rtx 4080"]、"daysToScrape": 30、"itemCondition": "used" を指定して ebay-sold を実行し、その商品が実際にいくらで売れたかを確認してから、ebay-listings で得た今日の出品価格と比べます。
カテゴリ URL で amazon-bestsellers を取得し、上位の ASIN ごとに {"asin": "…", "domainCode": "com", "sortBy": "recent", "maxPages": 1} のエントリを 1 つずつ指定して amazon-reviews を実行し、購入者が何に不満を持っているかをモデルに尋ねます。その不満が、そのまま製品企画のヒントになります。
同じ商品を "sortBy": "orders" で aliexpress-products で検索し、その価格を Amazon や eBay での販売価格と比べます。
shopee-products は、インドネシア、シンガポール、マレーシア、フィリピン、タイ、ベトナム、台湾、ブラジル、メキシコ、コロンビア、チリの Shopee を検索します。sales で並べ替えれば売れ筋がわかります。tiktok-shop-product は、10 か国のストアの TikTok Shop 商品ページを読み取ります。
https://www.facebook.com/marketplace/nyc/search?query=bike のような都市単位の検索 URL を facebook-marketplace に渡します。
普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「asins.txt にある 30 個の ASIN について、amazon.com での現在の価格、販売者、ランキングを取得し、prices.csv にある昨日の価格と比べて、変わったものを一覧にしてください。すべての実行に max_results を設定してください。」
料金
料金は結果単位で、商品、レビュー、出品 1 件ごとにかかり、呼び出し料金があるツールではそれも加わります。実行を開始すると最大費用（呼び出し料金 + 結果単価 × max_results）が仮押さえされ、実際に返った分で精算されて、仮押さえの残りは残高に戻ります。失敗またはタイムアウトした実行は返した結果の分だけを支払い、開始時に拒否された実行は無料です。
200 個の ASIN を毎日確認すると、1 日あたり商品 200 件分の結果として課金されます。サブスクリプションや月額の最低利用料はなく、$5 からチャージでき、1 つの残高でツールとモデルの両方を支払えます。現在の価格は上のカードに表示されており、料金ではすべてのツールを一覧できます。
よくある質問
米国以外の Amazon の価格もモニタリングできますか？+
はい。amazon-product ツールは、amazon.de、amazon.co.uk、amazon.co.jp、amazon.com.br を含む 20 の Amazon 国別サイトを読み取れます。ASIN だけを渡す場合は website でサイトを 1 つ選び、完全な商品 URL を渡す場合は常にその URL のドメインが使われます。
価格はどれくらいの頻度で確認できますか？+
実行を開始するたびに確認できます。確認 1 回が 1 回の実行で、商品単位で課金されるため、自前の cron ジョブやワーカーからスケジュールしてください。アカウントで同時に進行できる実行は最大 10 件です。
商品が実際にいくらで売れたかを確認できますか？+
はい、eBay で落札価格を確認できます。ebay-sold ツールは最大 90 日前までの販売済みの出品を、販売価格、送料、状態、終了日とともに返します。査定や再販価格の設定に必要な情報です。
TikTok Shop の価格は 1 つの通貨に換算されますか？+
いいえ。TikTok Shop の価格は換算されないため、各ストアの価格はそのストアの通貨で返ります。英国のストアは価格の数字を隠しており、該当する行には priceStatus=masked_by_storefront と記載されます。
商品詳細だけでなく Amazon のレビューも取得できますか？+
はい。amazon-reviews ツールは、星の数、タイトル、本文、日付、認証済みの購入かどうかを返します。レビューは 10 件ずつのページで返り、ASIN ごとに maxPages でページ数を指定します。
サブスクリプションは必要ですか？+
いいえ。プリペイド残高にクレジットを追加し、実行ごとに残高から差し引かれます。失敗した実行は返した結果の分だけを支払い、自動で更新されるものは何もありません。
購入後に購入者が何を語っているかを追うならレビューモニタリングを、TikTok や Instagram で商品を販売するクリエイターについてはインフルエンサーリサーチを、すべてのプラットフォームについてはツールカタログをご覧ください。