概要
小紅書検索でトピックを調べるには、一致するコンテンツIDを信頼できる形で集める必要があります。このアプリは1つの検索キーワードから一致項目を構造化して収集し、各IDにキーワードと収集コンテキストを添えます。
データについて
各レコードは指定したキーワードに関連する1件です。コンテンツIDで重複を除きます。更新日時にはタイムゾーンがなく、アカウント固有IDは欠落する場合があります。投稿本文、メディア、コメント、完全な作者プロフィールは含まれません。
結果の例
| コンテンツID | 一致キーワード | 有効更新日時 | ビジネスID | データなしフラグ |
|---|---|---|---|---|
| 6a8ffa18000000000402a03c | 蓝牙耳机 | 2026-08-27T16:56:13 | 蓝牙耳机 | いいえ |
| 6a8ff9c900000000260068c2 | 蓝牙耳机 | 2026-08-27T16:56:13 | 蓝牙耳机 | いいえ |
活用例
- 一致キーワードごとにコンテンツIDを数えて検索可能な範囲を比較します。
- コンテンツIDと有効更新日時を繰り返し比較して変化を追跡します。
- 一致キーワード、元の検索項目、ビジネスIDで出所を確認します。
適用範囲と境界
1タスクにつき1キーワード、期待件数は1～200件です。結果は20件単位の完全なバッチで返るため切り上げられる場合があり、小紅書キーワード検索で取得可能なレコードに限定されます。
- 適している用途
- ブランド、商品、トピック、キャンペーンに関する小紅書キーワード検索のコンテンツIDが必要な場合。
- 一致した各コンテンツと検索キーワード、収集メタデータを結び付けた構造化リストが必要な場合。
- 適さない用途
- 投稿本文、メディア、反応数、コメント、完全な作者プロフィールが必要な場合。
- バックグラウンド収集ではなく、1件を即時に照会したい場合。
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1一致レコードがない場合はキーワードを確認するか、より短く広い検索語句を試してください。
- 2一部成功では完了済みレコードを保持し、失敗または期限切れでは同じ入力で再実行してください。
- 3レート制限、一時的なサービス停止、タイムアウト後は時間を置いて再試行してください。
- 4認証に失敗した場合は、実行環境に設定されたAPIキーを確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- 検索キーワード
keyword必須string小紅書で検索するブランド、商品、トピック、または語句です。1タスクにつき1～512文字のキーワードを1つ指定します。例蓝牙耳机 - 期待結果件数
crawl_count必須integer期待する検索結果件数を1～200で指定します。結果は20件単位の完全なバッチで返るため、実際の件数が切り上げられる場合があります。範囲1–200例20
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- コンテンツID
content_idstring一致した小紅書コンテンツの一意識別子です。例6a8ffa18000000000402a03c - 一致キーワード
keywordstring収集されたコンテンツに関連付けられた検索キーワードです。例蓝牙耳机 - 有効更新日時
effective_update_timestring収集レコードに関連付けられた日時です。提供元ではタイムゾーンが明示されていません。例2026-08-27T16:56:13 - アカウント固有ID
account_unique_idstring取得できる場合に返されるアカウントの一意識別子です。欠落する場合があります。例account_example_001
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"content_id": "6a8ffa18000000000402a03c",
"keyword": "蓝牙耳机",
"effective_update_time": "2026-08-27T16:56:13",
"account_unique_id": "account_example_001",
"biz_id": "蓝牙耳机",
"source_item": "蓝牙耳机",
"no_data": false
}連携方法
この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key（長期有効。Data Hub コンソールで作成）を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます：キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。
MCP（Model Context Protocol）を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。
クライアント設定
Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=meme_today/xiaohongshu-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。