ReddGrow — 面向 AI Agent 的 Reddit 情报服务

为 AI Agent 提供 Reddit API 访问能力。所有命令均以 JSON 格式输出至 stdout；错误信息输出至 stderr，并返回退出码 1。

安装与配置

# 安装
npm install -g @reddgrow/cli

# 认证（仅需执行一次）
reddgrow auth login rg_your_api_key_here

# 或使用环境变量
export REDDGROW_API_KEY=rg_your_api_key_here

命令列表

子版块（Subreddits）

reddgrow subreddits search "" [--limit N]                                            # (3 cr)
reddgrow subreddits about                                                             # (1 cr)
reddgrow subreddits rules                                                             # (1 cr)
reddgrow subreddits wiki                                                              # 列出 Wiki 页面（5 cr）
reddgrow subreddits wiki-page                                                   # 读取指定 Wiki 页面（5 cr）
reddgrow subreddits posts  [--sort hot|new|top|rising|controversial] [--time hour|day|week|month|year|all] [--limit N]  # (2 cr)
reddgrow subreddits comments  [--limit N]                                             # 实时评论流（2 cr）
reddgrow subreddits check-url  ""                                                # 检查 URL 是否已被提交（3 cr）
reddgrow subreddits traffic                                                           # 流量统计（1 cr）
reddgrow subreddits widgets                                                           # 侧边栏组件（1 cr）

帖子（Posts）

reddgrow posts search "" [--subreddit ] [--sort relevance|hot|top|new|comments] [--limit N]  # (3 cr)
reddgrow posts comments   [--sort best|top|new|controversial] [--limit N]             # (2 cr)
reddgrow posts duplicates                                                             # (5 cr)
reddgrow posts batch                                                                         # (5 cr)

用户（Users）

reddgrow users profile                # Karma 值、账户创建时间、活跃度（1 cr）
reddgrow users posts  [--limit N]     # 帖子历史（2 cr）
reddgrow users comments  [--limit N]  # 评论历史（2 cr）

域名（Domains）

reddgrow domains mentions  [--limit N]  # 所有链接到该域名的帖子（5 cr）

认证（Auth）

reddgrow auth whoami         # 身份信息及剩余积分（1 cr）
reddgrow auth status         # 连接状态
reddgrow auth login     # 保存 API 密钥（仅需运行一次）

典型工作流

向子版块发帖前

1. 阅读规则：reddgrow subreddits rules — 违反规则将导致帖子被立即删除
2. 确认社区类型：reddgrow subreddits about — 若 subreddit_type 为 restricted 或 private，则禁止发帖；若 submission_type 为 link 或 self，请严格遵守
3. 检查目标 URL 是否已存在：reddgrow subreddits check-url ""
4. 查阅 Wiki 获取补充指南：reddgrow subreddits wiki-page index
5. 仅当全部检查通过后方可发帖

子版块调研

1. 发现相关社区：reddgrow subreddits search ""
2. 查看详细信息：reddgrow subreddits about — 规模、类型、活跃度
3. 浏览内容：reddgrow subreddits posts --sort top --time week --limit 50
4. 评估活跃度：reddgrow subreddits traffic
5. 查找指南：reddgrow subreddits wiki ，再结合 wiki-page 查阅具体内容

监控某个域名 / 品牌

1. 发现提及内容：reddgrow domains mentions --limit 100
2. 阅读讨论：reddgrow posts comments --sort best
3. 重新分享前检查是否重复：reddgrow subreddits check-url ""

分析某 Reddit 用户

1. 获取概览：reddgrow users profile — Karma 值、账户年龄、是否已验证
2. 回顾发帖记录：reddgrow users posts --limit 50
3. 回顾评论记录：reddgrow users comments --limit 50

使用规范

1. 发帖前务必运行 reddgrow subreddits rules — 违规将导致帖子被立即删除
2. 分享任意链接前务必运行 reddgrow subreddits check-url "" — 重复发帖可能被封禁
3. 当规则中提及额外指南时，请查阅 Wiki：wiki-page index
4. 尊重 subreddit_type：若为 restricted 或 private，则不允许发帖
5. 尊重 submission_type：部分子版块仅接受链接或仅接受文字帖
6. 执行大规模批量操作前，务必先运行 reddgrow auth whoami 确认剩余积分，避免耗尽配额
7. 切勿向明确禁止自我推广的社区发布推广类内容

配置项