reddit-search について
reddit-search は、公開 Reddit を対象とする範囲付きの調査スキルです。投稿、コメント、コミュニティ、指定された公開プロフィールを調べる用途に対応し、目的に応じたルートを選びます。
主な機能
- 01キーワードと公開検索 URL の探索
- 02投稿コメントの調査
- 03サブレディットの投稿とメタデータ収集
- 04公開プロフィールの活動確認
- 05生データとソースリンクの保持
活用シーン
- 01トピックに関する Reddit 投稿の発見
- 02選択したスレッドのコメント分析
- 03公開サブレディットやプロフィール活動の調査
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ postplusai/ postplus-skills --skill reddit-searchインストール後、Claude Code で/reddit-searchを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/community.mdpost-comments.mdprofile.mdresult-shapes.mdsearch.mdshared-contract.md詳細
Reddit 検索
このスキルは、範囲を限定した公開 Reddit リサーチに使用します。
体験ルール
- 収集用語ではなく、ユーザーのビジネス言語で話してください。
- 質問は最大 1 つまでとし、ルートまたはクレジット上限が変わる場合にのみ行ってください。
- 最小限の有用なサンプルから始め、レビュー後にのみ拡張してください。
- 実装、配信、ネットワーク制御の話は会話に出さないでください。
- コマンド、契約、認証、プライベートサーフェスの致命的な失敗は、早期に失敗させてください。サポート対象の実行が、空、疎、ノイズ過多、または的外れな証拠で完了した場合は、証拠が枯渇したと結論づける前に、以下の品質ルールを適用してください。
ルート索引
実行前に、一致するルート参照のみを読んでください。結果形状の詳細は、完了したレコードを変換するときにのみ読んでください。事前チェックではありません。
| ユーザーの要望 | ルート参照 | デフォルトの初回パス |
|---|---|---|
| キーワード投稿、コミュニティ、または Reddit 検索 URL | references/search.md | 投稿 20 件またはコミュニティ 10 件 |
| キーワードコメントの証拠 | references/search.md、スレッド選択後のみ references/post-comments.md を読む | 発見用投稿 20 件、その後関連スレッド最大 3 件 |
| 提供された 1 件の投稿 URL のコメント | references/post-comments.md | 投稿 1 件とコメント最大 50 件 |
| ガイド付きのペインポイントまたは製品意見の深掘り | references/search.md、スレッド選択後のみ references/post-comments.md を読む | 発見用投稿 20 件、その後提案スレッド 3 件 |
| サブレディットの検索、フィード、メタデータ、または深い収集 | references/community.md | フィード投稿 20 件、深い範囲は別途上限を設定 |
| 明示的に指定された公開 Reddit プロフィールとそのアクティビティ | references/profile.md | 投稿 20 件とコメント 20 件 |
| 結果変換に以下の要約を超えるフィールドが必要 | references/result-shapes.md | 生の結果ファイルを保持 |
最初の質問
ユーザーがキーワード、URL、サブレディット、またはプロフィールを指定し、安全なデフォルトが適用できる場合は質問しないでください。それ以外の場合は、最も情報量の多い質問のみを行ってください。
| 欠けている判断 | 質問 |
|---|---|
| リサーチ対象がない | What Reddit topic, URL, subreddit, or public profile should I research? |
| 深いサブレディット要求に上限がない | What date range or maximum post count should bound the deep collection? |
| 複数の高コストな方向性が競合している | Which one should I run first: discovery, a thread deep-dive, a subreddit, or a public profile? |
認証情報、スキーマフィールド、実装の選択、配信設定、リトライ戦略を決して尋ねないでください。
実行プロトコル
- 1 つのルートを選択し、その参照を適用します。
- 初回パスに応答する最も狭いセマンティックルートを実行します。
- JSON 結果を
.postplus/配下に永続的な証拠として保持します。 - レコードタイプと関連性を確認します。証拠が有用でない場合は、同一のリクエストを繰り返したり、承認された PostPlus クレジット上限を超えたりすることなく、以下の品質ルールを適用してください。
- 完全な生レコードを結果ファイルに保持し、ユーザー向けの証拠のみを正規化します。さらにフィールドの解釈が必要な場合にのみ
references/result-shapes.mdを読んでください。 - 範囲、結果タイプ別の件数、代表的な証拠、制限、および 1 つの有用な次のアクションを報告します。範囲を限定したパスが網羅的であると示唆しないでください。
複数のキーワードは、個別で帰属可能なリクエストです。並列で実行してもかまいませんが、結果セットは提示まで個別のままにしておきます。
公開コマンドの境界
- 準備状況:
postplus doctor --skill reddit-search。 - 必要な場合に限り、
postplus research run <route> --helpでルートのフラグを確認します。 - ルートを選択します。
reddit-search:キーワードの検索、公開検索 URL、コミュニティ検索、 および一般的なサブレディットのフィードに使用します。reddit-post-comments:選択した1つ以上の投稿スレッドに使用します。reddit-subreddit-posts:範囲を限定したサブレディットの詳細収集に使用します。reddit-user-activity:明示的に指定された公開プロフィールに使用します。
postplus research run <route> --<query/url/subreddit/handle flags> --limit <n> --wait --output <result.json>を実行します。- 選択したルートに示されているセマンティックフラグのみを使用します。
- 実行結果として保存済みの非同期チェックポイントが返された場合は、重複実行を開始せず、
postplus research run --resume-from <result.json>で再開します。 - 依頼されたタスクでは、現在の価格と残高を確認したうえで、既存のPostPlusクレジットを使用します。 見積もりのみの依頼では実行しません。クレジットが不足している場合は停止し、チャージ、 サブスクリプションの購入、不確かな有料操作の再実行は行いません。
対象範囲の境界
対応範囲:公開キーワード検索、公開検索 URL、公開投稿スレッド、 公開サブレディットのコンテンツとメタデータ、および明示的に依頼された公開プロフィールのアクティビティ。
対象外:ログインまたはアカウントへのアクセス、投稿またはメッセージの送信、非公開・削除済み コンテンツの復元、実在の人物の推定、個人データの補完、自動感情分析、メディアのダウンロード、外部への送信、ネットワークの調整。
コマンドの選択
| 必要な内容 | ルート | フラグ |
|---|---|---|
| キーワード/検索 URL/フィードの検索 | reddit-search | --queryまたは--urlを繰り返し指定し、sort/time-range/limitを追加 |
| 選択したスレッドのコメント | reddit-post-comments | --urlを繰り返し指定し、limitを追加 |
| サブレディットの詳細調査 | reddit-subreddit-posts | --subredditを繰り返し指定し、必要に応じて--posted-afterを追加し、limitを指定 |
| 指定した公開プロフィール | reddit-user-activity | --handleを繰り返し指定し、post-limit、comment-limitを指定 |
プラットフォームの対象範囲または証拠の解釈が不明な場合に限り、 プラットフォームの契約を参照します。これは事前確認ではありません。
証拠の品質
- 結論を導く前にレコードを分類します。検索結果の投稿はスレッドを特定するためのものであり、コメントに関する主張には実際のコメントが必要です。
- キーワードを使ったコメント調査では、まず投稿を検索し、その後、関連性の高いスレッドを最大3件調べます。検索結果が不適切な場合は、範囲を広げる前に検索クエリを変更します。
- 成功したものの結果が不十分な場合、承認済みの範囲と予算内で、変更を加えた追加調査は最大2回までとします。同一の依頼を繰り返したり、失敗または保留中の操作を隠したりしません。
- 十分な情報が得られた場合、上限に達した場合、または追加調査で改善が見込めない場合は停止します。有用な証拠と不確実性を報告し、生データとソースリンクを保持します。
重複排除にはdataType + idを使用し、コメントの親IDと階層の深さを保持します。値の欠落は不明を意味し、ゼロではありません。
機械処理用のすべてのフィールドはpostplus research schema --route <route> --jsonで確認できます。
処理に必要な場合に限り参照し、依頼のたびに事前確認する必要はありません。
postplus research run reddit-search \
--query "example topic" \
--wait \
--output ./result.json
CLIの構造化された結果と報告された次のアクションに従い、自由記述のメッセージから復旧方法を推測しないでください。 依頼された範囲と最大費用をすでにカバーするユーザーの明示的な承認があれば、それを再利用します。それ以外の場合は、見積もりを確定する前に承認を得てください。タスクの依頼だけから支出の承認を推測してはいけません。 返されたチェックポイントまたはアクションを使って同じ操作を再開します。不確かな作業を再送信したり、復旧を繰り返して上限を超えたり、失敗を回避するためにプロバイダーを切り替えたりしてはいけません。