Submit
andyleimc-source

腾讯广告 MCP Server

Community andyleimc-source
Updated

MCP server for Tencent Ads Marketing API v3.0 — 358 tools

English | 中文

腾讯广告 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
开发模式（需要 tsx） 
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

关注我

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

MCP Server · Populars

MCP Server · New