reddit-readonly

Reddit Readonly

Clawdbot 用の読み取り専用 Reddit ブラウジングです。

このスキルの用途

• 1 つまたは複数のサブレディットの投稿を検索します（hot/new/top/controversial/rising）
• クエリで投稿を検索します（サブレディット内または全体）
• コメントスレッドを取得して文脈を確認します
• ユーザーが Reddit を開いて手動で返信できるよう、パーマリンクの候補リストを作成します

厳守事項

• 読み取り専用です。 このスキルは投稿、返信、投票、モデレーションを行いません。
• リクエストは控えめに行ってください。
  • まずは少ない件数（5～10件）を指定してください。
  • 必要な場合にのみ件数を増やしてください。
• 結果をユーザーに返す際は、必ずパーマリンクを含めてください。

出力形式

すべてのコマンドは JSON を標準出力に出力します。

• 成功：{ "ok": true, "data": ... }
• 失敗：{ "ok": false, "error": { "message": "...", "details": "..." } }

コマンド

1) サブレディットの投稿一覧を取得

node {baseDir}/scripts/reddit-readonly.mjs posts <subreddit> \
  --sort hot|new|top|controversial|rising \
  --time day|week|month|year|all \
  --limit 10 \
  --after <token>

2) 投稿を検索

# Search within a subreddit
node {baseDir}/scripts/reddit-readonly.mjs search <subreddit> "<query>" --limit 10

# Search all of Reddit
node {baseDir}/scripts/reddit-readonly.mjs search all "<query>" --limit 10

3) 投稿のコメントを取得

# By post id or URL
node {baseDir}/scripts/reddit-readonly.mjs comments <post_id|url> --limit 50 --depth 6

4) サブレディット全体の最近のコメント

node {baseDir}/scripts/reddit-readonly.mjs recent-comments <subreddit> --limit 25

5) スレッドのまとめ（投稿 + コメント）

node {baseDir}/scripts/reddit-readonly.mjs thread <post_id|url> --commentLimit 50 --depth 6

6) 条件に合う投稿を検索（複数サブレディット用ヘルパー）

ユーザーが次のような条件を指定した場合に使用します。 「過去 48 時間に投稿された、r/a、r/b、r/c の X に関する投稿を検索し、Y は除外してください」。

node {baseDir}/scripts/reddit-readonly.mjs find \
  --subreddits "python,learnpython" \
  --query "fastapi deployment" \
  --include "docker,uvicorn,nginx" \
  --exclude "homework,beginner" \
  --minScore 2 \
  --maxAgeHours 48 \
  --perSubredditLimit 25 \
  --maxResults 10 \
  --rank new

推奨エージェントワークフロー

1. 必要に応じて範囲を確認します：サブレディット + トピックのキーワード + 期間。
2. 少ない件数を指定して、find（または posts/search）から始めます。
3. 有望な項目を 1～3 件選び、thread で文脈を取得します。
4. ユーザーに候補リストを提示します。
   • タイトル、サブレディット、スコア、作成日時
   • パーマリンク
   • 条件に合致した簡単な理由
5. 求められた場合は、自然な文章で返信案を提案できますが、投稿は手動で行うようユーザーに伝えてください。

トラブルシューティング

• Reddit が HTML を返した場合は、コマンドを再実行してください（スクリプトがこれを検出してエラーを返します）。
• リクエストが繰り返し失敗する場合は、--limit を小さくするか、環境変数でリクエスト間隔を長くしてください。

export REDDIT_RO_MIN_DELAY_MS=800
export REDDIT_RO_MAX_DELAY_MS=1800
export REDDIT_RO_TIMEOUT_MS=25000
export REDDIT_RO_USER_AGENT='script:clawdbot-reddit-readonly:v1.0.0 (personal)'