reddit-research

Reddit の調査

Crawlora API の正規化された JSON を使って、サブレディットの投稿やコメント、1 件の投稿のコメントスレッド全体、キーワード検索結果、公開ユーザーの投稿・コメント履歴、ホット／新着／急上昇／トップのトレンドを取得できます。Reddit のスクレイピングや非公式クライアントライブラリは使用しません。

ツールの範囲とデータフロー

任意で使用できるシェルヘルパーは、このスキルが実行を求める唯一のコマンドです。ドキュメントに記載された許可リスト登録済みの Crawlora のルートにのみ GET リクエストを送信します。実行時には CRAWLORA_API_KEY を読み込み、HTTPS 経由で api.crawlora.net に x-api-key ヘッダーとして送信します。キーを Reddit に送信することはありません。一時的に TMPDIR の下にモード 600 の curl 設定ファイルを書き込み、コマンドの終了時に削除します。他の環境変数を調べたり、ファイルを列挙したり、ソフトウェアをインストールしたり、昇格した権限で実行したりすることはありません。クエリ、サブレディット／ユーザーの識別子、指定された投稿の対象は Crawlora API に送信されるため、機密またはセンシティブな調査用語は使用しないでください。

/reddit/leads ルートは、ユーザーが明示的に依頼した場合に使う、独立したワークフローです。商品／サービスの購入意向に基づいて公開投稿を順位付けします。リードの発見をユーザーが依頼した場合にのみ使用し、出力では投稿単位のスコアリングであることを説明してください。また、センシティブな特性を推測したり、重大な影響を及ぼす意思決定のために個人を順位付けしたりしないでください。

このスキルを使う場面

• 「 では今、どんな話題が出ていますか？」
• 「この Reddit の投稿／スレッドのコメントを取得してください。」
• 「<topic/product/brand> に関する Reddit の投稿を検索してください。」
• 「 は最近、何を投稿したりコメントしたりしましたか？」
• 「今日の Reddit のトレンドは何ですか？」または「r/ のセンチメントはどうですか？」
• Reddit でのブランド言及のモニタリング、コミュニティ調査、競合他社のセンチメント追跡。
• 一致した市場期間に関連する、特定銘柄についての Reddit 上の議論を調べる場合は、インストール済みの reddit-stock-sentiment-research を使用してください。

セットアップ（初回のみ）

• https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
• ヘルパーを実行する前に、環境に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境から CRAWLORA_API_KEY を読み込み、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

仕組み

1. 検索 — キーワードに一致する投稿を /reddit/search で検索します。必要に応じて subreddit で対象を絞り込めます。
2. 1 件の投稿とそのスレッド — 投稿自体には /reddit/post/{id}、公開コメントには /reddit/comments/{id} を使います。どちらかに include_metrics=true を追加すると、3 クレジットでネットスコア／アップボート比率／アワードのデータを取得できます（通常は 1 クレジットです）。
3. サブレディットを閲覧 — /reddit/subreddit/{subreddit}/posts（hot/new/top/rising）、/reddit/subreddit/{subreddit}/comments（最新コメントのフラットフィード）、/reddit/subreddit/{subreddit}/about（メタデータとサンプル投稿）を使います。
4. 複数サブレディットのフィード — /reddit/subreddits/posts にカンマ区切りの subreddits リスト（最大 10 件）を指定して、統合されたホット／新着／トップフィードを取得します。
5. ユーザー履歴 — /reddit/user/{username}/posts と /reddit/user/{username}/comments で、公開ユーザーの投稿フィード／コメントフィードを取得します。
6. ドメインへの言及 — /reddit/domain/{domain}/posts で、指定したホスト名にリンクする公開投稿を取得します。
7. トレンド — 全般的なホット／新着／急上昇／トップフィードには /reddit/trends を使います。特定のサブレディットのトレンドを調べるには、代わりに /reddit/subreddit/{subreddit}/posts で sort=hot|new|rising|top を指定します。

エンドポイント、メソッド、パラメーターの一覧は、reference/endpoints.md を参照してください。

API の呼び出し

# Search + subreddit browse:
scripts/crawlora.sh /reddit/search q="web scraping" | jq '.'
scripts/crawlora.sh /reddit/subreddit/programming/posts sort=top time=week | jq '.'

# Post + comment thread:
scripts/crawlora.sh /reddit/post/1abcxyz include_metrics=true | jq '.'
scripts/crawlora.sh /reddit/comments/1abcxyz sort=top limit=50 | jq '.'

# User history + trends:
scripts/crawlora.sh /reddit/user/spez/posts | jq '.'
scripts/crawlora.sh /reddit/trends sort=rising | jq '.'

# Explicit buying-intent lead discovery from public posts:
scripts/crawlora.sh /reddit/leads q="looking for a project management tool" | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーがコマンドライン引数に含まれないようにします。

エンドポイントのリファレンス

このスキルで使用するすべての Reddit エンドポイントについては、reference/endpoints.md を参照してください。

例

• コミュニティのセンチメント調査： 話題に関連するサブレディットで、/reddit/subreddit/{subreddit}/posts と /reddit/subreddit/{subreddit}/comments を使用し、投稿タイトルとコメント本文を調べて、繰り返し現れるセンチメントや問題点を見つけます。
• スレッドの詳細調査： 元の投稿には/reddit/post/{id}を、ネットスコアとアワード数を含む議論全体には /reddit/comments/{id}?include_metrics=trueを使用して、話題になったスレッドを要約します。
• ブランド言及の一括調査： Reddit 全体を対象に/reddit/search q="<brand>"を使用するか、subreddit=で範囲を指定します。 返されたafterトークンを使ってページネーションし、公開されている言及をすべて数えて読み取ります。

注意事項と制限

• クレジット／成功時のみ課金： 2xxの場合のみ課金されます。無料プランは月2,000クレジットです。 キーはhttps://crawlora.netで取得できます。
• 公開データのみ — 公開投稿、コメント、サブレディットが対象です。ログインや非公開コンテンツには対応していません。 Reddit の利用規約を遵守してください。
• セキュリティ： キーはCRAWLORA_API_KEYのみに保存してください。ハードコード、クエリパラメーターへの設定、コミットは絶対に行わないでください。
• 匿名ページの制限： Reddit の匿名ページでは利用できないため、/reddit/subreddit/{subreddit}/aboutから購読者数、アイコン、バナーは取得されません。 include_metrics=trueを指定しない場合、正確な賛成票／反対票の合計数、賛成票の割合、シェア／再投稿／閲覧数は推定値になるか、利用できません。 指定した場合でも、Reddit が投票データを曖昧化するため、数値は概算です。
• メトリクスは追加料金がかかります： /reddit/post/{id}または/reddit/comments/{id}でinclude_metrics=trueを指定すると、匿名 HTML ページに切り替わり、1クレジットではなく3クレジットかかります。 コメント数の多いスレッドでは、このモードで最初の一部しか取得できない場合があります。
• リクエスト制限： Reddit が一時的にリクエストを制限している場合、ほとんどのリストエンドポイントはRetry-Afterヘッダーとともに503を返します。 ハードエラーとして扱うのではなく、指定された秒数待ってから再試行してください。
• リストエンドポイントはafterを使ったカーソルページネーションに対応しています。返されたカーソルをたどって1ページ目以降も取得してください（デフォルトは25件、上限は100件です）。