# Redditfind

> Use RedditFind through an AI-friendly CLI to authorize access, discover relevant subreddits, analyze communities, create monitoring jobs, and inspect usage for OpenClaw workflows.

- Skill: `bigbigwatermelon/redditfind` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bigbigwatermelon/redditfind`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bigbigwatermelon/redditfind/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: bigbigwatermelon (https://skillmd.com/u/bigbigwatermelon)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bigbigwatermelon/redditfind

---


# RedditFind Skill

## 何时使用

当用户希望你完成下面这些事情时，使用这个 Skill：

- 找适合产品进入的 subreddit
- 分析某个 subreddit 的规则、氛围和参与方式
- 创建或管理 Reddit 监控任务
- 查看 RedditFind usage、当前接入状态与授权状态
- 用稳定的 CLI 而不是手写 HTTP 来接入 RedditFind Open API

## 启动前检查

每次进入业务命令前，优先执行：

1. `./bin/redditfind doctor --json`
2. `./bin/redditfind auth ensure --json`

如果 `doctor` 返回 API 不可达、配置不可写、授权已失效，先修复再继续。

## 核心执行规则

- 优先用 CLI，不默认手写 HTTP 请求
- discovery / overview 这类异步任务，默认优先 `--wait`
- 默认使用 `test` 环境，除非用户明确要求 `live`
- 不要自动扩大 scope；scope 不足时，先说明并重新走授权
- 删除监控、撤销凭证、切换到 `live` 时，先明确告诉用户

## 默认命令映射

- 找社区：`./bin/redditfind discovery create --wait --json`
- 社区分析：`./bin/redditfind overview create --wait --json`
- 创建监控：`./bin/redditfind monitoring create --json`
- 读取 usage：`./bin/redditfind usage get --json`
- 查看当前 token 身份：`./bin/redditfind auth whoami --json`

## 授权流程

默认授权路径：

1. `auth ensure` 发起 `skill-auth/start`
2. CLI 自动打开浏览器到授权确认页
3. 用户登录并批准一次
4. CLI 轮询 `skill-auth/poll`
5. CLI 调 `skill-auth/exchange` 换取正式 Token
6. CLI 把 Token 安全保存到本机 profile

优先使用 CLI 自带流程，不要要求用户自己打开控制台复制 API Key。

## 错误恢复

- `AUTH_REQUIRED`：先执行 `./bin/redditfind auth ensure --json`
- `DEVICE_CODE_INVALID`：重新执行 `auth ensure`
- `FLOW_EXPIRED`：重新执行 `auth ensure`
- `FORBIDDEN` / `SCOPE_INSUFFICIENT`：说明 scope 不足并重新授权
- `RATE_LIMITED`：等待 `retry_after` 或 `Retry-After` 后重试一次
- `RESULT_NOT_READY`：继续等待，不要把它当成失败
- `NOT_FOUND`：检查资源 ID 或重新创建任务

详细说明见：

- `references/auth-flow.md`
- `references/command-contract.md`
- `references/error-recovery.md`
- `references/api-map.md`

## 输出规则

返回给用户时：

1. 先给一句结论
2. 再给关键发现
3. 再给风险提醒
4. 最后给下一步建议

如果命令带 `--json`，优先消费结构化输出后再整理给用户，不要直接原样转发内部 JSON。