核心功能
Supermetrics 是营销数据整合领域的头部 SaaS 服务商，本技能为其官方 API 封装，允许用户通过自然语言直接查询100+营销平台的核心指标。
核心能力矩阵：
- 数据发现层：
discover_sources()列出全部数据源，discover_accounts()获取授权账号，discover_fields()枚举可用指标与维度 - 数据查询层：
query_data()支持异步任务调度，可配置日期范围、时区、多条件过滤（含正则匹配） - 结果获取层：
get_results()通过 schedule_id 轮询获取最终数据 - 辅助工具：
search()提供智能资源检索，health()监控服务状态
显著优点：
1. 平台覆盖度极广：单一接口统一接入 Meta、Google、Microsoft、LinkedIn 等主流广告生态，避免多 API 对接成本
2. 异步架构设计：大数据量查询不阻塞，符合生产环境稳定性要求
3. 字段级灵活性：支持 metrics/dimensions 自由组合，满足定制化报表需求
4. 企业级过滤语法：支持正则、包含、比较等多类操作符，复杂场景无需后处理
潜在局限与风险：
- 依赖外部 API 密钥：需自备
SUPERMETRICS_API_KEY，账号授权流程需人工在 Supermetrics 后台完成 - 异步轮询复杂度：
query_data仅返回 schedule_id，需二次调用get_results，对即时响应场景不够友好 - 数据新鲜度延迟：部分平台（如 Meta Ads）存在 API 数据延迟，实时性不如直接平台后台
- 成本不透明：Supermetrics 本身按数据源数量计费，高频查询可能产生额外 SaaS 费用
适合人群：
数字营销分析师、增长团队、广告代理商及需跨平台整合报表的数据工程师。特别适合已有 Supermetrics 订阅、需将营销数据自动化接入内部 BI 或 AI 工作流的企业用户。
常规风险提示：
- 需妥善保管 API Key，避免泄露导致数据账户被滥用
- 建议对
get_results设置超时重试机制，防止异步任务挂起 - 自定义日期范围时注意各平台时区差异，避免数据统计口径偏差