ナビゲーションにスキップ

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 リクエストから始めます。

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 を使ってください。

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 リクエストは次のとおりです。

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 に数件しか表示されないのはなぜですか? を参照してください。

料金と範囲

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

Capabilities の仕様 · Social Data の仕様