Skip to content

用于 ADK 的 Supermetrics MCP 工具

Supported in ADKPythonTypeScript

Supermetrics MCP 服务器将你的 ADK 智能体连接到 Supermetrics 平台，使其能够访问涵盖 100+ 数据源的营销数据，包括 Google Ads、Meta Ads、LinkedIn Ads 和 Google Analytics 4。你的智能体可以使用自然语言发现数据源、探索可用指标，并针对你已连接的账户运行查询。

使用场景

  • 营销绩效报告：查询各广告系列和时间段的展示次数、点击次数、支出和转化次数。构建自动报告，在单个响应中聚合来自多个平台的数据。

  • 跨平台分析：使用一致的查询接口，在 Google Ads、Meta Ads、LinkedIn Ads 和其他渠道之间进行并排对比分析，不受底层平台限制。

  • 广告系列监控：检索活跃广告系列和广告帐户的最新指标，使智能体能够发现异常、跟踪预算执行情况或汇总每日绩效。

  • 数据探索：在构建查询之前发现用户可用的数据源、账户和字段，使智能体能够动态适应每个用户连接的集成。

前置条件

与智能体配合使用

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset, StreamableHTTPConnectionParams

SUPERMETRICS_API_KEY = "YOUR_SUPERMETRICS_API_KEY"

root_agent = Agent(
    model="gemini-flash-latest",
    name="supermetrics_agent",
    instruction="帮助用户从 Supermetrics 查询和分析营销数据",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mcp.supermetrics.com/mcp",
                headers={
                    "Authorization": f"Bearer {SUPERMETRICS_API_KEY}",
                },
            ),
        )
    ],
)

import { LlmAgent, MCPToolset } from "@google/adk";

const SUPERMETRICS_API_KEY = "YOUR_SUPERMETRICS_API_KEY";

const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "supermetrics_agent",
    instruction: "帮助用户从 Supermetrics 查询和分析营销数据",
    tools: [
        new MCPToolset({
            type: "StreamableHTTPConnectionParams",
            url: "https://mcp.supermetrics.com/mcp",
            transportOptions: {
                requestInit: {
                    headers: {
                        Authorization: `Bearer ${SUPERMETRICS_API_KEY}`,
                    },
                },
            },
        }),
    ],
});

export { rootAgent };

查询工作流

数据检索遵循多步工作流：收到用户请求后，首先使用 get_today 获取当前日期。然后使用 data_source_discovery 发现数据源，使用 accounts_discovery 查找已连接的账户，使用 field_discovery 检查可用字段，使用 data_query 提交查询，然后使用返回的 schedule_id 轮询 get_async_query_results，直到结果就绪。

可用工具

工具 描述
data_source_discovery 列出可用的营销数据源（Google Ads、Meta Ads 等）及其 ID
accounts_discovery 发现特定数据源下已连接的账户
field_discovery 探索数据源的可用指标和维度
data_query 提交数据查询；返回一个用于异步结果检索的 schedule_id
get_async_query_results 通过 schedule_id 轮询并检索已提交查询的结果
user_info 检索已验证用户的个人资料、团队信息和许可状态
get_today 获取适合查询日期范围参数的当前日期格式

其他资源