AI で小紅書のノートを検索する
BeatAPI で小紅書のノートを検索するには、無料の Search 呼び出しで検索機能を探し、無料の Inspect 呼び出しで data:xiaohongshu.app_v2.search_notes の入力と料金を確認してから、有料の Run 呼び出しでノートを 1 ページ取得します。このガイドは 1 回の検索だけを扱います。コメントの収集と全件のエクスポートは別のタスクです。
準備
AI クライアントに BeatAPI MCP を接続し、BeatAPI API キーを用意してください。Search と Inspect の呼び出しは無料です。Run の呼び出しは残高を消費します。
AI に渡すタスク
小紅書でキャンプ用コーヒーに関するノートを検索してください。最初に機能を探し、必須入力、実行可能な状態、料金を確認して、実行前に料金を教えてください。私の承認後に 1 ページだけ取得し、少量のプレビューと、あれば出典リンクを表示してください。コメント取得、次ページ取得、有料実行の再試行は確認なしで行わないでください。
機能を探す
HTTP クライアントでは、無料の Search リクエストから始めます。
Search のレスポンスにある reference の値をそのまま Inspect リクエストに渡します。以下の Inspect リクエストは data:xiaohongshu.app_v2.search_notes を使います。Search が別の reference を返した場合は、返された reference を使ってください。
課金前の確認
Inspect のレスポンスは、入力スキーマ、料金、準備状態、次の呼び出しを返します。準備状態が ready または runnable の場合のみ続行します。listed の機能は実行できません。next の呼び出しにあるすべてのプレースホルダーを自分の入力に置き換えます。
1 ページ取得する
Inspect が示した料金を承認したら、API キーを付けて、Inspect のレスポンスにある Run 呼び出しを送信します。data:xiaohongshu.app_v2.search_notes の場合、Run リクエストは次のとおりです。
上の Run リクエストは例であり、実測レスポンスではありません。実際のレスポンスのフィールドを確認してください。runnable の機能でも、固定の出力構造は保証されません。
結果を読む
preview ビューの件数は元のレスポンスより少ない場合があります。プレビューの件数が少ないことは、プラットフォームのページングとは別です。AI に数件しか表示されないのはなぜですか? を参照してください。
料金と範囲
このガイドでは Run で有料検索を 1 回開始します。Search と Inspect は無料です。現在の料金は Inspect のレスポンスで確認し、このガイドには固定金額を記載しません。1 ページの検索結果に一致するノートがすべて含まれるとは限らず、検索順位も固定されません。

