腾讯广告 MCP Server

将腾讯广告 Marketing API v3.0 全部接口封装为 MCP (Model Context Protocol) 工具，让 AI 助手（Claude Code、Claude Desktop 等）直接操作腾讯广告。

特性

• 358 个 MCP 工具，覆盖腾讯广告 Marketing API v3.0 全部接口
• 核心模块（广告组、创意、报表等）手写精细 schema，其余从官方 Go SDK 自动生成
• OAuth token 自动刷新 + 本地持久化
• 支持 Claude Code / Claude Desktop / 任何 MCP 客户端

覆盖模块

| 模块 | 说明 | |------|------| | 广告组 (adgroups) | 创建、查询、更新、删除、调价、调预算、暂停/启动 | | 创意 (dynamic_creatives) | 创建、查询、更新、删除创意 | | 素材 (images/videos) | 图片和视频的上传、查询、删除 | | 报表 (reports) | 日报、时报、异步报表任务 | | 人群 (audiences) | 自定义人群管理、定向查询 | | 资金 (funds) | 账户余额查询、资金划转 | | 线索 (leads) | 线索列表、创建、认领 | | 账户 (advertiser) | 账户信息、日预算管理 | | 更多... | 微信渠道、落地页、转化追踪、批量操作、AI素材 等 200+ 接口 |

安装

git clone https://github.com/andyleimc-source/tencent-ad-mcp.git
cd tencent-ad-mcp
npm install
npm run build

Claude Code

推荐（使用编译产物，启动快、无额外依赖）：

claude mcp add --scope user tencent-ad -- node /path/to/tencent-ad-mcp/dist/index.js

claude mcp add --scope user tencent-ad -- npx tsx /path/to/tencent-ad-mcp/src/index.ts

注意：如果 tsx 未全局安装，npx 需要下载依赖，可能导致启动超时。

Claude Desktop

在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "tencent-ad": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/tencent-ad-mcp/dist/index.js"],
      "env": {
        "TENCENT_AD_CLIENT_ID": "your_app_id",
        "TENCENT_AD_CLIENT_SECRET": "your_client_secret",
        "TENCENT_AD_ACCESS_TOKEN": "your_access_token",
        "TENCENT_AD_REFRESH_TOKEN": "your_refresh_token",
        "TENCENT_AD_ACCOUNT_ID": "your_account_id"
      }
    }
  }
}

环境变量

| 变量 | 必填 | 说明 | |------|------|------| | TENCENT_AD_CLIENT_ID | 是 | OAuth 应用 ID | | TENCENT_AD_CLIENT_SECRET | 是 | OAuth 应用密钥 | | TENCENT_AD_ACCESS_TOKEN | 是 | 访问令牌 | | TENCENT_AD_REFRESH_TOKEN | 是 | 刷新令牌 | | TENCENT_AD_ACCOUNT_ID | 否 | 默认广告主账户 ID | | TENCENT_AD_TOKEN_FILE | 否 | Token 持久化路径（默认 ~/.tencent-ad-token.json） |

获取凭证

1. 注册腾讯广告开发者：https://developers.e.qq.com
2. 创建应用，获取 client_id 和 client_secret
3. 在开发者工具页面获取 access_token 和 refresh_token
4. 在广告投放后台 (e.qq.com) 获取 account_id

开发

npm run dev       # 开发模式（tsx 直接运行）
npm run build     # 编译 TypeScript
npm run start     # 运行编译产物

重新生成工具（需要先克隆官方 Go SDK）：

git clone --depth 1 https://github.com/TencentAd/marketing-api-go-sdk.git /tmp/marketing-api-go-sdk
npm run generate

License

Apache-2.0

关注我

雷码工坊笔记 — 微信扫码关注