星战科技xingzhan.cloud
返回市场
MCP-受众洞察服务器

MCP-受众洞察服务器

作者：AudienseCo17 星标更新：2025-06-16
安装使用来源：spider==github.com

项目介绍

⚠️ 已弃用

🚫 本仓库不再维护。

Audiense Insights MCP 已迁移到远程模型。如需了解如何使用新的远程 MCP，请联系我们 support@audiense.com。

🏆 Audiense Insights MCP 服务器

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

🚀 先决条件

在使用此服务器之前，请确保您拥有以下内容：

  • Node.js (v18 或更高版本)
  • Claude 桌面应用
  • 带有 API 凭据的 Audiense Insights 账户
  • X/Twitter API 访问令牌 (可选，用于增强的影响者数据)

⚙️ 配置 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": "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"
    }          
  }     
}

  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 (数字，可选): 每页项目数（默认：2_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
  1. 验证环境变量是否设置正确。
  2. 确保 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 文件获取更多详情。