Audiense Insights MCP Server

🏆 Audiense Insights MCP 服务器

该服务器基于模型上下文协议 (MCP) ，允许Claude或任何其他兼容 MCP 的客户端与您的Audiense Insights帐户进行交互。它从 Audiense 报告中提取营销洞察和受众分析，涵盖人口统计、文化、影响者和内容参与度分析。

🚀 先决条件

在使用此服务器之前，请确保您已：

• Node.js （v18 或更高版本）
• 克劳德桌面应用程序
• 具有 API 凭据的Audiense Insights 帐户
• X/Twitter API Bearer Token （可选，用于丰富影响者数据）

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Audiense Insights Server：

⚙️ 配置 Claude 桌面

1. 打开Claude Desktop的配置文件：
   • MacOS：
     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • 视窗：
     code %AppData%\Claude\claude_desktop_config.json
2. 添加或更新以下配置：
   "mcpServers": { "audiense-insights": { "command": "/opt/homebrew/bin/node", "args": [ "/ABSOLUTE/PATH/TO/YOUR/build/index.js" ], "env": { "AUDIENSE_CLIENT_ID": "your_client_id_here", "AUDIENSE_CLIENT_SECRET": "your_client_secret_here", "TWITTER_BEARER_TOKEN": "your_token_here" } } }
3. 保存文件并重新启动 Claude Desktop。

🛠️ 可用工具

📌 get-reports

描述：检索经过身份验证的用户拥有的Audiense 洞察报告列表。

• 参数：无
• 回复：
  • JSON 格式的报告列表。

📌 get-report-info

描述：获取有关特定情报报告的详细信息，包括：

• 地位
• 分割类型
• 观众规模
• 段
• 访问链接
• 参数：
  • report_id(字符串) ：情报报告的ID。
• 回复：
  • JSON 格式的完整报告详细信息。
  • 如果报告仍在处理中，则返回一条指示待处理状态的消息。

📌 get-audience-insights

描述：检索给定受众的汇总见解，包括：

• 人口统计：性别、年龄、国家。
• 行为特征：活跃时间、平台使用情况。
• 心理特征：性格特征、兴趣。
• 社会经济因素：收入、教育状况。
• 参数：
  • audience_insights_id(string) ：受众洞察的 ID。
  • insights（字符串数组，可选） ：要过滤的特定洞察名称列表。
• 回复：
  • 格式化为结构化文本列表的见解。

📌 get-baselines

描述：检索可用的基准受众，可选择按国家/地区进行过滤。

• 参数：
  • country（字符串，可选） ：用于过滤的 ISO 国家代码。
• 回复：
  • JSON 格式的基线受众列表。

📌 get-categories

描述：检索可用于影响者比较的亲和力类别列表。

• 参数：无
• 回复：
  • JSON 格式的类别列表。

📌 compare-audience-influencers

描述：将给定受众群体的影响者与基线受众群体进行比较。基线确定方法如下：

• 如果某个国家/地区的观众人数超过 50%，则以该国/地区为基准。
• 否则，使用全局基线。
• 如果选择了特定的部分，则将整个受众群体作为基线。

每个影响者比较包括：

• 亲和力（%） ——影响者与受众的契合程度。
• 基线亲和力 (%) – 影响者在基线受众中的亲和力。
• 独特性得分——影响者与基线相比的独特程度。
• 参数：
  • audience_influencers_id(string) ：受众影响者的 ID。
  • baseline_audience_influencers_id(字符串) ：基线受众影响者的 ID。
  • cursor（数字，可选） ：分页光标。
  • count（数字，可选） ：每页的项目数（默认值：200）。
  • bio_keyword（字符串，可选） ：通过bio 关键字过滤影响者。
  • entity_type（枚举： person | brand ，可选） ：按实体类型过滤。
  • followers_min（数字，可选） ：关注者的最小数量。
  • followers_max(数字，可选) ：关注者的最大数量。
  • categories（字符串数组，可选） ：按类别过滤影响者。
  • countries（字符串数组，可选） ：按国家 ISO 代码过滤影响者。
• 回复：
  • 具有亲和力分数、基线比较和独特性分数的影响者列表（JSON 格式）。

📌 get-audience-content

描述：检索受众内容参与详情，包括：

• 喜欢的内容：最受欢迎的帖子、域名、表情符号、主题标签、链接、媒体和词云。
• 共享内容：大多数共享内容按类似方式分类。
• 有影响力的内容：来自有影响力的账户的内容。

每个类别包含：

• popularPost ：参与度最高的帖子。
• topDomains ：提及次数最多的域名。
• topEmojis ：最常用的表情符号。
• topHashtags ：最常用的主题标签。
• topLinks ：最多人分享的链接。
• topMedia ：共享媒体。
• wordcloud ：最常用的单词。
• 参数：
  • audience_content_id(string) ：受众内容的 ID。
• 回复：
  • JSON 格式的内容参与度数据。

📌 report-summary

描述：生成 Audiense 报告的综合摘要，包括：

• 报告元数据（标题、分段类型）
• 全部观众人数
• 详细分部信息
• 每个细分市场的热门见解（个人简介关键词、人口统计、兴趣）
• 各细分市场最具影响力人物及比较指标
• 参数：
  • report_id(字符串) ：要汇总的情报报告的 ID。
• 回复：
  • 完整的报告摘要采用 JSON 格式，包含每个部分的结构化数据
  • 对于待处理报告：状态消息表明报告仍在处理中
  • 对于没有细分的报告：指示没有可供分析的细分的消息

💡 预定义提示

该服务器包含预配置的提示

• audiense-demo ：帮助以交互方式分析 Audiense 报告。
• segment-matching ：提示匹配和比较 Audiense 报告中的受众细分，根据人口统计、兴趣、影响者和参与模式识别相似性、独特特征和关键见解。

用法：

• 接受 reportName 参数来查找最相关的报告。
• 如果提供了 ID，则它会按报告 ID 进行搜索。

用例：受众分析的结构化指导。

🛠️ 故障排除

Claude 中未出现的工具

1. 检查 Claude Desktop 日志：

2. 验证环境变量是否设置正确。
3. 确保index.js的绝对路径正确。

身份验证问题

• 仔细检查 OAuth 凭证。
• 确保刷新令牌仍然有效。
• 验证所需的 API 范围是否已启用。

📜 查看日志

要检查服务器日志：

对于 MacOS/Linux：

对于 Windows：

🔐 安全注意事项

• 确保 API 凭证的安全 - 切勿在公共存储库中暴露它们。
• 使用环境变量来管理敏感数据。

📄 许可证

本项目遵循 Apache 2.0 许可证。更多详情请参阅许可证文件。