ユースケース

Amazon ベストセラーのカテゴリ別ランキングを継続的に追跡する

Q: 新着やほしい物ランキングも読み取れますか？

はい。どちらのリストでも、そのカテゴリのリンクを urls に渡してください。

Q: 何件の商品が返りますか？

1 回の実行で最大 50 件です。

Amazon のベストセラー、新着、ほしい物ランキングをカテゴリ単位で JSON 取得。順位、タイトル、価格、評価、ASIN から、動きのある商品がわかります。

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

Amazon のカテゴリで販売しているなら、ベストセラーのランキングは成績表です。今日の上位 50 に誰がいて、いくらで売られ、どれくらい評価されているか。1 回見ただけではわかることは多くありません。役に立つのは、先週から何が変わったかです。Lovely Router が代わりにランキングを読み取ります。カテゴリのリンクを送ると商品ごとに 1 つの JSON オブジェクトが返り、プリペイド残高から商品 1 件ごとに課金されます。スクリプト、週次レポート、AI エージェントのどこからでも、1 つの API キーで呼び出せます。

AI エージェントに任せる

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

Amazon ベストセラーのカテゴリ別ランキングを継続的に追跡する. 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>

仕組み

カテゴリのリンクをコピーする
販売しているカテゴリのベストセラー、新着、ほしい物ランキングのページを開き、そのリンクをコピーします。
上限を付けてツールを実行する
リンクを max_results と一緒に POST /v1/tools/amazon-bestsellers/run に送ります。実行は最大費用を残高から仮押さえし、順位付きの商品を JSON で返します。
保存して比較する
各実行を日付付きで保存します。前回の実行と比べれば、新規のランクイン、大きな順位の上昇、価格の変化を見つけられます。

1 回のリクエストで順位付きのリストを取得する

Amazon ベストセラーは、urls にカテゴリのリンクを受け取ります。1 回の実行で最大 50 件の商品を返します。

Shell

curl https://lovelyrouter.com/v1/tools/amazon-bestsellers/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
        "urls": [
          "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/"
        ]
      },
    "max_results": 50
  }'

ベストセラー、新着、ほしい物ランキングのリンクはどれも使えるので、同じカテゴリを 3 つの切り口で読み取れます。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

商品ごとの内容

項目グループ	取得できる内容
順位	リスト内の位置
識別情報	タイトルと ASIN
価格	表示価格
品質	評価

ASIN は必ず保存してください。タイトルが変わっても、実行をまたいで同じ商品を追跡できます。

レシピ

週次の順位スナップショット。

毎週月曜にカテゴリを実行し、ASIN ごとに順位を保存して、上昇している商品をグラフにします。

新商品の登場を早く捉える。

カテゴリの新着ページを読み取り、先週の実行にはなかった ASIN を一覧にします。

自社の価格の位置を知る。

上位 20 件の価格を自社の価格と比べ、自分がどこにいるかを確認します。

空白を見つける。

ベストセラーとほしい物ランキングを比べます。ほしい物に入っているのにまだ上位に入っていない商品は、供給が追いついていない需要のサインかもしれません。

競合を詳しく調べる。

上位の ASIN を Amazon の商品詳細に渡して、特徴、画像、販売者を取得します。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「Amazon のペット用品のベストセラーページを読み取り、last_week.json に保存した実行と比べて、新しい ASIN と、順位が 10 以上上がった ASIN を一覧にしてください。max_results は 50 に設定してください。」