概要
Researching how a topic appears in Xiaohongshu search often starts with finding a dependable set of matching content identifiers. This app turns one search keyword into a structured collection of matching items, keeping the keyword and collection context beside each identifier so the dataset remains understandable after it is exported or joined with other research material.
The result is useful as a discovery index: it shows which content items were associated with a brand, product, topic, or campaign at collection time. It is especially suited to building repeatable monitoring sets, comparing the content populations found for different terms, and preparing identifiers for later analysis without manually recording items from search pages.
Data notes
Each record represents one item associated with the submitted Xiaohongshu keyword. Content identifiers are de-duplicated within the returned dataset. Matched keyword, Source item, and Business ID preserve the collection context and may repeat across many records from the same search. Effective update time is returned without timezone information, so it should not be treated as an absolute cross-region timestamp without additional context. Account unique ID may be unavailable for some records.
The collection contains identifiers and collection metadata, not the full post body, title, media, engagement totals, comments, or a complete author profile. A No-data marker distinguishes task metadata that reports no matching content from ordinary matched records.
What a result looks like
Each row is one matched content item or a no-data marker associated with the search keyword.
| Content ID | Matched keyword | Effective update time | Business ID | No-data marker |
|---|---|---|---|---|
| 6a8ffa18000000000402a03c | 蓝牙耳机 | 2026-08-27T16:56:13 | 蓝牙耳机 | No |
| 6a8ff9c900000000260068c2 | 蓝牙耳机 | 2026-08-27T16:56:13 | 蓝牙耳机 | No |
Account unique ID and Source item are also available when supplied with the record.
Use cases
- For topic discovery, group rows by Matched keyword and count distinct Content ID values to compare the searchable content population associated with each term.
- For monitoring, repeat a keyword collection and compare Content ID sets while using Effective update time as source-provided context for newly observed items.
- For provenance checks, compare Matched keyword, Source item, and Business ID to confirm which search context produced each content item before combining datasets.
- For data-quality review, filter on No-data marker and missing Account unique ID values to separate empty-search metadata from usable matched records.
適用範囲と境界
One keyword per task with an expected result count from 1 to 200; results are returned in complete batches of 20 and may be rounded up; coverage is limited to records available through Xiaohongshu keyword search.
- 適している用途
- When you need content identifiers returned by a Xiaohongshu keyword search for a brand, product, topic, or campaign.
- When you need a structured list that connects each matched content item with its search keyword and collection metadata.
- 適さない用途
- When you need full post text, media, engagement metrics, comments, or complete author profiles.
- When you need an immediate single-record lookup rather than a background keyword collection task.
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1If no matching records are returned, verify the keyword or try a shorter and broader search phrase.
- 2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
- 3Retry later after rate limiting, temporary service unavailability, or a timeout.
- 4If authentication fails, verify the API Key configured for the execution environment.
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- Search keyword
keyword必須stringA brand, product, topic, or phrase to search on Xiaohongshu. Each task accepts one keyword from 1 to 512 characters.例蓝牙耳机 - Expected result count
crawl_count必須integerExpected number of search results, from 1 to 200. Results are returned in complete batches of 20, so the actual count may be rounded up.範囲1–200例20
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- Content ID
content_idstringUnique identifier of the matched Xiaohongshu content item.例6a8ffa18000000000402a03c - Matched keyword
keywordstringSearch keyword associated with the collected content item.例蓝牙耳机 - Effective update time
effective_update_timestringTimestamp associated with the collected record; the source does not specify a timezone.例2026-08-27T16:56:13 - Account unique ID
account_unique_idstringUnique account identifier when available; this value may be missing.例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 を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。