mcpField
W
windsor-ai-business-data

windsor-ai-business-data

github.com/cline数据与数据库40883 次安装15 周前更新
代码仓库

关于 windsor-ai-business-data

通过 Windsor.ai 连接器获取业务数据的技能，适用于构建仪表板、报告或集成的开发者和分析人员。工作流程涵盖连接器发现、字段探索、元数据查询和数据检索。

主要功能

  1. 01通过 325 多个连接器访问数据
  2. 02发现已连接平台与账户
  3. 03探索字段和查询选项
  4. 04查看字段元数据
  5. 05按日期范围检索筛选数据

适用场景

  1. 01为仪表板和报告准备数据
  2. 02分析广告与营销活动指标
  3. 03将 CRM 或电商数据载入代码
  4. 04用真实数据填充原型

MCP 相关

Windsor.ai 提供四种 MCP 工具：get_connectors、get_options、get_fields 和 get_data，用于发现账户与字段、查看架构以及检索业务数据。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cline/skills --skill windsor-ai-business-data

安装后在 Claude Code 中输入/windsor-ai-business-data确认已加载。

详细介绍

Windsor.ai 业务数据技能

当用户需要业务数据时，请使用此技能，包括营销分析、销售指标、CRM 数据、电商交易、财务数据，或 Windsor.ai 的 325 多个连接器提供的任何其他数据。

使用场景

  • 用户正在构建仪表板、报告或数据可视化，需要来自任意来源的业务数据
  • 用户询问广告支出、营销活动表现、ROAS、CTR、CPC 或转化指标
  • 用户需要在其代码库中使用 CRM、销售、电商或财务数据
  • 用户需要了解有哪些数据源或字段可用
  • 用户希望使用真实数据填充项目（例如用于测试、原型开发或生成测试数据）
  • 用户正在构建与 Windsor.ai 支持的任意平台的集成

可用工具

Windsor.ai 提供 4 个 MCP 工具：

get_connectors

列出所有已连接的平台及其账号 ID。如果不清楚有哪些账号可用，请务必先调用此工具。

get_options

返回特定连接器可用的字段、日期筛选条件和选项。在调用 get_data 前，用它来查明可以查询哪些数据。

参数：

  • connector（必填）：平台 ID，例如 "google_ads"、"facebook"、"tiktok"、"linkedin"、"googleanalytics4"、"hubspot"、"salesforce"、"searchconsole"、"instagram"、"youtube"、"google_my_business"、"shopify"、"stripe"、"quickbooks" 等 300 多个
  • accounts（必填）：来自 get_connectors 的账号 ID 列表
get_fields

返回特定字段的详细元数据，包括数据类型、说明和可用值。在编写处理数据的代码之前，如果需要了解架构，请使用此工具。

参数：

  • connector（必填）：平台 ID
  • fields（必填）：字段 ID 列表，例如 ["campaign", "spend", "clicks"]
get_data

检索实际数据。这是主要的查询工具。

参数：

  • connector（必填）：平台 ID
  • accounts（必填）：账号 ID 列表
  • fields（必填）：要检索的字段，例如 ["campaign", "date", "spend", "clicks", "impressions"]
  • date_from / date_to：日期范围，格式为 "YYYY-MM-DD"
  • date_preset：快捷选项，例如 "last_7d"、"last_30d"、"this_month"、"last_3m"
  • filters：筛选条件，例如 [["spend", "gt", 100], "and", ["campaign", "contains", "Sale"]]
  • options：连接器专属选项，例如 {"attribution_window": "7d_view,1d_click"}

工作流模式

  1. 发现 → 调用 get_connectors，查看已连接的内容
  2. 探索 → 调用 get_options，查看连接器的可用字段
  3. 了解 → 如果要构建类型化接口，则调用 get_fields 获取字段元数据
  4. 查询 → 调用 get_data，提取实际数据

常见字段模式

字段因连接器类型而异。以下是一些常见示例：

营销/广告连接器： campaign、adgroup、ad、date、device、country、spend、clicks、impressions、conversions、revenue、ctr、cpc、cpm、roas

CRM 连接器： deal、contact、company、stage、owner、amount、close_date

电商连接器： order_id、product、quantity、price、customer、status

请务必先检查 get_options，因为可用字段因连接器而异。

提示

  • 构建仪表板或图表时，使用 get_data 提取数据，并将其写入应用可读取的本地 JSON/CSV 文件
  • 对于 TypeScript 项目，使用 get_fields 生成准确的类型定义
  • 使用 date_preset 快速查询："last_7d"、"last_30d"、"this_month"
  • 组合筛选条件以聚焦查询：[["spend", "gt", 0], "and", ["campaign", "ncontains", "test"]]
  • 可以合并来自不同连接器的数据（例如广告支出和 CRM 收入）：分别从各连接器提取数据，再在代码中合并

评论

支持 Markdown