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

# AI で小紅書のノートを検索する

> 検索機能を探し、入力と料金を確認してから、ノートを 1 ページ取得します。コメントの収集や全件のエクスポートは行いません。

BeatAPI で小紅書のノートを検索するには、無料の Search 呼び出しで検索機能を探し、無料の Inspect 呼び出しで `data:xiaohongshu.app_v2.search_notes` の入力と料金を確認してから、有料の Run 呼び出しでノートを 1 ページ取得します。このガイドは 1 回の検索だけを扱います。コメントの収集と全件のエクスポートは別のタスクです。

## 準備

AI クライアントに [BeatAPI MCP](https://beatapi.io/mcp) を接続し、BeatAPI API キーを用意してください。Search と Inspect の呼び出しは無料です。Run の呼び出しは残高を消費します。

## AI に渡すタスク

> 小紅書でキャンプ用コーヒーに関するノートを検索してください。最初に機能を探し、必須入力、実行可能な状態、料金を確認して、実行前に料金を教えてください。私の承認後に 1 ページだけ取得し、少量のプレビューと、あれば出典リンクを表示してください。コメント取得、次ページ取得、有料実行の再試行は確認なしで行わないでください。

## 機能を探す

HTTP クライアントでは、無料の Search リクエストから始めます。

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

Search のレスポンスにある `reference` の値をそのまま 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` の呼び出しにあるすべてのプレースホルダーを自分の入力に置き換えます。

## 1 ページ取得する

Inspect が示した料金を承認したら、API キーを付けて、Inspect のレスポンスにある Run 呼び出しを送信します。`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` ビューの件数は元のレスポンスより少ない場合があります。プレビューの件数が少ないことは、プラットフォームのページングとは別です。[AI に数件しか表示されないのはなぜですか？](/faq/social-data-preview) を参照してください。

## 料金と範囲

このガイドでは Run で有料検索を 1 回開始します。Search と Inspect は無料です。現在の料金は Inspect のレスポンスで確認し、このガイドには固定金額を記載しません。1 ページの検索結果に一致するノートがすべて含まれるとは限らず、検索順位も固定されません。

[Capabilities の仕様](/capabilities) · [Social Data の仕様](/social-data)