跳到主要内容

MCP 接入(AI Agent)

One1 提供托管的远程 MCP(Model Context Protocol)服务,让 Claude、Cursor 等支持 MCP 的 AI 客户端直接把商标核查当作工具调用,无需自己封装 REST。

  • MCP 端点:https://one1.cn/mcp
  • 鉴权:同 REST,用你的 API Key;支持 OAuth 的客户端也可走授权登录,调用同样计入你的账户
  • 工具:共 7 个 —— 文本核名、Listing 撞标扫描、按注册号查详情、按权利人查商标、以图搜图、权利人维权画像,以及免费的数据覆盖查询(coverage_info),见下表

可用工具(7 个)​

工具说明消耗(API 点)
trademark_text_search文本核名20
listing_scanListing 撞标扫描20
trademark_lookup_by_serial按注册号查详情20
trademark_owner_search按权利人查商标20
graphic_trademark_search以图搜图30
trademark_owner_profile权利人维权画像20
coverage_info数据覆盖查询免费

在客户端配置(示例)​

{
  "mcpServers": {
    "one1": {
      "url": "https://one1.cn/mcp",
      "headers": { "Authorization": "Bearer one1_live_xxxxxxxx" }
    }
  }
}

配置后,AI 助手即可在对话中调用 One1 工具做商标风险检索。

点数、档位与限速(按账户)​

MCP 与 REST 用的是同一个账户:

  • 点数:工具调用从账户同一份 API 点扣除,点价见上表;coverage_info 免费。
  • 数据日期:与 REST 一致,MCP 工具输出(含 coverage_info 的覆盖表)自 2026-10 起不再携带 data_as_of 等数据截止日字段,只保留 scope / warning / clearance_ok;需要截止日请调免费的 GET https://one1.cn/api/coverage?country=XX。
  • 档位:所有档位(含免费版)均可调用全部 7 个 MCP 工具;MCP 仅覆盖本地辖区(伙伴国 DE/IT/ES/TR/BX 任何档位都不可用,请改用 REST /v1/text-search);MCP 不含合规检测系列与 Listing 改写。
  • 限速:MCP 与 REST 共用账户的每账户限速令牌桶(免费版 1 次/秒 · 入门版 2 次/秒 · 成长版 5 次/秒 · 企业版 10 次/秒),超出返回 429 rate_limited。
伙伴国辖区请用 REST

MCP 不对伙伴国辖区(DE/IT/ES/TR/BX)返回有效检索结果,不能作为这些辖区的核名依据;请改用 REST /v1/text-search(需付费 API 套餐)。

详见配额与计费。