简介

允许 Claude 或其他与 MCP 兼容的客户端与 Audiense Insights 账户交互，提取涵盖人口统计、文化数据、影响者信息和内容参与模式的营销洞察和受众分析。

简介

允许 Claude 或其他与 MCP 兼容的客户端与 Audiense Insights 账户交互，提取涵盖人口统计、文化数据、影响者信息和内容参与模式的营销洞察和受众分析。

🏆 Audiense Insights MCP Server

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

---

🚀 先决条件

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

• Node.js（版本 18 或更高）
• Claude 桌面应用程序
• Audiense Insights 账户 及其 API 凭证
• X/Twitter API Bearer Token （可选，用于丰富的影响者数据）

---

通过 Smithery 安装

要通过 Smithery 自动为 Claude 桌面应用程序安装 Audiense Insights 服务器：

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 洞察报告 列表。

• 参数: 无
• 响应:
  • 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文件。

来源

• 来源：github
• 链接：https://github.com/audienseco/mcp-audiense-insights