SuperAPI AI 工具集

reddit-readonly

写作与研究

查看项目

更新于 11-02 01:29

技能介绍

reddit-readonly 是一个面向智能体的只读 Reddit 浏览技能,主要用于在不进行任何写操作的前提下查询 Reddit 公开内容。

用途:该技能适合需要浏览 subreddit、按主题搜索帖子、查看评论上下文或筛选潜在互动机会的场景。它明确限定为只读,不会发帖、回复、投票或执行管理操作。

主要能力:

  • 列出 subreddit 帖子,支持 hot、new、top、controversial、rising 排序,并可指定时间范围(day、week、month、year、all)、数量限制和分页 token。
  • 搜索帖子,可在指定 subreddit 内搜索,也可在全站范围(all)搜索。
  • 获取指定帖子的评论,支持通过帖子 ID 或 URL 指定,并可控制评论数量和深度。
  • 获取某个 subreddit 的近期评论。
  • 获取“帖子 + 评论”的线程捆绑数据。
  • 使用 find 命令进行多 subreddit 条件筛选,支持查询词、包含词、排除词、最低分数、最大时效、每个 subreddit 的限制、最大结果数和排序方式。

使用方式:所有命令通过 node 运行 {baseDir}/scripts/reddit-readonly.mjs,并将 JSON 输出到 stdout。成功时返回 { "ok": true, "data": ... },失败时返回 { "ok": false, "error": { "message": "...", "details": "..." } }。建议先以较小 limit(如 5–10)发起请求,必要时再扩大;返回结果时应始终包含 permalink。若请求频繁失败,可减小 limit 或通过环境变量 REDDIT_RO_MIN_DELAY_MS、REDDIT_RO_MAX_DELAY_MS、REDDIT_RO_TIMEOUT_MS、REDDIT_RO_USER_AGENT 调整请求节奏与超时。

适用场景:适合内容调研、话题发现、收集讨论链接、为手动回复准备候选列表等只读任务。智能体可先明确 subreddit、关键词和时间范围,再用 find 或 posts/search 获取结果,对少量候选使用 thread 拉取上下文,最后向用户呈现标题、subreddit、分数、创建时间、permalink 和匹配理由。

限制:仅支持只读操作;依赖 Reddit 公开 JSON 端点,若返回 HTML 需重新运行命令;反复失败时应降低请求频率或减少 limit。该技能不提供发帖、回复、投票或管理功能,用户需手动前往 Reddit 进行互动。