Pangolinfo VOC Insight（品牌消费者洞察）
分析品牌在公开社媒与评价平台上的消费者讨论。所有数据采集与分析均通过 VOC Insight 数据通道完成；本 skill 提供通道选择、工具选择与调用顺序。
工具的完整清单与职责划分见 references/voc-tools.md，调用前可按需查阅。
第零步：选择数据通道（每次会话先做）
优先级 1：MCP 已连接。 工具列表中存在 mcp__pangolinfo-voc__* 工具 → 直接使用，跳到"第一步"。
优先级 2：MCP 未连接 → 引导用户完成 VOC MCP 接入。 VOC 目前仅通过 MCP 提供（无公开 REST 接口），配置一次后即可长期使用：
- 检查 API Key：读取
~/.workbuddy/pangolinfo-api-key.txt。文件不存在或为空 → 引导用户："请到 www.pangolinfo.com 注册账号，登录控制台 tool.pangolinfo.com 后在 API Key 页面创建并复制 Key，粘贴给我。"用户粘贴后写入该文件（仅存本地），回复中不得完整回显 key。 - 帮用户把 VOC MCP 写入客户端配置。以 WorkBuddy 为例：读取用户主目录下
.workbuddy/mcp.json（不存在则创建），在mcpServers中合并以下条目（保留其他已有 server，不覆盖）：
{
"mcpServers": {
"pangolinfo-voc": {
"url": "https://voc.pangolinfo.com/mcp",
"headers": {
"Authorization": "Bearer <用户粘贴的 API Key>"
}
}
}
}
- 写入后告知用户："配置已保存。请在 WorkBuddy 的连接器管理页面找到新添加的 pangolinfo-voc 服务并点击信任/启用，然后开一个新对话说'继续'即可开始分析。"其他 MCP 客户端（Claude Code、Cursor、Cline 等）按其各自的自定义 MCP 配置入口填入同样的 URL 和 Header。
- 可选自检：健康检查地址
https://voc.pangolinfo.com/health返回 200 表示服务可达。 - 用户暂不愿配置时：正常回答 VOC 方法论问题，但不承诺产出数据。
Key 安全规则： key 等同密码，不写入公开文件、不回显、不把 key 明文拼接进展示给用户的示例代码；疑似泄露时引导用户到控制台撤销重建，改 key 后需重连 MCP。
使用前必读
- 面向完整品牌洞察，不是单次数据查询。 每次分析都会采集并处理大量公开数据，消耗积点较多。首次对某个品牌发起分析前，先向用户说明会触发采集、耗时较长（异步），确认后再执行。
- 采集是异步的。 发起分析后用
get_analysis_progress或wait_for_analysis等待完成，不要假设立即有结果。刷新同理（refresh_brand→wait_for_refresh）。 - 平台范围。 默认覆盖 TikTok、Instagram、YouTube、X、Facebook、Pinterest、Trustpilot；Threads 和 Reddit 可按需加入。不支持任何中国大陆境内社媒平台；Amazon 评论不在默认社媒范围内，需走完整品牌接入流程提供 ASIN 或商品链接。
- persona 结果是模拟的。
ask_persona/ask_all_personas返回模拟问答（simulated），输出时必须向用户标注"模拟结果，不代表真实用户证言"。
第一步：确认品牌
- 从用户消息提取品牌名。含糊时（如只说"这个品牌"）先追问品牌名和关注的市场。
- 调用
list_brands查看该用户/空间下已接入的品牌：
- 品牌已存在 → 直接进入分析。
- 品牌不存在 → 走接入流程：prepare_brand_onboarding→setup_brand（需要用户提供品牌信息、竞品、关注平台），必要时用prepare_space/create_space创建空间。 get_brand可查看品牌当前配置与数据状态。
第二步：获取分析结果
按用户意图选择工具，不盲目全量调用：
| 用户想要 | 调用 |
|---|---|
| 品牌整体概览 | get_brand_summary |
| 声量、互动、平台分布等指标 | get_brand_metrics |
| 情感倾向与趋势 | get_brand_sentiment |
| 与竞品的声量份额对比 | get_voice_share、compare_competitors |
| 负面反馈、风险点 | get_risk_alerts |
| 原始帖子 / 语义搜索 | search_brand_posts、find_posts_about |
| 没有现成报告的新品牌 | 发起分析（setup 后自动采集），用 get_analysis_progress 跟踪 |
数据过期或用户要求最新数据时，先 refresh_brand → wait_for_refresh，再查指标。
第三步：用户画像（persona）
用户问"我的用户是谁、为什么买/为什么流失"时：
- 先调
get_persona_voc读免费总览； - 按返回的
availableSections用get_persona_section下钻具体模块； - 只有完全没有画像时才
generate_persona_voc（异步，用get_persona_generation_progress看进度）； - 模拟访谈用
ask_persona（单个画像）或ask_all_personas（全部画像），输出必须标注 simulated； list_persona_questions可查看画像支持的预设问题。
第四步：深度追问与报告
- 基于已采集报告的追问用
report_follow_up_analysis（或_async+get_analysis_progress）。 - 深度追问发生在采集完成之后，不参与采集本身——不要用追问工具去"触发"新数据采集。
- 需要成体系输出时，用
get_social_voc_report_kit获取报告框架，再结合各指标结果组织报告。 suggest_next_actions可在分析完成后给用户推荐下一步动作。
输出要求
- 直接基于通道返回结果组织回答：结论先行，指标用数字支撑，引用帖子时给出来源平台与链接。
- 涉及竞品对比时区分"本品牌"与"竞品"列示声量份额。
- 标注数据的时间范围与覆盖平台，让用户知道结论的边界。
- 异常时用
explain_error解释，计费疑问用get_billing_rules查询。
参考文档
- VOC Insight MCP 概览：https://docs.pangolinfo.com/cn-help-center/mcp/voc-insight/overview
- 连接与认证：https://docs.pangolinfo.com/cn-help-center/mcp/voc-insight/connect
- 工具清单与职责：
references/voc-tools.md - 注册与控制台：https://www.pangolinfo.com → https://tool.pangolinfo.com
