Сценарий использования

Отслеживайте список бестселлеров Amazon в категории во времени

Читайте Best Sellers, New Releases или Most Wished For категории Amazon в JSON с позицией, названием, ценой, рейтингом и ASIN и смотрите, кто растёт.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Amazonlovelyjsonitems[0]"rank": 3"title": "Cordless handheld vac…"price": "59.99""rating": 4.5"asin": "B0EXAMPLE12"

Если вы продаёте в категории Amazon, список Best Sellers — это табло: кто сегодня в топ-50, сколько они берут и как высоко их оценивают. Один взгляд на него мало что даёт; полезно то, что изменилось с прошлой недели. Lovely Router читает список за вас. Отправьте ссылки на категории, получите по одному JSON-объекту на товар и платите за каждый товар с предоплаченного баланса. Вызывайте его из скрипта, еженедельного отчёта или ИИ-агента с одним API-ключом.

Передайте это своему ИИ-агенту

Скопируйте этот промпт в 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>
01

Как это работает

010203
  1. Откройте страницу Best Sellers, New Releases или Most Wished For для категории, в которой вы продаёте, и скопируйте ссылку.

  2. Запустите инструмент с лимитом

    Отправьте ссылки в POST /v1/tools/amazon-bestsellers/run вместе с max_results. Запуск резервирует максимальную стоимость на вашем балансе и возвращает ранжированные товары в JSON.

  3. Сохраняйте и сравнивайте

    Сохраняйте каждый запуск с датой. Сравнивайте с предыдущим, чтобы находить новичков, резкие подъёмы в рейтинге и изменения цен.

02

Ранжированный список одним запросом

Бестселлеры Amazon принимает ссылки на категории в urls. Один запуск возвращает до 50 товаров:

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
  }'

Подходят ссылки на Best Sellers, New Releases и Most Wished For, так что одну категорию можно прочитать в трёх разрезах. Запуск, который идёт дольше 60 секунд, возвращает 202; как опрашивать результат, описано в разделе Запуск инструмента.

03

Что содержит каждый товар

Группа полейЧто вы получаете
ПозицияМесто в списке
ИдентификацияНазвание и ASIN
ЦенаУказанная цена
КачествоРейтинг

Сохраняйте ASIN: по нему можно отслеживать один и тот же товар между запусками, даже если название меняется.

04

Рецепты

Еженедельный снимок позиций

Запускайте свою категорию каждый понедельник, сохраняйте позицию по ASIN и стройте график того, кто поднимается.

Ловите запуски на ранней стадии

Читайте страницу New Releases своей категории и выводите ASIN, которых не было в запуске прошлой недели.

Найдите свою ценовую позицию

Сравните цены топ-20 со своей и посмотрите, где вы находитесь.

Заметьте пробел

Сравните Best Sellers с Most Wished For: товары, которые хотят, но которые ещё не в топе, могут говорить о спросе, который предложение пока не закрыло.

Конкурентов — на детальный разбор

Возьмите ASIN из топа и передайте их в Карточку товара Amazon, чтобы получить характеристики, изображения и продавца.

Удобнее простыми словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Прочитай страницу Amazon Best Sellers для Pet Supplies, сравни с запуском, сохранённым в last_week.json, и выведи ASIN, которые появились впервые или поднялись на 10 и более позиций. Установи max_results равным 50».

05

Дополните карточками товаров и отзывами

Список показывает, кто побеждает. Эти инструменты показывают почему:

  • amazon-product читает полную карточку товара по ASIN: характеристики, изображения, продавца и позицию.
  • amazon-reviews читает, что покупатели говорят о товаре из топа.
  • google-trends показывает, растёт ли поисковый интерес к категории.

Несколько маркетплейсов в одной задаче — в разделе аналитика электронной коммерции.

06

Сколько это стоит

Вы платите за каждый товар: при старте запуск резервирует свою максимальную стоимость — плату за вызов плюс цену товара, умноженную на max_results, — и списывает оплату за то, что вернул. Остаток резерва возвращается на баланс. Запуск, который завершился ошибкой или по тайм-ауту, оплачивает только полученные товары, а запуск, отклонённый на старте, ничего не стоит.

Чтение 50 товаров в день тарифицируется как 50 товаров в день. Нет ни подписки, ни ежемесячного минимума: пополняйте баланс от $5, и один баланс оплачивает инструменты и модели. Актуальная цена — на карточке выше; на странице цен перечислены все инструменты.

07

Частые вопросы

?
Хранит ли инструмент историю позиций за меня?+

Нет. Он возвращает список таким, какой он есть в момент запуска. Сохраняйте каждый запуск с датой, чтобы собрать собственную историю.

Можно ли читать New Releases или Most Wished For?+

Да. Передайте в urls ссылку на категорию любого из этих списков.

Сколько товаров возвращается?+

До 50 за запуск.

С какими сайтами Amazon он работает?+

В примере используется amazon.com. Передайте ссылку на категорию с того сайта, который хотите прочитать.

Как узнать объём продаж товара?+

Результат даёт позицию, а не число проданных единиц. Позиция — это сигнал, который стоит сравнивать между запусками.

Нужна ли подписка?+

Нет. Вы пополняете предоплаченный баланс, и каждый запуск списывает с него средства. Неудачные запуски оплачивают только доставленные результаты, и ничего не продлевается автоматически.

Один предоплаченный ключ для моделей, данных и агентов

Без подписки. Пополняйте баланс, используйте сколько нужно и смотрите каждое списание в логах.