🚀 🏆 Audiense 需求 MCP 服务器
此服务器基于 Model Context Protocol (MCP)，允许 Claude 或任何其他 MCP 兼容客户端与您的 Audiense Demand 账户交互。它提供了创建和分析需求报告、跟踪实体性能以及在不同渠道和国家/地区获取见解的工具，为用户提供了高效便捷的需求分析体验。
🚀 快速开始
此 MCP 服务器需要一个授权使用 Audiense Demand 的 Audiense 账户，并与 Audiense Demand API 配合使用。根据您的背景和需求，我们提供两种不同的指南：
🌟 对业务用户和非开发人员
如果您主要对使用 Claude 或其他“MCP 兼容”工具与 Audiense Demand 工具交互感兴趣，且不需要了解技术细节，请按照我们的 用户指南 操作。此指南将帮助您：
- 快速安装必要的软件
- 设置 Claude Desktop
- 开始创建和分析需求报告
- 解决常见问题
🛠️ 对开发人员和技术用户
如果您是开发人员、希望贡献或需要了解技术实现，请按照我们的 开发人员指南 操作。此指南涵盖：
- 详细的安装步骤
- 项目架构
- 开发设置
- 高级配置
- API 文档
- 贡献指南
✨ 主要特性
- 基于 MCP 协议，实现了 Claude 等客户端与 Audiense Demand 账户的交互。
- 提供了丰富的工具，可用于创建和分析需求报告、跟踪实体性能以及获取多渠道和多地区的见解。
💻 使用示例
基础用法
以下是使用 create-demand-report 工具创建需求报告的示例：
# 假设这里有调用 create-demand-report 的代码
# 由于原文档未提供具体代码，这里仅作示例示意
# 需按照实际情况编写调用该工具的代码
高级用法
例如，使用 get-demand-report-summary-by-channels 工具按渠道汇总报告数据，并指定时间窗口和国家代码：
# 假设这里有调用 get-demand-report-summary-by-channels 的代码
# 由于原文档未提供具体代码，这里仅作示例示意
# 需按照实际情况编写调用该工具的代码
📚 详细文档
🛠️ 可用工具
📌 create-demand-report
描述：创建指定实体的新需求报告。
| 参数 | 详情 |
|---|---|
title |
报告的标题（字符串类型） |
entitiesReferences |
报告中的实体名称数组（字符串数组） |
userEmail |
创建报告的用户邮箱（字符串类型） |
| 响应：JSON 格式的报告创建详细信息。 |
📌 get-demand-reports
描述：检索属于已认证用户的 demand reports 列表。
| 参数 | 详情 |
|---|---|
paginationStart |
分页开始索引（数字类型，可选） |
paginationEnd |
分页结束索引（数字类型，可选） |
| 响应：JSON 格式的报告列表。 |
📌 get-demand-report-info
描述：获取特定需求报告的详细信息。
| 参数 | 详情 |
|---|---|
reportId |
要获取信息的报告 ID（字符串类型） |
| 响应：JSON 格式的完整报告详细信息。 |
📌 get-demand-report-summary-by-channels
描述：按渠道汇总报告数据。
| 参数 | 详情 |
|---|---|
reportId |
要分析的报告 ID（字符串类型） |
countryCode |
分析的国家代码（字符串数组，可选，默认为所有国家） |
timeWindow |
时间窗口，格式为“YYYY-MM-DD”（字符串，可选，默认过去一周） |
| 响应：JSON 格式的按渠道汇总的数据。 |
📌 get-demand-report-summary-by-countries
描述：按国家/地区汇总报告数据。
| 参数 | 详情 |
|---|---|
reportId |
要分析的报告 ID（字符串类型） |
channel |
分析的渠道（字符串数组，可选，默认为所有渠道） |
timeWindow |
时间窗口，格式为“YYYY-MM-DD”（字符串，可选，默认过去一周） |
| 响应：JSON 格式的按国家/地区汇总的数据。 |
📌 check-entities
描述：检查实体是否存在并获取其详细信息。
| 参数 | 详情 |
|---|---|
entities |
要检查的实体名称数组（字符串数组） |
| 响应：JSON 格式的实体状态信息。 |
📄 许可证
此项目在 Apache 2.0 许可证下。更多详细信息请参阅 LICENSE 文件。