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

Сравнение цен Shopee по странам для продавцов и закупок

Ищите товары на любой из 11 страновых площадок Shopee и получайте JSON с ценой, скидкой, рейтингом, местоположением и магазином для анализа конкурентов.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
Shopeelovelyjsonitems[0]"title": "Clear phone case for …"price": "4.90""discount": "35%""rating": 4.8"location": "Singapore""shop": "CaseHub SG"

Товар, который продаётся по одной цене в Сингапуре, в Индонезии может стоить намного дешевле, и продавцам, выходящим на новую страну Shopee, нужно знать это до того, как назначать цену. Проверять каждую площадку вручную долго, а страницы в разных странах отличаются. Lovely Router выполняет один и тот же поиск на выбранной вами площадке. Отправьте ключевые слова или ссылки, получите по одному JSON-объекту на товар и платите за каждый товар с предоплаченного баланса.

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

Скопируйте этот промпт в Claude Code, Cursor, Codex или любой кодинг-агент. Он подскажет агенту, где документация и как использовать ваш API-ключ.

Сравнение цен Shopee по странам для продавцов и закупок. 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. Составьте список товаров и стран

    Выберите ключевые слова для того, что вы продаёте, и коды нужных стран, например SG, ID или TH.

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

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

  3. Сравните по рынкам

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

02

Цены Shopee в стране одним запросом

Поиск товаров Shopee принимает ключевые слова в searchTerms, площадку в country и лимит на ключевое слово в maxItems:

curl https://lovelyrouter.com/v1/tools/shopee-products/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
        "searchTerms": [
          "phone case"
        ],
        "country": "SG",
        "maxItems": 30,
        "sortBy": "price_asc"
      },
    "max_results": 30
  }'

country принимает ID, SG, MY, PH, TH, VN, BR, TW, MX, CO и CL. sortBy принимает relevancy, sales, latest, price_asc или price_desc. В startUrls можно также передать ссылки Shopee на товар, поиск, категорию или магазин — у них сохраняется своя страна. Запуск, который всё ещё идёт через 60 секунд, возвращает 202; как опрашивать его, показано в разделе «Запустить инструмент».

03

Что есть у каждого товара

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

Цены возвращаются в валюте площадки. Прежде чем сравнивать страны, пересчитайте их в своём коде или с помощью модели.

04

Рецепты

Цена для новой страны

Запустите одно и то же ключевое слово в SG, MY и ID, пересчитайте в одну валюту и посмотрите, где ваша цена находится в каждой стране.

Лидеры продаж

Задайте sortBy равным sales, возьмите первые 30 и запишите их цену, скидку и магазин. Это предложения, с которыми вы конкурируете.

Отслеживание магазина конкурента

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

Кто на самом деле дешевле всех

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

Закупка там, где товар

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

Удобнее обычными словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди на Shopee „phone case“ в SG, MY и ID, по 20 товаров, отсортированных по продажам, и дай мне таблицу с медианной ценой и скидкой по каждой стране. Задай max_results равным 60.»

05

Сочетайте с другими маркетплейсами

Shopee показывает цены внутри одной площадки. Эти инструменты показывают те же товары с других сторон:

  • aliexpress-products показывает экспортную цену похожих товаров.
  • tiktok-shop-product читает страницы товаров из TikTok Shop.
  • naver-shopping охватывает крупнейший торговый поиск Кореи.

Как работать с несколькими маркетплейсами в одной задаче, описано в сценарии «Аналитика электронной коммерции».

06

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

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

Проверка 100 товаров в день оплачивается как 100 товаров в день. Нет ни подписки, ни ежемесячного минимума: пополняйте баланс от $5, и один баланс оплачивает и инструменты, и модели. На карточке выше указана текущая цена; на странице «Цены» перечислены все инструменты.

07

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

?
В каких странах можно искать?+

ID, SG, MY, PH, TH, VN, BR, TW, MX, CO и CL. По умолчанию — ID.

Можно ли искать в нескольких странах за один запуск?+

country применяется к поиску по ключевым словам в этом запуске. Ссылки сохраняют свою страну, поэтому для ключевых слов делайте по одному запуску на страну.

Сколько товаров может вернуть один запуск?+

До 100 товаров, задаётся через max_results.

Пересчитываются ли цены в доллары?+

Нет. Они возвращаются так, как их показывает площадка. Пересчитывайте в своём коде.

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

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

Продаёте на нескольких маркетплейсах? Смотрите аналитику электронной коммерции, данные о товарах Taobao и каталог инструментов.

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

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