跳过主要内容
返回首页
已上线产品

集成

从你已有的 AI Agent 中搜索、监控和生成广告。

TexoAI 提供真实的 JSON-RPC 开发者能力。使用项目级令牌连接 MCP 客户端或直接调用 API。本页只列出今天真实存在的能力——不包含虚构的安装步骤。

交付方式

MCP可用

位于 /api/developer/mcp 的 Model Context Protocol 服务器。用项目令牌将任意 MCP 客户端指向它。今天可用。

客户端

每个页面展示该客户端的真实接入方式与当前限制。

你的 Agent 可以做什么

当前公开六个工具。五个是只读;一个受保护的写工具用于提交已审批、仅草稿的静态克隆任务。

只读
ads.search
搜索广告库

按品牌、关键词或标题搜索规范广告,过滤条件与来源披露和产品内一致。

只读
ads.get
读取单条广告

读取绑定项目中单条规范广告的完整素材字段。

写入
ads.live_search_start

只读
ads.live_search_get

只读
boards.list
列出你的看板

列出绑定项目中已保存的私有看板。

只读
monitors.list
查看你的监控

列出绑定项目中的监控及其当前状态。

只读
jobs.get
查询任务

读取绑定项目内生成任务的状态与结果。

写入
clones.submit
提交草稿克隆任务

为静态图片或广告分析创建内部草稿任务。需要 approved: true,且从不发布。

权限

每次调用都会校验令牌权限范围以及创建者当前的项目成员资格。

默认只读
ads.search、ads.get、boards.list、monitors.list 与 jobs.get 只读取绑定项目内的数据,不会修改任何内容。
一个受保护的写工具
clones.submit 需要 clones:submit 范围与显式的 approved: true 参数,且只创建静态图片或广告分析的内部草稿任务,永远不会向广告账户发布。
保留权限
boards:write 与 monitors:write 作为权限范围存在,但目前不授予任何外部修改端点。

真实交互示例

端点是基于 HTTPS POST 的 JSON-RPC 2.0。先初始化、列出工具,再携带 Bearer 令牌调用工具。

请求
POST /api/developer/mcp
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}
响应
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      { "name": "ads.search", "scope": "ads:read", "description": "Search canonical ads in the bound project." },
      { "name": "ads.live_search_start", "scope": "ads:live", "description": "Start a live Meta Ad Library search for a keyword or advertiser." },
      { "name": "ads.live_search_get", "scope": "ads:read", "description": "Progress of a live search." },
      { "name": "ads.get", "scope": "ads:read", "description": "Read a canonical ad in the bound project." },
      { "name": "boards.list", "scope": "boards:read", "description": "List private Boards in the bound project." },
      { "name": "monitors.list", "scope": "monitors:read", "description": "List monitors in the bound project." },
      { "name": "jobs.get", "scope": "jobs:read", "description": "Read a generation Job in the bound project." },
      { "name": "clones.submit", "scope": "clones:submit", "description": "Submit an approved, draft-only static clone Job." }
    ]
  }
}

安全

凭证按项目隔离、仅存 SHA-256 摘要,每次调用都受速率限制并记录审计。

一次性令牌
令牌以 mad_ 开头,仅在创建时显示一次,系统只保存 SHA-256 摘要,可随时撤销。
最小权限范围
每个令牌只携带你选择的权限范围(从 ads:read 到 clones:submit),可选过期时间在每次调用时强制执行。
审计日志
令牌创建、撤销、Webhook 变更以及每次外部工具调用都会追加到项目审计日志。
速率限制
每个令牌固定一分钟窗口(默认 60 次,最高 600 次)。Limit、Remaining 与 Reset 通过 X-RateLimit-* 响应头返回。

诚实的限制

这些页面只描述今天已实现的内容。

  1. 暂无 Skill 或 CLI 安装包
    Skill 指令包与 CLI 二进制尚未发布。请改用 MCP 服务器或 API。
  2. Webhook 仅注册、不投递
    可以注册 HTTPS Webhook 目标与事件白名单,但当前还不会向其推送任何事件。
  3. 不支持视频,不发布广告
    开发者能力不执行视频任务,也从不向广告账户发布内容。

开发者资源

在产品内管理凭证,并关注下一步上线内容。

创建令牌

打开开发者设置,选择项目,勾选所需权限范围并复制一次性令牌。