⚠️ 已弃用
🚫 此存储库不再维护。
Audiense Insights MCP已迁移到远程模型。有关如何使用新的远程MCP的更多信息，请通过以下方式联系我们 support@audiense.com.
______________________________________________________________________
______________________________________________________________________
🏆 Audiense Insights MCP服务器
🚀 先决条件
在使用此服务器之前，请确保您已：
- Node.js （v18或更高版本）
- Claude桌面应用程序
- Audiense洞察账户 具有API证书
- X/Twitter API承载令牌 _（可选，用于丰富影响者数据）_
______________________________________________________________________
⚙️ 配置Claude桌面
- 打开Claude Desktop的配置文件：
- MacOS：
code ~/Library/Application\ Support/Claude/claude_desktop_config.json- 窗户：
code %AppData%\Claude\claude_desktop_config.json- 添加或更新以下配置：
"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"
}
}
}
- 保存文件并重新启动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中
- 检查克劳德桌面日志：
tail -f ~/Library/Logs/Claude/mcp*.log- 验证环境变量是否设置正确。
- 确保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文件。
