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

Исследуйте потребительские тренды Китая по заметкам Xiaohongshu

Ищите заметки Xiaohongshu (RED) по ключевому слову в JSON, чтобы понять, что советуют и о чём спрашивают китайские покупатели, до запуска или выхода на рынок.

Предоплата, без подпискиREST или MCPОдин ключ для моделей, данных и агентов
XiaohongshuRedNotelovelyjsonitems[0]"operation": "search_notes""keyword": "露营""sort_type": "like_count_descending""note_id": "64f0a1b2c3d4e5f607182…"user_id": "5f1c2a9e0000000001001…

Прежде чем запускать продукт в Китае или писать тексты для китайских покупателей, стоит узнать, что они уже советуют друг другу, а на Xiaohongshu это происходит в заметках: подборках, обзорах и инструкциях на китайском, которые ранжирует приложение, недоступное для поиска из скрипта. Lovely Router выполняет поиск за вас. Отправьте ключевое слово, получите по одному JSON-объекту на элемент и платите за каждый элемент с предоплаченного баланса. Вызывайте его из скрипта, исследовательского блокнота или ИИ-агента с одним API-ключом.

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

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

Исследуйте потребительские тренды Китая по заметкам Xiaohongshu. 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. Подберите ключевые слова на китайском

    Используйте слова, которыми пользуются покупатели: тип товара, занятие, проблему. Начните широко, например с хобби, затем сужайте.

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

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

  3. Ищите закономерности

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

02

Поиск заметок одним запросом

Поиск заметок Xiaohongshu принимает operation, здесь search_notes, а также keyword и sort_type: general, time_descending, like_count_descending, comment_count_descending или collect_count_descending. Поля лимита в input у этого инструмента нет; лимит задаётся через max_results в запросе:

curl https://lovelyrouter.com/v1/tools/xiaohongshu-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "operation": "search_notes",
      "keyword": "露营",
      "sort_type": "like_count_descending"
    },
    "max_results": 30
  }'

Запуск, который идёт дольше 60 секунд, возвращает 202; как опрашивать результат, описано в разделе Запуск инструмента.

03

Что содержит каждый элемент

Группа полейЧто вы получаете
ЗаметкиЗаметки Xiaohongshu (RED), соответствующие ключевому слову
Другие операцииТот же инструмент принимает также search_products, get_note_detail, get_note_comments, list_user_notes, get_user_info, list_topic_notes, search_hot_list и другие, у каждой свои поля

Результат инструмента описан как заметки по ключевому слову, поэтому проверьте структуру на небольшом запуске, прежде чем строить конвейер на конкретных полях. Текст приходит на китайском.

04

Рецепты

Оцените категорию до запуска

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

Соберите слова, которыми говорят клиенты

Соберите 100 заметок о проблеме, например о сухой коже или хранении в маленьком пространстве, и попросите модель выделить фразы, которые повторяют покупатели. Используйте их в карточках товаров и рекламе.

Следите за сезоном

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

Копните глубже в хит

Возьмите id успешной заметки и запустите get_note_comments, чтобы прочитать, о чём под ней спрашивают.

Проверьте, что в тренде сейчас

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

Удобнее простыми словами? Подключите MCP-сервер и скажите Claude Code или Cursor: «Найди на Xiaohongshu 露营 с сортировкой по лайкам, переведи заголовки на английский и сгруппируй заметки в пять тем. Установи max_results равным 50».

05

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

Заметки показывают, что люди говорят. Маркетплейсы показывают, что они покупают:

  • douyin-search охватывает короткие видео на ту же тему.
  • weibo-search показывает публичные обсуждения в Weibo.
  • taobao-product даёт цены и продажи товаров, которые советуют в заметках.
  • xianyu-listings показывает цены перепродажи тех же товаров.

Более широкая настройка описана в разделе данные китайских соцсетей.

Заметки и комментарии оставляют реальные пользователи. Если вы храните эти данные или связываетесь с людьми, вы отвечаете за законное использование данных, включая правила о персональных данных и борьбе со спамом.

06

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

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

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

07

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

?
Нужно ли искать на китайском?+

Китайские ключевые слова соответствуют тому, как пишут пользователи. В примере используется 露营 (кемпинг).

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

До 100, по умолчанию 10. Задайте в max_results нужное число.

Можно ли читать комментарии или заметки автора?+

Да, изменив operation: например, get_note_comments, list_user_notes или get_user_info с соответствующим note_id или user_id.

Какие поля содержит заметка?+

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

Нужен ли аккаунт на Xiaohongshu?+

Нет. Вы отправляете ключевое слово и API-ключ.

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

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

Работаете с несколькими китайскими платформами? Смотрите данные китайских соцсетей, поиск инфлюенсеров и остальной каталог инструментов.

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

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