🏆 Audiense Insights MCP 服务器

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

<a href="https://glama.ai/mcp/servers/xz11vmv38c"> <img width="380" height="200" src="https://glama.ai/mcp/servers/xz11vmv38c/badge" /></a>

---

🚀 前提条件

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

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

---

通过 Smithery 安装

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

npx -y @smithery/cli@latest install @AudienseCo/mcp-audiense-insights --client claude

⚙️ 配置 Claude 桌面

1. 打开 Claude 桌面的配置文件：

   • MacOS:

     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
     

   • Windows:

     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 桌面。

🛠️ 可用工具

📌 get-reports

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

• 参数: 无
• 响应:
  • JSON 格式的报告列表。

---

📌 get-report-info

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

• 状态

• 分段类型

• 受众规模

• 分段

• 访问链接

• 参数:

  • report_id (字符串): 情报报告的 ID。

• 响应:

  • JSON 格式的完整报告详细信息。
  • 如果报告仍在处理中，则返回一条消息，指示待处理状态。

---

📌 get-audience-insights

描述: 检索给定受众的聚合洞察，包括：

• 人口统计: 性别、年龄、国家/地区。

• 行为特征: 活跃时间、平台使用情况。

• 心理统计: 性格特征、兴趣。

• 社会经济因素: 收入、教育程度。

• 参数:

  • audience_insights_id (字符串): 受众洞察的 ID。
  • insights (字符串数组，可选): 要过滤的特定洞察名称列表。

• 响应:

  • 格式化为结构化文本列表的洞察。

---

📌 get-baselines

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

• 参数:

  • country (字符串，可选): 用于过滤的 ISO 国家/地区代码。

• 响应:

  • JSON 格式的基准受众列表。

---

📌 get-categories

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

• 参数: 无
• 响应:
  • JSON 格式的类别列表。

---

📌 compare-audience-influencers

描述: 将给定受众的影响者与基准受众进行比较。基准确定如下：

• 如果单个国家/地区占受众的 50% 以上，则该国家/地区用作基准。
• 否则，使用全球基准。
• 如果选择了特定分段，则使用完整受众作为基准。

每个影响者比较包括：

• 亲和力 (%) – 影响者与受众的匹配程度。

• 基准亲和力 (%) – 影响者在基准受众中的亲和力。

• 独特性得分 – 与基准相比，影响者的独特性。

• 参数:

  • audience_influencers_id (字符串): 受众影响者的 ID。
  • baseline_audience_influencers_id (字符串): 基准受众影响者的 ID。
  • cursor (数字，可选): 分页游标。
  • count (数字，可选): 每页的项目数（默认值：200）。
  • bio_keyword (字符串，可选): 按个人简介关键字过滤影响者。
  • 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 (字符串): 受众内容的 ID。

• 响应:

  • JSON 格式的内容互动数据。

---

📌 report-summary

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

• 报告元数据（标题、分段类型）

• 完整受众规模

• 详细的分段信息

• 每个分段的热门洞察（个人简介关键字、人口统计、兴趣）

• 每个分段的热门影响者，带有比较指标

• 参数:

  • report_id (字符串): 要汇总的情报报告的 ID。

• 响应:

  • JSON 格式的完整报告摘要，其中包含每个分段的结构化数据
  • 对于待处理的报告：指示报告仍在处理中的状态消息
  • 对于没有分段的报告：指示没有要分析的分段的消息

💡 预定义提示

此服务器包含一个预配置的提示

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

用法:

• 接受 reportName 参数以查找最相关的报告。
• 如果提供了 ID，则改为按报告 ID 搜索。

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

🛠️ 故障排除

工具未出现在 Claude 中

1. 检查 Claude 桌面日志：

tail -f ~/Library/Logs/Claude/mcp*.log

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

身份验证问题

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

📜 查看日志

要检查服务器日志：

对于 MacOS/Linux：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

对于 Windows：

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

🔐 安全注意事项

• 确保 API 凭据安全 – 永远不要在公共存储库中公开它们。
• 使用环境变量来管理敏感数据。

📄 许可证

本项目根据 Apache 2.0 许可证获得许可。有关更多详细信息，请参阅 LICENSE 文件。