Перейти к навигации

Поиск заметок Xiaohongshu с помощью ИИ

Чтобы искать заметки Xiaohongshu через BeatAPI, найдите возможность поиска бесплатным вызовом Search, проверьте входные параметры и цену data:xiaohongshu.app_v2.search_notes бесплатным вызовом Inspect, затем получите одну страницу заметок платным вызовом Run. Руководство охватывает только один поиск; сбор комментариев и экспорт всех результатов — отдельные задачи.

Подготовка

Подключите BeatAPI MCP к ИИ-клиенту и подготовьте API-ключ BeatAPI. Вызовы Search и Inspect бесплатны; вызов Run расходует баланс.

Задание для ИИ

Найди заметки Xiaohongshu о кофе в походе. Сначала найди возможность и проверь обязательные параметры, готовность и цену. Сообщи цену до запуска. После моего согласия получи только одну страницу, покажи краткий просмотр и ссылки на источники, если они есть. Не собирай комментарии, не переходи на следующую страницу и не повторяй платный запуск без разрешения.

Найдите возможность

В HTTP-клиенте начните с бесплатного запроса Search:

curl -sS https://api.beatapi.io/v1/capabilities/search \
-H "Content-Type: application/json" \
-d '{"query":"小红书 搜索笔记"}'

Скопируйте значение reference из ответа Search в запрос Inspect. Запрос Inspect ниже использует data:xiaohongshu.app_v2.search_notes; если Search вернул другой reference, используйте возвращённый reference.

curl -sS https://api.beatapi.io/v1/capabilities/inspect \
-H "Content-Type: application/json" \
-d '{"reference":"data:xiaohongshu.app_v2.search_notes"}'

Проверка до оплаты

Ответ Inspect содержит схему входа, цену, состояние готовности и следующий вызов. Продолжайте только при состоянии ready или runnable; возможность в состоянии listed исполнить нельзя. В вызове next замените каждый заполнитель своими данными.

Получите одну страницу

После согласования цены из Inspect отправьте вызов Run из ответа Inspect со своим API-ключом. Для data:xiaohongshu.app_v2.search_notes запрос Run выглядит так:

curl -sS https://api.beatapi.io/v1/capabilities/run \
-H "Authorization: Bearer $BEATAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"reference":"data:xiaohongshu.app_v2.search_notes","input":{"keyword":"露营咖啡"},"view":"preview","max_items":5}'

Запрос Run выше — пример, а не записанный результат. Читайте поля фактического ответа: возможность в состоянии runnable не гарантирует фиксированную структуру вывода.

Прочитайте результат

Представление preview может содержать меньше элементов, чем исходный ответ. Короткий просмотр — это не пагинация платформы. См. Почему ИИ видит лишь несколько результатов?.

Стоимость и ограничения

Руководство запускает один платный поиск через Run; Search и Inspect бесплатны. Текущая цена берётся из ответа Inspect, а не из фиксированной суммы в руководстве. Одна страница поиска не гарантирует все подходящие заметки, а порядок результатов поиска не гарантированно стабилен.

Контракт Capabilities · Контракт Social Data