AI导哈

受众分析服务

基于模型上下文协议（MCP）的服务，用于从Audiense Insights报告中提取营销洞察和受众分析，包括人口统计、文化、影响者和内容参与分析。

  • by AudienseCo
  • TypeScript
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 AudienseCo/mcp-audiense-insights

使用说明

⚠️ 已弃用

🚫 此存储库不再维护。

Audiense Insights MCP已迁移到远程模型。有关如何使用新的远程MCP的更多信息，请通过以下方式联系我们 support@audiense.com.

🏆 Audiense Insights MCP服务器

此服务器基于 模型上下文协议（MCP），允许 克劳德 或任何其他MCP兼容客户端与您的 受众洞察 账户它提取 营销洞察力和受众分析 来自Audiense报告，涵盖 人口统计、文化、影响者和内容参与度分析.

🚀 先决条件

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

  • Node.js （v18或更高版本）
  • Claude桌面应用程序
  • Audiense洞察账户 具有API证书
  • X/Twitter API承载令牌 （可选，用于丰富影响者数据）

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

🛠️ 可用工具

📌 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

描述：比较 网红 给定的观众与 基线受众基线确定如下：

  • 如果a 单一国家 代表了50%以上的观众，该国家被用作基线。
  • 否则 全球基线 使用。
  • 如果a 特定细分市场 选择时，将全部观众用作基线。

每个影响者比较包括：

  • 亲和力（%） –影响者与观众的契合度如何。

  • 基线亲和力（%） –影响者在基线受众中的亲和力。

  • 独特性分数 -与基线相比，影响者有多明显。

  • 参数:

    • audience_influencers_id （字符串）：观众影响者的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 （字符串）：受众内容的ID。

  • 响应:

    • JSON格式的内容参与数据。

📌 report-summary

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

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

  • 完整观众规模

  • 细分市场详细信息

  • 顶级见解 针对每个细分市场（生物关键词、人口统计、兴趣）

  • 顶级影响力人物 对于每个具有比较指标的细分市场

  • 参数:

    • report_id （字符串）：要汇总的情报报告的ID。

  • 响应:

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

💡 预定义提示

此服务器包括预配置的提示

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

用途：

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

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

🛠️ 故障排除

工具未出现在Claude中

  1. 检查克劳德桌面日志：
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文件。

相关 MCP