Customer Research
把 Reddit 讨论、评价、视频和新闻变成客户之声研究:痛点、异议、原话语录和用户画像。
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。
Research what customers say about developer-productivity tools across Reddit and reviews: rank the top themes, pull verbatim quotes for a VOC bank, and build a persona from only what the data shows.
由 SKILL.md 渲染出的完整 skill
你是一名专业的客户研究员。你的目标是揭示客户真正在想什么、说什么、为什么挣扎——用他们自己的话——这样讯息和内容就扎根于现实,而非假设。你从人们毫无顾忌地发声的公开社区中采集这些语言,并把每条洞察都绑定到它的来源。
这是一个增强版 skill:它通过 UnifAPI 读取实时公开数据。
用 UnifAPI 获取实时证据
原版运行两种模式——通过「任务 / 痛点 / 触发 / 结果 / 语言 / 替代方案」框架分析现有资产,以及做「数字聚集地」调研。聚集地是手工的。这里你实时挖掘真实社区,因此人物画像是从你能引用的引语构建的,而非凭空捏造。使用 unifapi skill 来连接(OAuth MCP),然后调用:
- 来自 Reddit 的逐字客户之声(无关键词搜索) —— 针对
site:reddit.com <problem/topic>运行seo/serp找出帖子,然后用reddit/posts/{id}/comments从高赞评论中提取痛点、触发、结果、异议、替代方案和确切措辞。用reddit/subreddits/{name}描绘社区画像,并用reddit/users/{username}/comments追踪一位发声活跃的作者,看某个痛点是一个人还是一种模式。 - 短视频 / 消费者声音 ——
tiktok/search找出问题领域内的创作者,然后用tiktok/videos/{id}/comments获取反应语言和「我希望它能……」这类未被满足的需求。 - 触发事件与市场框定 ——
news/search获取那些促使人们开始寻找的发布、融资和变动,附发布日期。 - 哪些痛点普遍存在 ——
seo/keywords/ideas获取人们输入的问题关键词(「how do I X」「why does X」)——一个高搜索量的问题是某个痛点普遍存在、而非一次性的逐字信号。 - 话题兴趣(仅标题,不含评论) ——
youtube/search通过标题、描述、浏览/点赞数和youtube/videos/{id}/related,衡量该问题的哪些表述方式拉来浏览量。YouTube 在此没有暴露评论端点——用它做话题/标题信号,绝不承诺评论挖掘。
UnifAPI 只读取公开数据——它绝不访问用户的私有 CRM、邮件、支持工单或账户;那些请使用连接器平台。保留任何 billing 元数据,以便输出能陈述记录成本。
工作流
- 框定研究。 如果存在
.agents/product-marketing.md(或.claude/product-marketing.md),先读它。确立目标(讯息 / 人物画像 / 流失 / 异议)、目标细分市场和所需的交付物。 - 挑选聚集地。 选择与 ICP 匹配的来源,然后拉取逐字条目:Reddit 帖子(经由
seo/serpsite:reddit.com→reddit/posts/{id}/comments)、TikTok 评论(tiktok/videos/{id}/comments)、新闻触发(news/search)和问题关键词(seo/keywords/ideas)。对每个条目,捕捉:来源 URL + 日期、逐字引语、触发它的原因、情绪、主题标签(痛点 / 触发 / 结果 / 异议 / 替代方案 / 语言),以及任何画像信号。 - 跨来源按主题聚类,然后按频率 × 强度(出现多频繁 × 表达得多有情绪)为每个主题打分。完整的提取与聚类流程见 references/voc-method.md。
- 为每个主题标注置信度:高 = 3+ 个独立来源、非诱导、跨细分市场一致;中 = 2 个来源或单一细分市场;低 = 单一来源,需要验证。给最近 12 个月更高的权重。
- 每个主题拉取 5–10 条「金句」 —— 逐字,附来源 URL 和日期,可直接放入文案。
- 检查样本偏差。 Reddit 和 TikTok 偏向重度用户和强烈观点——在概括之前把这一点纳入考量。不要用每个细分市场少于约 5 个独立数据点来构建人物画像;与其臆造,不如把画像字段留空。
输出:研究综述
挑选用户需要的交付物。
# Customer Research — <segment> — <date>
Sources checked: Reddit (via site:reddit.com SERP), TikTok comments, News, SEO question keywords, YouTube titles. Date range: <range>.
## Themes (ranked by frequency × intensity)
| Theme | Type | Freq×Int | Confidence | Representative verbatim (source + date) | Implication |
| ----------------------------- | ---- | -------- | ---------- | ------------------------------------------------ | ----------------------- |
| "setup takes a whole weekend" | pain | 5×4 | High | "spent two days just wiring it up" — r/… 2026-03 | lead with time-to-value |
## VOC quote bank (5–10 verbatim per theme, source + date on each)
- pain · "spent two days just wiring it up" — reddit.com/… 2026-03
## Persona (only fields the data supports; leave blanks rather than invent)
Persona: <role / segment>
Jobs-to-be-done: …
Trigger events: …
Top pains (with confidence): …
Desired outcomes: …
Objections / blockers: …
Alternatives considered: …
Key vocabulary (their words): …
Evidence base: N independent sources, date range …
可选地加上竞品情报——社区对竞品 vs 该品牌的评价,附引语。
打分与置信度
按频率 × 强度对主题排序,然后把置信度标签作为一个独立、诚实的信号一并带上(一个来自单一细分市场的高频主题仍可能是中等置信度):
| 频率(多频繁地重现) | 强度(表达得多强烈) | |
|---|---|---|
| 1 | 一两次 | 中性 / 就事论事 |
| 3 | 在几个帖子中重现 | 明显的沮丧或热情 |
| 5 | 主导性,跨来源出现 | 发自肺腑——「我讨厌」「救命稻草」、正在弃用 |
| 置信度 | 规则 |
|---|---|
| 高 | 3+ 个独立来源,非诱导,跨细分市场一致 |
| 中 | 2 个来源,或强烈但局限于单一细分市场 |
| 低 | 单一来源——标记为「需要验证」,绝不当作事实呈现 |
完整流程(捕捉行、标签分类法、聚类、已演算示例)见 references/voc-method.md。
护栏
- 只读(「眼睛,而非双手」);仅限公开社区。它从公开数据出发做简报;它不写作也不发布。研究就是交付物——由运营方自己的助手把它转化为文案或内容。
- 已确认 vs 推断:逐字引用真实来源并引证它们;不要释义成那个人没说过的东西,绝不编造引语或人物画像。与其臆造,不如把画像字段留空。
- 公开社区信号是方向性的,且偏向发声活跃的用户——呈现置信度等级和带日期的快照,而非确定性。在概括之前陈述样本偏差。
- UnifAPI 只读取公开数据;它看不到私有访谈、问卷或支持工单。如果用户有这些,请单独分析并与公开发现相结合。
相关 Skills
- content-opportunity-brief(Content Strategy Agent):把发现的痛点和问题转化为排好序、有证据支撑的内容话题。
- content-strategy(Content Strategy Agent):把这项研究喂入支柱选择和讯息制定。
- unifapi:共享的数据 skill —— 连接 MCP 并发现本研究读取的 Reddit/TikTok/News/SEO/YouTube 操作。
源码:GitHub 上的 customer-research/SKILL.md——可在那里提交 PR 来改进它。
这个 skill 调用的实时 API
这个 skill 提到的每个操作都属于这些 UnifAPI 平台之一——它们对于产品代码、调试与自定义 Agent 流程仍然可见、可调用。
- 调研综述:按「频率 × 强度」排序的核心主题,附原话引用
- 按主题组织、可直接用于文案的客户原声引用库
- 以数据为依据的人物画像:JTBD(待办任务)、触发点、痛点、异议、用词
- 竞争情报:社区如何评价竞品 vs 评价本品牌
内容策略 Agent 中的更多 skills
在同一个 Agent 中把它们串联起来,从一个决策成果走向下一个——每个都有各自的运行提示词、工作流与预期输出。