用途
Audiense Insights MCP Server 是一个基于 Model Context Protocol（MCP）的服务器，让 Claude 或任何其他兼容 MCP 的客户端能够与用户的 Audiense Insights 账户交互，从 Audiense 报告中提取营销洞察和受众分析，覆盖人口统计、文化、影响者及内容互动分析。
注意：该仓库已不再维护，Audiense Insights MCP 已迁移到远程模型。如需了解如何使用新的远程 MCP，可通过 support@audiense.com 联系。
前置条件
使用前需确保具备：
- Node.js（v18 或更高版本）
- Claude Desktop App
- 拥有 API 凭据的 Audiense Insights 账户
- X/Twitter API Bearer Token（可选，用于丰富影响者数据）
配置 Claude Desktop
打开 Claude Desktop 的配置文件：
- macOS：code ~/Library/Application\ Support/Claude/claude_desktop_config.json
- Windows：code %AppData%\Claude\claude_desktop_config.json
添加或更新以下配置： "mcpServers": { "audiense-insights": { "command": "npx", "args": [ "-y", "mcp-audiense-insights" ], "env": { "AUDIENSE_CLIENT_ID": "your_client_id_here", "AUDIENSE_CLIENT_SECRET": "your_client_secret_here", "TWITTER_BEARER_TOKEN": "your_token_here" } } }
保存文件并重启 Claude Desktop。
可用工具
- get-reports：获取已认证用户拥有的 Audiense 洞察报告列表。无参数，返回 JSON 格式的报告列表。
- get-report-info：获取特定情报报告的详细信息，包括细分类型等。参数为 report_id（字符串）；返回 JSON 格式的完整报告详情，若报告仍在处理中则返回待处理状态信息。
- get-audience-insights：获取给定受众的聚合洞察，包括人口统计（性别、年龄、国家）、行为特征（活跃时段、平台使用）、心理特征（个性特质、兴趣）、社会经济因素（收入、教育状况）。参数为 audience_insights_id（字符串）与可选的 insights（字符串数组，用于筛选特定洞察名称）；返回结构化的文本列表格式洞察。
- get-baselines：获取可用的基线受众，可按国家筛选。参数为可选的 country（ISO 国家代码）；返回 JSON 格式的基线受众列表。
- get-categories：获取可用于影响者比较的可用亲和类别列表。返回 JSON 格式的类别列表。
- compare-audience-influencers：将给定受众的影响者与基线受众比较。基线判定方式：若单一国家占受众超过 50%，则使用该国家为基线；否则使用全球基线；若选择了特定细分，则使用完整受众为基线。每个影响者比较包含亲和度（%）、基线亲和度（%）、独特性得分。参数包括 audience_influencers_id、baseline_audience_influencers_id、可选的 cursor、count（默认 200）、bio_keyword、entity_type（person | brand）、followers_min、followers_max、categories、countries；返回包含亲和分、基线比较与独特性得分的 JSON 格式影响者列表。
- get-audience-content：获取受众内容互动详情，包括点赞内容（最受欢迎帖子、域名、表情、话题标签、链接、媒体及词云）、分享内容（分类方式类似）、影响力内容（来自有影响力账户的内容）。响应参数为 audience_content_id（字符串）；返回 JSON 格式的内容互动数据。
- report-summary：生成 Audiense 报告的综合摘要，包括报告元数据（标题、细分类型）、完整受众规模、详细细分信息、每个细分的顶级洞察（简介关键词、人口统计、兴趣）、每个细分的顶级影响者及比较指标。参数为 report_id（字符串）；返回 JSON 格式的完整报告摘要。处理中的报告返回处理中状态信息；无细分的报告返回无细分可分析的信息。
预定义提示
该服务器包含预配置提示：
- audiense-demo：帮助以交互方式分析 Audiense 报告。
- segment-matching：用于跨 Audiense 报告匹配和比较受众细分，基于人口统计、兴趣、影响者和互动模式识别相似性、独特特征和关键洞察。接受 reportName 参数以查找最相关报告；若提供 ID 则按报告 ID 搜索。用于受众分析的结构化指导。
故障排查
- Claude 中不显示工具：检查 Claude Desktop 日志；验证环境变量正确设置；确保 index.js 的绝对路径正确。
- 认证问题：仔细检查 OAuth 凭据；确保刷新令牌仍然有效；验证所需 API 范围已启用。
- 在 macOS/Linux 上查看服务器日志。
安全注意事项
- 妥善保管 API 凭据——切勿在公共仓库中暴露。
- 使用环境变量管理敏感数据。
许可
本项目采用 Apache 2.0 许可证，详见 LICENSE 文件。
