Audiense Insights MCP Server 使用说明

项目简介

Audiense Insights MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接 MCP 客户端（如 Claude）与 Audiense Insights 平台。通过此服务器，用户可以直接在 Claude 等 LLM 应用中，利用 Audiense Insights 强大的社交数据分析能力，获取营销洞察和受众分析报告。服务器提供了一系列工具，方便用户检索报告列表、获取报告详情、分析受众特征、比较受众影响者以及挖掘内容互动数据。

主要功能点

报告管理: 检索和查看 Audiense Insights 报告列表及详细信息。
受众洞察: 获取受众的人口统计、行为特征、兴趣偏好等深层洞察数据。
影响者分析: 对比受众与基准受众的影响者，评估影响者的关联度和独特性。
内容互动分析: 挖掘受众喜欢和分享的内容，包括热门帖子、话题标签、链接等。
报告总结: 生成 Audiense 报告的综合摘要，快速把握报告核心内容。
预置Prompt: 提供预定义的 Prompt 模板，如 'audiense-demo' 和 'segment-matching'，引导用户进行结构化分析。

安装步骤

环境准备: 确保已安装 Node.js (v18 或更高版本) 和 Claude Desktop App。
获取凭据: 拥有 Audiense Insights 账户并获取 API 密钥 (Client ID 和 Client Secret)。可选配置 X/Twitter API Bearer Token 以丰富影响者数据。

使用 Smithery 安装 (推荐): 执行以下命令，通过 Smithery CLI 自动安装 Audiense Insights Server for Claude Desktop：

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

服务器配置 (Claude Desktop)

打开 Claude Desktop 的配置文件 'claude_desktop_config.json'，根据操作系统选择对应路径进行编辑：

MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
Windows: '%AppData%\Claude\claude_desktop_config.json'

在 'mcpServers' 字段中添加或更新 'audiense-insights' 的配置。注意: '/ABSOLUTE/PATH/TO/YOUR/build/index.js' 需要替换为服务器构建后 'index.js' 文件的绝对路径。如果您手动安装而非使用 Smithery，则需要在克隆仓库后自行构建项目。

"mcpServers": {
  "audiense-insights": {
    "command": "/opt/homebrew/bin/node",
    "args": [
      "/ABSOLUTE/PATH/TO/YOUR/build/index.js"  // 替换为 index.js 的绝对路径
    ],
    "env": {
      "AUDIENSE_CLIENT_ID": "your_client_id_here",     // 您的 Audiense Client ID
      "AUDIENSE_CLIENT_SECRET": "your_client_secret_here", // 您的 Audiense Client Secret
      "TWITTER_BEARER_TOKEN": "your_token_here"        // 可选: 您的 Twitter API Bearer Token (用于增强影响者数据)
    }
  }
}

保存配置文件并重启 Claude Desktop 应用。

基本使用方法

配置完成后，在 Claude Desktop 中，您可以通过以下方式使用 Audiense Insights MCP Server：

在 Claude 的对话框中: 您可以直接提及想要分析的 Audiense 报告名称或 ID，例如 "分析名为 'Nike Audience Report' 的报告"。
使用预置 Prompt: 在 Claude 的 "附件" 或 "工具" 菜单中，选择 "audiense-demo" 或 "segment-matching" 等预置 Prompt，并按照 Prompt 的指示操作，输入报告名称或品牌名称等参数，即可开始结构化分析。
调用工具: 在 Claude 中，您可以指示 Claude 调用服务器提供的工具，例如 "使用 'get-reports' 工具列出所有报告"，或 "使用 'get-report-info' 工具获取报告 ID 为 'report-123' 的详细信息"。

具体工具和 Prompt 的使用方法和参数说明，请参考仓库的 README 文档或工具的描述信息。

通过 Audiense Insights MCP Server，您可以方便地在 Claude 中利用 Audiense Insights 的数据分析能力，进行深入的市场洞察和受众理解，辅助营销决策。

关键词