跳过主要内容
已上线产品

开发者 API

所有集成背后的原始 JSON-RPC 能力。

开发者能力是单个 JSON-RPC 2.0 端点。先初始化、列出工具，再携带 Bearer 令牌调用工具。每次调用都限定在单个项目内，并受令牌速率限制与审计日志约束。

连接方式

API可用

服务器通过 HTTPS POST 响应 initialize、notifications/initialized、tools/list 与 tools/call（JSON-RPC 2.0）。通知返回空的 202；同样的工具始终可作为普通 API 调用。

接入步骤

  1. 创建令牌
    在开发者设置中创建项目令牌并复制一次性 mad_ 值，权限范围与可选过期时间在每次调用时生效。
  2. 列出工具
    调用 tools/list（无需令牌）确认端点并查看六个可用工具。
    API · 接入步骤
    curl -X POST https://<your-site>/api/developer/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
  3. 调用工具
    携带 Authorization: Bearer 头发送 tools/call，并通过 X-RateLimit-* 响应头跟踪剩余调用配额。
    API · 接入步骤
    curl -X POST https://<your-site>/api/developer/mcp \
  -H "Authorization: Bearer mad_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"ads.search","arguments":{"page":1,"pageSize":20}}}'

试一试

服务器连接成功后，快速冒烟检查：

curl -X POST https://<your-site>/api/developer/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

可用工具

ads.search
只读
ads:read
ads.get
只读
ads:read
ads.live_search_start
写入
ads:live
ads.live_search_get
只读
ads:read
boards.list
只读
boards:read
monitors.list
只读
monitors:read
jobs.get
只读
jobs:read
clones.submit
写入
仅限已批准的草稿静态任务；绝不会发布到广告账户。

常见错误

失败以 HTTP 400 加 JSON-RPC 错误对象（code + message）返回，而不是 HTTP 401/403/429。

-32001 — 令牌无效或缺失
tools/call 需要有效的 Authorization: Bearer mad_... 头。缺失与无效令牌均返回 JSON-RPC -32001（HTTP 400）。initialize、notifications/initialized 与 tools/list 不需要令牌。
-32003 — 权限范围不足
令牌有效但缺少该工具所需的权限范围，返回 JSON-RPC -32003（HTTP 400）。可在开发者设置中修改令牌范围，或改用只读工具。
-32003 — 超过速率限制
该令牌的一分钟窗口已用尽，同样返回 JSON-RPC -32003（HTTP 400）。等待重置，或在开发者设置中提高速率上限。
-32603 — 工具调用失败
服务端执行工具调用失败。HTTP 状态仍为 400；请根据 JSON-RPC id 与 message 排查。

常见问题

相关集成

n8n

在 n8n 工作流中自动化广告研究。

Codex

从 Codex CLI 或桌面 Agent 搜索并草拟广告。

Claude Code

从 Claude Code 终端搜索并草拟广告。