概要
Reddit上のブランド、商品、イシューの会話は、まず検索できる投稿として現れます。タイトル、作者、リンク、公開日時です。このアプリは検索キーワード1つを、それらの公開投稿の構造化リストに変えます。調査、モニタリング、競合確認を、検索ページから手でコピーしたメモではなく、一貫した表から始められます。
このデータセットは投稿の完全アーカイブではなく、発見用インデックスです。各投稿の横に検索キーワードを残すので、書き出した後もなぜ収集したかが分かります。結果と一緒に取得した検索一覧URLも含まれます。語句ごとに何が浮かび上がるかを比べやすく、タイトルが気になったら元の投稿を開けます。
データについて
各レコードは、送信したキーワードに関連する公開Reddit投稿1件、またはその検索のデータなしフラグです。返却データセット内で投稿IDは重複排除されます。キーワード、タスク項目、ビジネスIDは収集コンテキストを保持し、同じ検索の多数の行で繰り返される場合があります。検索一覧URLは取得された検索一覧のアドレスであり、必ずしもサブレディット名ではありません。公開日時と収集日時にはタイムゾーンが示されません。結果種別はレコードに付いた検索項目の種類を示します。結果ページは行に付いた一覧ページ番号です。
コレクションに含まれるのはタイトル、作者、投稿リンク、日時、収集メタデータです。投稿本文、コメント、メディア、反応数は含まれません。非公開、削除済み、隔離、または検索できないRedditコンテンツは対象外です。
結果の例
各行は、検索キーワードに関連する一致Reddit投稿、またはデータなしフラグです。
| 投稿ID | 投稿タイトル | 作者 | 公開日時 | キーワード |
|---|---|---|---|---|
| t3_1w6sq6a | Tesla Model Y L Owners Report Rear Suspension Collapse | Dragonlance12 | 2026-09-04T03:17:46 | Tesla |
| t3_1w6snrz | Emblem on Tesla's | wanderbobphx | 2026-09-04T03:14:27 | Tesla |
投稿URL、収集日時、結果ページ、検索一覧URL、ビジネスID、結果種別、タスク項目、データなしフラグも、レコードに含まれていれば利用できます。
活用シーン
- トピック発見では、キーワードで行をまとめ、異なる投稿IDの数を数えて、各語句が何件の公開投稿を拾うかを比較します。
- モニタリングでは、収集を繰り返し、投稿IDの集合を比較し、新たに観測された投稿の提供元コンテキストとして公開日時と収集日時を使います。
- 定性確認では、投稿タイトルと作者を眺め、製品イシューやキャンペーンに触れている投稿の投稿URLを開きます。
- 出所確認では、コレクションを結合する前にキーワード、タスク項目、ビジネスIDを比べ、データなしフラグで空の検索メタデータと使える投稿を分けます。
適用範囲と境界
1タスクにつきReddit検索キーワードは1つ、期待件数は1~300件です。結果は6件単位の完全なバッチで返るため切り上げられる場合があり、取得保護容量は15ページまたは300件です。対象は公開のRedditキーワード検索一覧に限定されます。
- 適している用途
- ブランド、商品、トピック、キャンペーンについて、Redditキーワード検索で公開投稿のタイトル、作者、リンク、日時が必要なとき。
- 一致した各投稿を検索キーワードと収集メタデータと一緒に残す構造化リストが必要なとき。
- 適さない用途
- 投稿本文、コメント、メディア、反応指標が必要なとき。
- バックグラウンドのキーワード収集ではなく、すぐ返る単一レコード参照が必要なとき。
失敗時の処理
作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1一致レコードが返らない場合は、キーワードを確認するか、より短く広い検索語を試してください。
- 2部分成功後は完了済みレコードを残し、失敗または期限切れタスクの後は同じ入力で再提出してください。
- 3レート制限、一時的なサービス停止、タイムアウトの後は、時間をおいて再試行してください。
- 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| keyword | 検索キーワード | string | はい | — | — | Tesla | Redditで検索するブランド、商品、トピック、フレーズです。1タスクにつきキーワードは1つ、1~512文字です。 |
| crawl_count | 期待件数 | integer | はい | — | 1–300 | 1 | 期待する検索結果数で、範囲は1~300です。結果は6件単位の完全なバッチで返るため、実際の件数は切り上げられる場合があります。端数のバッチも6件として課金されます。 |
| order_type | 並び順 | string(enum) | いいえ | New | New / Relevance / Hot / Top | — | Reddit検索結果の並びを制御します。省略時のデフォルトはNewです。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| content_id | 投稿ID | string | t3_1w6sq6a | 一致したReddit投稿の一意な識別子です。 |
| account_name | 作者 | string | Dragonlance12 | 投稿作者として表示されるRedditユーザー名です。 |
| biz_id | ビジネスID | string | Tesla | 収集レコードと一緒に返される業務グルーピング識別子です。 |
| content_title | 投稿タイトル | string | Tesla Model Y L Owners Report Rear Suspension Collapse | 一致したReddit投稿のタイトルです。 |
| content_url | 投稿URL | string | https://www.reddit.com/r/TSLAsexy/comments/1w6sq6a/tesla_model_y_l_owners_report_rear_suspension/ | 一致したReddit投稿の公開URLです。 |
| crawl_time | 収集日時 | string | 2026-09-04T11:19:49 | レコード収集に紐づく日時です。提供元はタイムゾーンを示しません。 |
| keyword | キーワード | string | Tesla | 収集投稿に紐づく検索キーワードです。 |
| page_number | 結果ページ | integer | 1 | 収集行に付いた一覧ページ番号です。 |
| publish_time | 公開日時 | string | 2026-09-04T03:17:46 | 投稿が公開された日時です。提供元はタイムゾーンを示しません。 |
| subreddit_name | 検索一覧URL | string | https://www.reddit.com/search/?q=Tesla&sort=new&restrict_sr=&t=all | レコードと一緒に返された検索一覧アドレスです。必ずしもサブレディット名ではありません。 |
| result_type | 結果種別 | string | keyword | レコードに付いた検索項目の分類です。 |
| task_item | タスク項目 | string | Tesla | このレコードを生んだ収集に紐づくキーワード項目です。 |
| no_data | データなしフラグ | boolean | false | この検索項目が一致レコードを生まなかったかどうかを示します。 |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "投稿ID",
"description": "一致したReddit投稿の一意な識別子です。",
"prefill": "t3_1w6sq6a"
},
"account_name": {
"type": "string",
"title": "作者",
"description": "投稿作者として表示されるRedditユーザー名です。",
"prefill": "Dragonlance12"
},
"biz_id": {
"type": "string",
"title": "ビジネスID",
"description": "収集レコードと一緒に返される業務グルーピング識別子です。",
"prefill": "Tesla"
},
"content_title": {
"type": "string",
"title": "投稿タイトル",
"description": "一致したReddit投稿のタイトルです。",
"prefill": "Tesla Model Y L Owners Report Rear Suspension Collapse"
},
"content_url": {
"type": "string",
"title": "投稿URL",
"description": "一致したReddit投稿の公開URLです。",
"prefill": "https://www.reddit.com/r/TSLAsexy/comments/1w6sq6a/tesla_model_y_l_owners_report_rear_suspension/"
},
"crawl_time": {
"type": "string",
"title": "収集日時",
"description": "レコード収集に紐づく日時です。提供元はタイムゾーンを示しません。",
"prefill": "2026-09-04T11:19:49"
},
"keyword": {
"type": "string",
"title": "キーワード",
"description": "収集投稿に紐づく検索キーワードです。",
"prefill": "Tesla"
},
"page_number": {
"type": "integer",
"title": "結果ページ",
"description": "収集行に付いた一覧ページ番号です。",
"prefill": 1
},
"publish_time": {
"type": "string",
"title": "公開日時",
"description": "投稿が公開された日時です。提供元はタイムゾーンを示しません。",
"prefill": "2026-09-04T03:17:46"
},
"subreddit_name": {
"type": "string",
"title": "検索一覧URL",
"description": "レコードと一緒に返された検索一覧アドレスです。必ずしもサブレディット名ではありません。",
"prefill": "https://www.reddit.com/search/?q=Tesla&sort=new&restrict_sr=&t=all"
},
"result_type": {
"type": "string",
"title": "結果種別",
"description": "レコードに付いた検索項目の分類です。",
"prefill": "keyword"
},
"task_item": {
"type": "string",
"title": "タスク項目",
"description": "このレコードを生んだ収集に紐づくキーワード項目です。",
"prefill": "Tesla"
},
"no_data": {
"type": "boolean",
"title": "データなしフラグ",
"description": "この検索項目が一致レコードを生まなかったかどうかを示します。",
"prefill": false
}
},
"required": [],
"additionalProperties": false
}連携方法
この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。
MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。
クライアント設定
Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。
{
"mcpServers": {
"hello_moto__reddit-keyword-list": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/reddit-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 6 件を 1 つの課金単位とし、端数は 6 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。