适用于 ADK 的 Adspirer MCP 工具

ADK 已支持PythonTypeScript

Adspirer MCP 服务器 将你的 ADK 智能体连接到 Adspirer，一个 AI 驱动的广告平台，提供 100+ 工具覆盖 Google Ads、Meta Ads、LinkedIn Ads 和 TikTok Ads。此集成使你的智能体能够通过自然语言创建、管理和优化广告活动——从关键词研究和受众规划到活动启动和效果分析。

工作原理

Adspirer 是一个远程 MCP 服务器，充当你的 ADK 智能体和广告平台之间的桥接器。你的智能体连接到 Adspirer 的 MCP 端点，通过 OAuth 2.1 进行身份验证，并访问直接映射到广告平台 API 的 100+ 工具。

典型的工作流程如下：

1. 连接 — 你的 ADK 智能体连接到 https://mcp.adspirer.com/mcp 并通过 OAuth 2.1 进行身份验证。首次运行时，浏览器窗口会打开，让你登录并授权访问你的广告账号。
2. 发现 — 智能体根据你连接的广告平台（Google Ads、Meta Ads、LinkedIn Ads、TikTok Ads）发现可用的工具。
3. 执行 — 智能体现在可以通过自然语言执行完整的活动生命周期：研究关键词、规划受众、创建活动、分析效果、优化预算和管理广告——全程无需操作控制台。

Adspirer 处理 OAuth 令牌管理、广告平台 API 调用和安全护栏（例如，无法删除活动或修改现有预算），因此你的智能体可以在内置保护下自主运行。

使用场景

• 活动创建：通过自然语言在 Google、Meta、LinkedIn 和 TikTok 上启动复杂的广告活动。无需操作控制台即可创建搜索、效果最大化、YouTube、需求开发、图片、视频和轮播广告。

• 效果分析：分析所有连接广告平台的活动指标。提出诸如"哪些活动的 ROAS 最高？"或"我的预算浪费在哪里？"等问题，并获得可操作的洞察和优化建议。

• 关键词研究与规划：使用 Google 关键词规划工具研究关键词，获取真实 CPC 数据、搜索量和竞争分析。构建关键词策略并直接添加到活动中。

• 预算优化：识别效果不佳的活动，检测预算效率低下问题，并获得 AI 驱动的跨渠道和跨活动的预算分配建议。

• 广告管理：向现有活动添加新的广告组、广告集和广告。A/B 测试创意、更新广告文案、管理关键词以及暂停或恢复活动——全部通过你的智能体完成。

前置条件

• 一个 Adspirer 账号（提供免费层级）
• 至少一个连接的广告平台（Google Ads、Meta Ads、LinkedIn Ads 或 TikTok Ads）——注册后通过 Adspirer 控制台连接
• 查看快速入门指南 了解分步设置说明

与智能体配合使用

PythonTypeScript

本地 MCP 服务器远程 MCP 服务器

首次运行此智能体时，浏览器窗口会自动打开以通过 OAuth 请求访问权限。在浏览器中批准请求，以授予智能体访问你连接的广告账号的权限。

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

root_agent = Agent(
    model="gemini-flash-latest",
    name="advertising_agent",
    instruction=(
        "你是一个广告智能体，帮助用户创建、管理"
        "和优化 Google Ads、Meta Ads、"
        "LinkedIn Ads 和 TikTok Ads 上的广告活动。"
    ),
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "mcp-remote",
                        "https://mcp.adspirer.com/mcp",
                    ],
                ),
                timeout=30,
            ),
        )
    ],
)

如果你已有 Adspirer 访问令牌，可以直接使用 Streamable HTTP 连接，无需 OAuth 浏览器流程。

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

ADSPIRER_ACCESS_TOKEN = "YOUR_ADSPIRER_ACCESS_TOKEN"

root_agent = Agent(
    model="gemini-flash-latest",
    name="advertising_agent",
    instruction=(
        "你是一个广告智能体，帮助用户创建、管理"
        "和优化 Google Ads、Meta Ads、"
        "LinkedIn Ads 和 TikTok Ads 上的广告活动。"
    ),
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mcp.adspirer.com/mcp",
                headers={
                    "Authorization": f"Bearer {ADSPIRER_ACCESS_TOKEN}",
                },
            ),
        )
    ],
)

本地 MCP 服务器远程 MCP 服务器

首次运行此智能体时，浏览器窗口会自动打开以通过 OAuth 请求访问权限。在浏览器中批准请求，以授予智能体访问你连接的广告账号的权限。

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

const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "advertising_agent",
    instruction:
        "你是一个广告智能体，帮助用户创建、管理" +
        "和优化 Google Ads、Meta Ads、" +
        "LinkedIn Ads 和 TikTok Ads 上的广告活动。",
    tools: [
        new MCPToolset({
            type: "StdioConnectionParams",
            serverParams: {
                command: "npx",
                args: [
                    "-y",
                    "mcp-remote",
                    "https://mcp.adspirer.com/mcp",
                ],
            },
        }),
    ],
});

export { rootAgent };

如果你已有 Adspirer 访问令牌，可以直接使用 Streamable HTTP 连接，无需 OAuth 浏览器流程。

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

const ADSPIRER_ACCESS_TOKEN = "YOUR_ADSPIRER_ACCESS_TOKEN";

const rootAgent = new LlmAgent({
    model: "gemini-flash-latest",
    name: "advertising_agent",
    instruction:
        "你是一个广告智能体，帮助用户创建、管理" +
        "和优化 Google Ads、Meta Ads、" +
        "LinkedIn Ads 和 TikTok Ads 上的广告活动。",
    tools: [
        new MCPToolset({
            type: "StreamableHTTPConnectionParams",
            url: "https://mcp.adspirer.com/mcp",
            transportOptions: {
                requestInit: {
                    headers: {
                        Authorization: `Bearer ${ADSPIRER_ACCESS_TOKEN}`,
                    },
                },
            },
        }),
    ],
});

export { rootAgent };

功能

Adspirer 提供 100+ MCP 工具，用于四大广告平台的完整生命周期广告活动管理。

功能	描述
活动创建	启动搜索、效果最大化、YouTube、需求开发、图片、视频和轮播广告活动
效果分析	分析指标、检测异常、获取优化建议
关键词研究	研究关键词，获取真实 CPC、搜索量和竞争数据
预算优化	AI 驱动的预算分配和浪费支出检测
广告管理	创建和更新广告、广告组、广告集、标题和描述
受众定位	搜索兴趣、行为、职位和自定义受众
资产管理	验证、上传和发现现有创意资产
活动控制	暂停、恢复、更新出价、预算和定位设置

支持的平台

平台	工具数	功能
Google Ads	49	搜索、效果最大化、YouTube、需求开发活动、关键词研究、广告扩展、受众信号
Meta Ads	30+	图片、视频、轮播、DCO 活动、像素跟踪、线索表单、受众洞察
LinkedIn Ads	28	赞助内容、线索生成、对话广告、人口统计定位、互动分析
TikTok Ads	4	活动管理和效果分析

其他资源

• Adspirer 官网
• GitHub 上的 Adspirer MCP 服务器
• 快速入门指南
• 工具目录
• 核心工作流
• 广告平台指南