跳过主要内容
已上线产品

n8n 集成

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

n8n 可以用 HTTP Request 节点调用 TexoAI 的 JSON-RPC 端点；若你的 n8n 版本支持，也可使用 MCP 客户端工具。本页使用 API 交付方式。

连接方式

API可用

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

接入步骤

  1. 创建令牌
    在开发者设置中按工作流所需权限创建项目令牌，并复制一次性 mad_ 值。
  2. 添加 HTTP Request 节点
    添加 HTTP Request 节点，向 /api/developer/mcp 发送 JSON-RPC 请求体并携带 Authorization: Bearer 头。先用 tools/list 确认令牌可用。
    n8n · 接入步骤
    POST /api/developer/mcp
Content-Type: application/json
Authorization: Bearer mad_...

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
  3. 调用工具
    发送 ads.search、monitors.list 或 jobs.get 的 tools/call 请求，在工作流其余部分使用返回的 JSON。
    n8n · 接入步骤
    {
  "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 "Authorization: Bearer mad_..." \
  -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 排查。

常见问题

相关集成

API

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

Codex

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

Claude Code

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