mcp-audiense-demand

🚀 🏆 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 文件。