> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

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

> Найдите возможность поиска, проверьте входные параметры и цену, затем получите одну страницу заметок. Руководство не собирает комментарии и не экспортирует все результаты.

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

## Подготовка

Подключите [BeatAPI MCP](https://beatapi.io/mcp) к ИИ-клиенту и подготовьте API-ключ BeatAPI. Вызовы Search и Inspect бесплатны; вызов Run расходует баланс.

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

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

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

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

```bash
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.

```bash
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 выглядит так:

```bash
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` может содержать меньше элементов, чем исходный ответ. Короткий просмотр — это не пагинация платформы. См. [Почему ИИ видит лишь несколько результатов?](/faq/social-data-preview).

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

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

[Контракт Capabilities](/capabilities) · [Контракт Social Data](/social-data)