Reddit スキル
概要
このスキルを使用すると、OAuth認証を利用したPRAWを通じて、1つのサブレディットまたはr/allから再現可能なReddit研究データを収集できます。まず生のアーティファクトを取得し、その後分析を行うことで、後日Redditに再アクセスすることなく、同じ実行結果を再ランキング、要約、インポート、翻訳などに使用できます。
言語ポリシー
人間向けの出力ではユーザーの言語を反映します。ユーザーが中国語で記述している場合、またはプロジェクトのコンテキストが中国語である場合、生成されるレポート、メモ、Markdownインデックス、レビューキュー、サマリー、推奨事項は中国語で作成します。
生データのスキーマは安定した状態を保ちます。JSONキー、CSVヘッダー、Redditのタイトル、投稿本文、コメント、URL、APIフィールド名は元の言語のままにすることができます。バンドルスクリプトを中国語コンテキストで実行する場合は、--language zhを渡すとindex.mdとCLIメッセージが中国語ラベルを使用します。
必要なセットアップ
不足している場合、Python依存関係をインストールします:
python3 -m pip install praw
初回使用時は、収集の前に認証情報の設定を次のステップとします。最も簡単なフローは以下の通りです:
python3 scripts/setup_reddit_env.py
これにより、ユーザーに次の情報を求めます:
REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret
これらの情報は~/.config/reddit-skill/.envに書き込まれ、scripts/reddit_mine_posts.pyが自動的に読み取ります。コレクターはプロジェクトローカルの.envファイルやプロセス環境変数も読み取ります。
ユーザーがすでにReddit OAuthアプリを持っている場合は、既存のアプリIDをREDDIT_CLIENT_ID、アプリのsecretをREDDIT_CLIENT_SECRETとして再利用するよう伝えてください。
ユーザーがまだ認証情報を持っていない場合は、https://www.reddit.com/prefs/appsがレガシーOAuthアプリページであり、ログイン後も動作する可能性があるが、現在の唯一のオンボーディングパスではないことを説明します。動作する場合、scriptアプリを作成し、任意のアプリ名を設定し、リダイレクトURIをhttp://localhost:8080に設定してから、アプリIDをREDDIT_CLIENT_ID、secretをREDDIT_CLIENT_SECRETとしてコピーします。レガシーページでアプリ作成ができない場合は、ユーザーをRedditの公式ヘルプ開発者ページにある現在のData APIサインアップ/リクエストフローに誘導します。
Redditの認証情報をスキルリポジトリ内に保存しないでください。環境変数、プロジェクトの.env、または~/.config/reddit-skill/.envに保存してください。
収集ワークフロー
- ターゲットのサブレディットとランキングの種類を明確にします。よく使われる選択肢:
--listing top --time-filter all:全期間のトップ投稿。--listing top --time-filter month:最近の実績あるヒット。--listing hot:現在動いているもの。--listing newまたは--listing rising:早期発見用。--listing search --query "キーワード" --search-sort comments --time-filter year:トピックマイニング用。
- 現在のプロジェクトの研究エリア下に明示的な
--out-dirを指定してscripts/reddit_mine_posts.pyを実行します。 - 生成された生ファイルを保存します:
posts.jsonl:各行に正規化された投稿が1つ。comments.jsonl:コメントがリクエストされた場合、各行に正規化されたコメントが1つ。posts.csv:スプレッドシート対応の投稿テーブル。index.md:人間が読めるトップ投稿インデックス。summary.json:実行のメタデータとカウント。
- 生成されたアーティファクトから分析を行います。ユーザーがより新しいデータを要求しない限り、JSONL/CSVの再読み取りをRedditへの再クエリよりも優先します。
クイックコマンド
このSKILL.mdが置かれているディレクトリから実行するか、scripts/reddit_mine_posts.pyをインストール済みスキルのスクリプトへの絶対パスに置き換えて実行します。
1つのサブレディットで全期間のトップ投稿を収集:
python3 scripts/reddit_mine_posts.py \
--subreddit LocalLLaMA \
--listing top \
--time-filter all \
--language zh \
--limit 100 \
--include-comments \
--max-comments 8 \
--out-dir research/reddit/localllama-top-all
r/allの最もホットな投稿をマイニング:
python3 scripts/reddit_mine_posts.py \
--subreddit all \
--listing hot \
--language zh \
--limit 100 \
--out-dir research/reddit/all-hot
サブレディットをトピックで検索し、コメント数でランク付け:
python3 scripts/reddit_mine_posts.py \
--subreddit SaaS \
--listing search \
--query "voice agent" \
--search-sort comments \
--time-filter year \
--language zh \
--limit 75 \
--include-comments \
--out-dir research/reddit/saas-voice-agent-comments
分析のガイダンス
- 投稿を
scoreとnum_commentsの両方でランク付けします。コメント数が多いと、スコアが高いよりもペインポイントのマイニングに役立つことがあります。 - コンテンツ戦略の場合は、まずタイトルのパターンを調べ、次にコメントのパターンを調べます。
- ユーザーが明示的に別の指示をしない限り、Redditへの投稿や返信は人間によるレビューキューとして扱います。
- 公開匿名の
.jsonエンドポイントは、403や疎なデータを返す場合に信頼できないものとして扱います。OAuth認証情報を使用したPRAWを優先します。 - DevRelやプロダクトリードの発掘では、タイトル、自己テキスト、トップコメントから総合的に意図をスコアリングします。
リソース
scripts/setup_reddit_env.py:REDDIT_CLIENT_IDとREDDIT_CLIENT_SECRETのための対話型セットアップヘルパー。scripts/reddit_mine_posts.py:サブレディットリスト、検索、コメント、研究アーティファクトのためのPRAWコレクター。references/reddit-research-patterns.md:フィールドの意味、出力規約、フォローアップ分析パターン。
ユーザーがスコアリング、研究の統合、再利用可能なワークスペースレイアウト、または単純な収集を超えたアーティファクトの解釈を求めた場合は、リファレンスファイルを参照してください。