Back to Details

reddit-readonly

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Reddit Readonly

Reddit 只读浏览

Read-only Reddit browsing for Clawdbot.
为Clawdbot打造的Reddit只读浏览工具。

What this skill is for

本工具的用途

  • Finding posts in one or more subreddits (hot/new/top/controversial/rising)
  • Searching for posts by query (within a subreddit or across all)
  • Pulling a comment thread for context
  • Producing a shortlist of permalinks so the user can open Reddit and reply manually
  • 在一个或多个subreddit中查找帖子（热门/最新/置顶/争议/上升）
  • 按关键词搜索帖子（在单个subreddit内或全Reddit范围）
  • 获取评论线程以了解上下文
  • 生成固定链接（permalinks）清单，方便用户打开Reddit手动回复

Hard rules

硬性规则

  • Read-only only. This skill never posts, replies, votes, or moderates.
  • Be polite with requests:
    • Prefer small limits (5–10) first.
    • Expand only if needed.
  • When returning results to the user, always include permalinks.
  • 仅支持只读模式。本工具从不发布内容、回复、投票或进行版主操作。
  • 请求需节制：
    • 优先使用较小的数量限制（5–10条）。
    • 仅在必要时扩大限制。
  • 向用户返回结果时，必须包含固定链接（permalinks）。

Output format

输出格式

All commands print JSON to stdout.
  • Success: 
    { "ok": true, "data": ... }
  • Failure: 
    { "ok": false, "error": { "message": "...", "details": "..." } }
所有命令都会将JSON输出到标准输出。
  • 成功：
    { "ok": true, "data": ... }
  • 失败：
    { "ok": false, "error": { "message": "...", "details": "..." } }

Commands

命令列表

1) List posts in a subreddit

1) 列出Subreddit中的帖子

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

2) 搜索帖子

bash
undefined
bash
undefined

Search within a subreddit

在单个Subreddit内搜索

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

Search all of Reddit

全Reddit范围搜索

node {baseDir}/scripts/reddit-readonly.mjs search all "<query>" --limit 10
undefined
node {baseDir}/scripts/reddit-readonly.mjs search all "<query>" --limit 10
undefined

3) Get comments for a post

3) 获取帖子的评论

bash
undefined
bash
undefined

By post id or URL

通过帖子ID或URL

node {baseDir}/scripts/reddit-readonly.mjs comments <post_id|url> --limit 50 --depth 6
undefined
node {baseDir}/scripts/reddit-readonly.mjs comments <post_id|url> --limit 50 --depth 6
undefined

4) Recent comments across a subreddit

4) 获取Subreddit的最新评论

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

5) Thread bundle (post + comments)

5) 帖子+评论完整线程

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

6) Find opportunities (multi-subreddit helper)

6) 查找目标内容（多Subreddit助手）

Use this when the user describes criteria like: "Find posts about X in r/a, r/b, and r/c posted in the last 48 hours, excluding Y".
bash
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
当用户描述如下需求时使用此命令： "在r/a、r/b和r/c中查找过去48小时内发布的关于X的帖子，排除Y相关内容"
bash
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

Suggested agent workflow

建议的Agent工作流

  1. Clarify scope if needed: subreddits + topic keywords + timeframe.
  2. Start with 
    find
    (or 
    posts
    /
    search
    ) using small limits.
  3. For 1–3 promising items, fetch context via 
    thread
    .
  4. Present the user a shortlist:
    • title, subreddit, score, created time
    • permalink
    • a brief reason why it matched
  5. If asked, propose draft reply ideas in natural language, but remind the user to post manually.
  1. 如有必要，明确范围：subreddit、主题关键词和时间范围。
  2. 先使用
    find
    （或
    posts
    /
    search
    ）命令，设置较小的数量限制。
  3. 对于1–3个有价值的内容，通过
    thread
    命令获取上下文。
  4. 向用户展示清单：
    • 标题、subreddit、得分、创建时间
    • 固定链接（permalink）
    • 匹配原因简述
  5. 若用户要求，以自然语言提供回复草稿建议，但需提醒用户手动发布。

Troubleshooting

故障排除

  • If Reddit returns HTML, re-run the command (the script detects this and returns an error).
  • If requests fail repeatedly, reduce 
    --limit
    and/or set slower pacing via env vars:
bash
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)'
  • 若Reddit返回HTML内容，请重新运行命令（脚本会检测到这种情况并返回错误）。
  • 若请求反复失败，请减小
    --limit
    参数值，或通过环境变量设置更慢的请求频率：
bash
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)'