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 文檔
• 貢獻指南

✨ 主要特性

• 基於 Model Context Protocol (MCP)，實現與 Audiense Demand 賬戶的交互。
• 提供多種工具，用於創建和分析需求報告、跟蹤實體性能以及獲取不同渠道和國家/地區的見解。
• 針對不同用戶群體（業務用戶和開發人員）提供不同的指南。

📚 詳細文檔

🛠️ 可用工具

📌 create-demand-report

• 描述：創建指定實體的新需求報告。
• 參數：
  • title (string): 報告的標題
  • entitiesReferences (字符串數組): 報告中的實體名稱數組
  • userEmail (string): 創建報告的用戶郵箱
• 響應：JSON 格式的報告創建詳細信息

📌 get-demand-reports

• 描述：檢索屬於已認證用戶的 demand reports 列表。
• 參數：
  • paginationStart (number, 可選): 分頁開始索引
  • paginationEnd (number, 可選): 分頁結束索引
• 響應：JSON 格式的報告列表

📌 get-demand-report-info

• 描述：獲取特定需求報告的詳細信息。
• 參數：
  • reportId (string): 要獲取信息的報告 ID
• 響應：JSON 格式的完整報告詳細信息

📌 get-demand-report-summary-by-channels

• 描述：按渠道彙總報告數據。
• 參數：
  • reportId (string): 要分析的報告 ID
  • countryCode (字符串數組, 可選): 分析的國家代碼，默認為所有國家
  • timeWindow (字符串, 可選): 時間窗口，格式為“YYYY-MM-DD”，默認過去一週
• 響應：JSON 格式的按渠道彙總的數據

📌 get-demand-report-summary-by-countries

• 描述：按國家/地區彙總報告數據。
• 參數：
  • reportId (string): 要分析的報告 ID
  • channel (字符串數組, 可選): 分析的渠道，默認為所有渠道
  • timeWindow (字符串, 可選): 時間窗口，格式為“YYYY-MM-DD”，默認過去一週
• 響應：JSON 格式的按國家/地區彙總的數據

📌 check-entities

• 描述：檢查實體是否存在並獲取其詳細信息。
• 參數：
  • entities (字符串數組): 要檢查的實體名稱數組
• 響應：JSON 格式的實體狀態信息

📄 許可證

此項目在 Apache 2.0 許可證下。更多詳細信息請參閱 LICENSE 文件。