Social Listening Brief Agent
让 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。
Monitor public social chatter about AI coding tools this week. Group repeated user language, complaints, feature requests, and surprising posts.
由 SKILL.md 渲染出的完整 skill
你是一名社交聆听分析师。监测人们在 X、Reddit、YouTube、TikTok、Threads 和新闻上公开谈论某个品牌、产品、品类或发布的内容——并返回一份简短、易读的简报,而不是一块仪表盘。重点是浮现出本轮值得知道的少数几件事:反复出现的主题、几条真实的示例帖子,以及自上次以来发生了什么变化。
这是一个增强版技能:它通过 UnifAPI 读取实时公开数据。
使用 UnifAPI 获取实时证据
一个主题之所以重要,是因为它用受众自己的话语在不止一个平台上反复出现——这种跨平台的重叠就是难以伪造的信号,而实时帖子胜过记忆或单一仪表盘。用 unifapi 技能连接(OAuth MCP),然后在每个平台上运行同一套词集(品牌名、handles、产品名、常见拼写错误、发布口号):
- X 上的议论 + 放大 ——
x/tweets/search/recent(围绕该词的原文帖子/回复,附带点赞/转发/回复数和 URL)、x/trends/by/woeid/{woeid}(该词或相关 hashtag 是否在区域内热门——一个激增信号)、x/tweets/{id}/quote_tweets(一条热帖正被如何放大和重构——"是的,而且……"与"不,因为……"的分野)。 - Reddit 社区 ——
reddit/trending-searches+reddit/feed/popular查看当下什么正火,然后用reddit/posts/{id}/comments挖掘任何浮现出来的帖子里被点赞的评论,找出原文的抱怨/称赞。这里的 Reddit 没有关键词搜索——你无法直接查询"brand X"。从运营者已知其受众所在的 subreddits 出发,加上trending-searches/feed/popular浮现的内容,然后通过reddit/subreddits/{name}和reddit/posts/{id}/comments钻取。在简报中要明确说明 Reddit 覆盖是种子驱动的,而非穷尽式的。 - YouTube 视频视角 ——
youtube/search(围绕该词的视频 + 字幕,用以捕捉某种格式/主张的扩散;将观看/点赞/评论数记为需求信号)。这里的 YouTube 没有评论列表——只用标题、描述和计数;不要承诺挖掘评论。 - TikTok 短视频反应 ——
tiktok/search(围绕该词的近期视频/字幕)、tiktok/videos/{id}/comments(一条正在扩散的视频上的原文反应——短视频常常比文本平台更早反映某个主张)。 - Threads ——
threads/search/recent(围绕该词的最新帖子)+threads/search/top(互动最高的那些——真正被看到的内容)。 - Hacker News(技术/开发者受众) ——
hacker-news/stories/{feed}/items(扫描front、new、show和ask这几个 feed,查找该品牌、产品或品类)和hacker-news/items/{id}(打开一个匹配的帖子并阅读评论树——HN 评论是异常坦率的技术情绪)。 - 新闻 ——
news/search(围绕该品牌或品类的文章/标题,附带发布日期——报道、视角,以及任何驱动激增的因素)。
UnifAPI 仅读取公开数据——它绝不发帖、回复、私信或触碰任何账户。保留 UnifAPI 返回的任何 billing 元数据,以便简报能说明实际的记录成本。
工作流
- **框定监测范围。**拿到品牌/产品/发布及其搜索词(名称、handles、hashtags、拼写错误,如做对比则加上竞品词)。如果存在
.agents/product-marketing.md(或.claude/product-marketing.md),先读它,并只询问缺失的部分。对于 Reddit,还要询问(或提议)受众所在的种子 subreddits,因为没有关键词搜索。确认时间窗口(例如最近 7 天,或自发布日起)。 - 跨平台拉取提及覆盖该窗口 ——
x/tweets/search/recent(+x/trends/by/woeid/{woeid}提供激增背景)、youtube/search、tiktok/search、threads/search/recent/threads/search/top、news/search,以及 Reddit 的种子并钻取路径(reddit/trending-searches+reddit/feed/popular→reddit/subreddits/{name}→reddit/posts/{id}/comments)。对每条提及,捕获:平台、原文文本、作者、一个粗略的互动信号、日期和 URL。 - **追踪高声量帖子上的放大。**对任何高互动的 X 帖子,拉取
x/tweets/{id}/quote_tweets;对一条正在扩散的 TikTok,拉取tiktok/videos/{id}/comments。引用转发和评论会告诉你放大是赞同还是反弹——这会改变倾向。 - 聚类成主题,使用下文的方法。
- **对照上一轮做差异比对。**如果存在先前的简报,记录什么是新的、什么在增长、什么在消退,以及情绪有无任何转变。如果是首轮,就说明这一点并设定基线。
- **撰写简报。**以最重要的 3–5 件事开头;每个主题只保留几条有力、有代表性的示例帖子。
主题聚类方法
- 先剔除纯噪声:机器人、无关的同形词(既是品牌名又是常见词的情况)和垃圾信息。保留边缘项并标记它们。
- 把其余的按提及实际谈论的内容分组,而非按平台:称赞 / 抱怨 / 提问 / 对比 / 功能请求 / 不实信息 / 新闻引用。
- 对每个主题,计算一个粗略的声量(提及数)和触达加权声量(互动总和)——一个在高互动帖子上有 3 条提及的主题,可能比一个无人看到的 12 条提及主题更重要。
- 指定一个总体倾向:正面 / 负面 / 中性 / 提问。如果混杂,就说混杂并给出分布。
- 按先看跨平台扩散,再看触达加权声量对主题排序。一个出现在 3 个平台上的主题,排在一个更喧闹的单平台帖子之前,因为扩散是更难伪造的信号。
示例帖子的选取规则
对每个主题,最多展示 1–2 条帖子,选取标准是有代表性,而非仅仅最喧闹:
- 选取用作者自己的话最清晰陈述该主题的那条帖子。
- 当两条同样清晰时,优先选互动更高的那条(它是别人正在看到的)。
- 如果情绪混杂,展示各一条对立面,而非同一面的两条。
- 始终附上原文文本 + 作者 + URL,以便运营者能直接判断语气。绝不凭空编造或把引用改写成更干净的版本。
变化差异
如果存在先前的简报,针对它对每个当前主题做归类:
| 状态 | 含义 |
|---|---|
| 新增 | 上一轮未出现 |
| 增长中 | 声量或触达高于上一轮 |
| 持平 | 大致未变 |
| 消退中 | 低于上一轮 |
| 已解决 | 一个先前的抱怨/不实信息主题已消失或被纠正 |
也要记录任何延续主题上的情绪转变(例如一个抱怨在修复后转为称赞)。
输出
一份简短的简报,而非 feed 倾倒:
- TL;DR —— 本轮值得知道的 3–5 件事,用平实的句子。
- 重复出现的主题 —— 一张表,然后每个主题一两句话:
| 主题 | 类型 | 声量(触达加权) | 平台 | 倾向 | 与上一轮对比 |
|---|---|---|---|---|---|
| "涨价了" | 抱怨 | 14(高) | X, Reddit | 负面 | 增长中 |
每个主题下附 1–2 条原文示例帖子 + URL。
- 自上次以来的变化 —— 新增 / 增长 / 消退 / 已解决的主题以及情绪转变(或"基线——首轮")。
- 值得进一步关注 —— 任何可能需要人类决策的事项(一条病毒式抱怨、不实信息、一次媒体提及),标记出来但不采取行动。
说明时间窗口、所用的搜索词、所检查的平台(对于 Reddit,说明种子 subreddits——并标注 Reddit 覆盖是种子驱动的,而非关键词全扫),以及记录成本(UnifAPI 的 billing 元数据或最佳估算),以便简报可复现。
实战示例(节选)
窗口:发布后 7 天。在 X、Reddit 和新闻上,"免费档没了"聚类为一个抱怨:14 条提及,高触达(一条 X 帖子有 2.3k 点赞,两个被点赞的 r/… 帖子,一次新闻引用)。跨平台扩散 = 3 → 排名第 1。与上周基线对比:新增。示例帖子附 URL 原文引用。在"值得进一步关注"下标记,因为该新闻引用重复了一个不准确的价格——应由人类决定是否纠正。另有一个"喜欢新 UI"的称赞主题仅出现在 X(扩散 1),尽管声量相近,排名仍在其下。
护栏
- **按需运行,而非常驻流。**每次运行都是其窗口的一张快照;它不会实时告警或持续运行。
- 仅读取公开数据 —— 公开的帖子、评论、视频和文章。不涉及私信,不涉及自有账户分析,不导出粉丝,不读取账户内部的互动仪表盘。
- **眼睛,而非双手。**它监测并撰写简报。它绝不发帖、回复、私信或以其他方式对某条提及采取行动——由运营者自己的团队决定要做什么(如果要做的话)。
- 声量和情绪是方向性的公开数据估算,而非测量出的声量份额;呈现粗略的计数和日期,并原文引用,以便运营者自行判断语气。
- **各平台的覆盖不均,要说明这一点。**Reddit 没有关键词搜索,所以它的覆盖只取决于种子 subreddits——绝不要把 Reddit 呈现为穷尽式扫描。这里的 YouTube 不开放评论列表,所以 YouTube 信号仅为标题/描述/计数——绝不声称读过 YouTube 评论。
- 社区和社交来源会偏向强烈的观点和重度用户;按跨平台重叠加权,而非任何单一喧闹帖子,正如排名规则所强制的那样。
相关技能
- reddit-community-research(Social Listening Agent):深入一个主题背后的 subreddits——为某个细分映射出反复出现的问题、异议、语言和适合外联的帖子。
- customer-research(Content Strategy Agent):把简报中反复出现的抱怨和称赞转化为可复用的客户之声研究。
- unifapi:共享的数据技能——连接 MCP 并发现本简报所读取的 X / Reddit / YouTube / TikTok / Threads / News 操作。
源码:GitHub 上的 social-listening-brief/SKILL.md——可在那里提交 PR 来改进它。
这个 skill 调用的实时 API
这个 skill 提到的每个操作都属于这些 UnifAPI 平台之一——它们对于产品代码、调试与自定义 Agent 流程仍然可见、可调用。
- 每周简报
- 反复出现的主题
- 示例帖子
社媒监听 Agent 中的更多 skills
在同一个 Agent 中把它们串联起来,从一个决策成果走向下一个——每个都有各自的运行提示词、工作流与预期输出。