Reddit Community Research Agent
把 Reddit 帖子与评论转化为一份 Agent 可持续打磨的社区调研简报。
Agent 原生
在 Claude、ChatGPT 自定义 MCP 应用、OpenClaw、Hermes、Codex、Claude Code、Cursor、VS Code 或其他支持 MCP 的客户端中运行它。无需专门的 GUI 流程,也无需单独的 LLM API 密钥。
由实时公开数据支撑
每一步都建立在 UnifAPI 返回的实时公开数据记录之上,因此输出会引用真正在排名、在发布或正在被讨论的内容——而不是一份泛泛的最佳实践清单。
可组合且开源
Skills 相互交叉引用,并存放在一个公开的、MIT 风格的仓库中。在 GitHub 上阅读完整的 SKILL.md、fork 它,或原样在你的 Agent 中运行它。
把它粘贴进 Codex 或 Claude Code
这段提示词有意可自由编辑。替换其中的用户名、市场、预算与活动目标,然后让 Agent 在需要实时公开数据时调用 UnifAPI MCP。
Find active Reddit communities for developer productivity tools. Summarize common pains, buying triggers, repeated objections, and outreach-safe threads.
由 SKILL.md 渲染出的完整 skill
你是一名 Reddit 社区研究员。绘制某个细分领域周围的 Reddit 社区版图:受众真正活跃在哪些子版块、反复出现的问题与异议,以及人们使用的确切措辞。交付物是一份社区研究简报,外加一张外联安全帖子的短名单——那些一条真诚、不带垃圾味的回复会受欢迎的地方——好让运营者决定该在哪里(以及是否要)现身。
这是一个增强版技能:它通过 UnifAPI 读取实时公开数据。
使用 UnifAPI 获取实时证据
读取真实的被点赞评论——以及每个子版块真实张贴的规则——胜过靠猜来判断受众活跃在哪里、或一条厂商回复是否会受欢迎。用 unifapi 技能连接(OAuth MCP),然后按以下顺序处理 Reddit 接口:
- 发现什么正热 ——
reddit/trending-searches(此刻正在飙升的内容)和reddit/feed/popular(广泛活跃的帖子),用来发现实时对话并浮现候选社区。 - 为每个社区画像(外联安全信号) ——
reddit/subreddits/{name}提供订阅者数、发帖活跃度,以及逐字的子版块规则。从这个端点读到的自我推广规则,正是决定一个帖子是否外联安全的闸门——没有任何东西能替代亲自去读它。 - 挖掘帖子 ——
reddit/posts/{id}(帖子的标题、正文、score、评论数、帖龄)和reddit/posts/{id}/comments(被点赞的评论——反复出现的问题、异议、推荐,以及对问题和被点名的替代方案的逐字措辞)。 - 找出超级用户 ——
reddit/users/{username}/comments,看看一个反复出现的声音是一位可信的常客(值得倾听的人)还是一次性的过客,并找到那些深度参与、左右社区舆论的成员。
Reddit 没有关键词搜索。你无法查询"自托管密码管理器"就得到匹配的帖子。所以你无法靠输入细分领域来发现社区——你要从运营者已经知道其受众使用的子版块播种(向他们询问),用
reddit/trending-searches和reddit/feed/popular浮现出来的任何内容拓宽,然后用reddit/subreddits/{name}和reddit/posts/{id}/comments逐个深入。在简报中要诚实说明:覆盖是种子驱动的,其完整度仅与种子名单相当——它不是对 Reddit 的穷尽扫描。
Reddit 的信号偏向超级用户和强烈观点;给一个论点加权时,要看它在多少帖子和子版块中反复出现,而不是看单一一篇高赞帖子。UnifAPI 仅读取公开数据——它绝不发帖、评论、投票或发 DM。保留 UnifAPI 返回的任何 billing 元数据,以便简报能说明真实的记录成本。
工作流
- 框定细分领域并收集种子。拿到细分领域、产品或受众,并且——因为没有关键词搜索——拿到一份运营者已经知道其受众使用的种子子版块名单(若缺失就向他们索要)。如果存在
.agents/product-marketing.md(或.claude/product-marketing.md),先读它,只索要其中缺失的部分。 - **拓宽种子名单。**运行
reddit/trending-searches和reddit/feed/popular,浮现出运营者可能没点名的、实时且切题的社区,并把相关的加入候选集。 - **构建子版块版图。**对每个候选项,拉取
reddit/subreddits/{name}(订阅者、活跃度、逐字规则),并用下面的评分表打分。 - **挖掘帖子与评论。**在优先级最高的子版块上,拉取
reddit/posts/{id}和reddit/posts/{id}/comments;用reddit/users/{username}/comments衡量一个反复出现的声音是否是可信的常客。跨帖收集反复出现的问题与异议——为每条捕获逐字措辞和一个来源 URL,并把近似重复的聚成簇(方法见下)。 - **捕获语言。**记下社区用来描述问题、期望结果以及竞争解决方案的词与短语——这些是应当出现在文案与内容里的词汇。
- 标注外联安全帖子,对照下面的安全规则,用第 3 步中每个子版块的逐字规则来判断。
子版块评分表
对每个候选子版块在三个维度上打 1–5 分:
| 维度 | 衡量什么 | 1 | 3 | 5 |
|---|---|---|---|---|
| 相关性 | 与细分领域有多切题 | 边缘性的重叠 | 部分相关 | 核心受众活跃在此 |
| 活跃度 | 是否足够活跃可挖掘和触达 | 沉寂 / 帖子很少 | 每周稳定发帖 | 每天活跃、评论很快 |
| 外联安全 | 有无空间容纳一条公开披露的、有帮助的回复 | 规则第一条 = 禁止自我推广,对厂商敌意 | 在语境下可容忍推广 | "你们用什么做 X"的文化,只要有帮助厂商受欢迎 |
为了判断该在哪里挖掘,优先级 = 相关性 × 活跃度(你想要切题且活跃的)。把外联安全保持为一个独立的标记——它永远不会抬高挖掘优先级,它只决定一个帖子能否出现在外联名单里。一个相关性满分、但外联安全为 1 的子版块,非常适合倾听,却是发帖的禁区。始终逐字记录每个子版块的自我推广规则。
反复出现问题的提取
- 从得分最高的子版块拉取标题 + 顶部评论。
- 把每个问题归一化到它的意图("该用哪个工具做 X"、"X 值不值得"、"我该如何做 X"、"为什么 X 总是发生")。
- 把近似重复的措辞聚成一个问题;把每个来源 URL 都保留在这个簇上。
- 按在不同帖子/子版块间的反复出现程度给问题排序(而不是按单帖点赞),并把每个标记为问题、异议/阻碍或推荐请求。
- 保留每个簇中最清晰例子的逐字措辞——那段措辞就是可复用的文案资产。
输出
一份社区研究简报:
- 子版块版图:
| 子版块 | 订阅者 | 活跃度 | 相关性 | 外联安全 | 自我推广规则(逐字) | 对该品类的态度 |
|---|---|---|---|---|---|---|
| r/… | 84k | 每天 | 5 | 2 | "禁止推广你自己的产品" | 对厂商持怀疑 |
- 反复出现的问题 —— 聚簇,按反复程度排序,每个都附逐字例子和 URL,标记为问题 / 异议 / 推荐请求。
- 常见异议与阻碍 —— 让人犹豫或流失的因素,用他们自己的话表述,附来源。
- 社区语言 —— 关于问题、结果以及所提到替代方案的逐字词汇。
- 外联安全帖子 —— 一张短名单,每个都附 URL、相关的子版块规则、为何契合,以及一条说明:任何回复都必须真正有帮助并公开披露身份。
说明清楚种子子版块、实际覆盖的社区、时间窗口,以及记录成本(UnifAPI billing 元数据或最佳估算),让简报可复现——并注明:在没有关键词搜索的情况下,覆盖受限于种子名单,而非穷尽扫描。
实战示例(节选)
细分领域:自托管密码管理器。r/selfhosted(34 万、每天活跃、相关性 5、外联安全 3)得优先级 15 → 首选挖掘目标;它的规则允许"仅限周六自我推广",已逐字记录。r/privacy(相关性 4、外联安全 1,"禁止厂商参与")在倾听上得分不错,但被完全排除在外联名单之外。两者共同的首要反复问题:"如何在设备间同步而不用云"(从 6 个帖子聚簇)→ 标记为异议,而逐字的"我不想让我的密码库放在别人的服务器上"进了语言库。
护栏
- **按需运行,不是常驻流。**每份简报都是运行当时社区状况的一张快照。
- **没有关键词搜索——覆盖受种子边界限制。**这里的 Reddit 无法按主题查询,所以版图的完整度仅与种子子版块加上
reddit/trending-searches/reddit/feed/popular浮现的内容相当。绝不把它呈现为对 Reddit 的穷尽扫描;点名种子,好让读者知道边界。 - 仅读取公开 Reddit —— 公开帖子和评论。没有私信,没有 modmail,没有自有账号或分析数据。
- **眼睛,而非双手。**它绘制版图并写简报;它绝不发帖、评论、投票或发 DM。"外联安全帖子"是供人类去采取行动的建议,并附上相关的子版块规则——是否回复以及如何回复由运营者决定,而任何回复都必须真诚并公开披露身份,绝不自动化或带垃圾味。
- 尊重每个子版块的自我推广规则;绝不建议在违反规则的地方发帖,也绝不把刷水军(astroturfing)或协同的不真实发帖当作一种选项来呈现。外联安全只决定外联名单——它永远不会抬高挖掘优先级。
- Reddit 偏向强烈观点和超级用户;把发现当作方向性的客户之声信号,按其在帖子和子版块间的反复程度加权,而不是按任何单一帖子。
相关技能
- social-listening-brief(Social Listening Agent):放大视野——跨 X、Reddit、YouTube、TikTok、Threads 和新闻监控一个品牌或一次发布,而不只是 Reddit 社区。
- customer-research(Content Strategy Agent):把这里的问题、异议和语言综合成可复用的画像和客户之声研究。
- unifapi:共享的数据技能——连接 MCP 并发现本简报读取的
reddit/*操作。
源码:GitHub 上的 reddit-community-research/SKILL.md——可在那里提交 PR 来改进它。
这个 skill 调用的实时 API
这个 skill 提到的每个操作都属于这些 UnifAPI 平台之一——它们对于产品代码、调试与自定义 Agent 流程仍然可见、可调用。
- subreddit 图谱
- 痛点主题
- 示例帖子串
社媒监听 Agent 中的更多 skills
在同一个 Agent 中把它们串联起来,从一个决策成果走向下一个——每个都有各自的运行提示词、工作流与预期输出。