mcpField
R
reddit-readonly

reddit-readonly

github.com/tristanmanchester生产力3432 次安装7 周前更新
代码仓库

关于 reddit-readonly

reddit-readonly 是用于 Clawdbot 的 Reddit 只读浏览技能,可查找帖子并获取评论上下文,供用户通过永久链接手动跟进。

主要功能

  1. 01按排序和时间浏览版块帖子
  2. 02在版块内或全站搜索帖子
  3. 03获取评论及帖子讨论串
  4. 04跨多个版块筛选机会
  5. 05只读操作,不发帖或投票

适用场景

  1. 01查找符合主题的近期帖子
  2. 02回复前查看帖子评论
  3. 03收集链接以便手动回复

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tristanmanchester/agent-skills --skill reddit-readonly

安装后在 Claude Code 中输入/reddit-readonly确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
OUTPUT_SCHEMA.md
scripts/
reddit-readonly.mjs

详细介绍

Reddit 只读浏览

用于 Clawdbot 的 Reddit 只读浏览工具。

此技能的用途

  • 查找一个或多个 subreddit 中的帖子(热门、最新、最佳、争议、上升)
  • 按查询词搜索帖子(在某个 subreddit 中或跨所有 subreddit)
  • 获取评论串以了解上下文
  • 整理一份永久链接清单,方便用户打开 Reddit 并手动回复

严格规则

  • 仅限只读。 此技能不会发帖、回复、投票或执行版务操作。
  • 发出请求时请保持礼貌:
    • 优先使用较小的限制(先尝试 5–10 条)。
    • 只有在需要时才扩大范围。
  • 向用户返回结果时,务必包含永久链接。

输出格式

所有命令都会将 JSON 输出到 stdout。

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

命令

1) 列出某个 subreddit 中的帖子
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) 获取某个 subreddit 中的最新评论
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) 查找机会(多 subreddit 辅助工具)

当用户提出如下条件时使用: “查找过去 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

建议的 Agent 工作流

  1. 必要时明确范围:subreddit + 主题关键词 + 时间范围。
  2. 从使用较小限制的 find(或 posts/search)开始。
  3. 对 1–3 条有希望的结果,通过 thread 获取上下文。
  4. 向用户提供一份清单:
    • 标题、subreddit、评分、创建时间
    • 永久链接
    • 简要说明匹配原因
  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)'

评论

支持 Markdown