reddit-readonly 是面向 Clawdbot 的只读 Reddit 浏览技能,使用公开 JSON 端点获取数据,适合查找帖子、检索主题、查看评论区并整理可手动打开的永久链接。硬性规则:只读,绝不发帖、回复、投票或管理;请求要克制,先用小 limit(5–10),必要时再扩大;返回结果始终包含永久链接。所有命令以 JSON 输出到 stdout,成功为 {"ok": true, "data": ...},失败为 {"ok": false, "error": {...}}。
主要命令:posts 列出子版块帖子(支持 hot/new/top/controversial/rising 排序,time 参数 day|week|month|year|all,以及 limit、after 分页);search 在指定子版块或全站搜索帖子;comments 按帖子 id 或 URL 获取评论(支持 limit、depth);recent-comments 获取某子版块近期评论;thread 获取帖子加评论的组合;find 为多子版块筛选助手,支持 --subreddits、--query、--include、--exclude、--minScore、--maxAgeHours、--perSubredditLimit、--maxResults、--rank 等参数,适合“在 r/a、r/b、r/c 找最近 48 小时关于 X 的帖子并排除 Y”这类需求。
推荐流程:先明确子版块、关键词与时间范围;用小 limit 执行 find 或 posts/search;对 1–3 个有价值结果用 thread 获取上下文;向用户展示标题、子版块、分数、创建时间、永久链接和匹配理由;如需要可提供自然语言回复草稿,但提醒用户自行手动发布。
故障处理:若 Reddit 返回 HTML,脚本会检测并返回错误,重新运行命令即可;若反复失败,可降低 --limit 并通过环境变量放慢节奏,例如 export REDDIT_RO_MIN_DELAY_MS=800、REDDIT_RO_MAX_DELAY_MS=1800、REDDIT_RO_TIMEOUT_MS=25000、REDDIT_RO_USER_AGENT='script:clawdbot-reddit-readonly:v1.0.0 (personal)'。该技能依赖 Reddit 公开端点,具体可用性、速率限制和平台支持以实际环境为准,资料未提供更多平台或部署细节。