TM
TM GlobalSaaS 商标检索
登录
产品 开放平台 数据覆盖 定价 登录
REST API 已可用 MCP 基于 API 封装

开放平台 · REST API 与 MCP

内容导航

REST API 直接可用;MCP Server 由同一套 API 封装,供 Claude / Cursor 等客户端调用。两者与网页检索共用订阅额度,不额外计费。

Aa

网页检索(SaaS)

浏览器直接使用:文字检索、图形检索、著录详情、导出与报告。

{ }

REST API

HTTPS + Bearer Key,JSON 请求/响应;适合后端服务、批处理与自建前端。

查看 REST 文档 →
◇

MCP Server

由 API 封装的 MCP 工具,AI 客户端可直接调用检索、详情与图形比对。

查看 MCP 文档 →

免费试用 30 天,包含 API 与 MCP 访问;同一把 Key 通用,无需额外配置。

REST API

端点一览

鉴权:Authorization: Bearer <KEY>;Key 在账户中心创建,仅创建时明文显示一次。

方法路径说明
POST/api/trademark/search文字检索:mark · mode · ipOffice · niceCode · status · appDate · page · size · sortOrder
GET/api/trademark/search/modes后端实际支持的检索模式与策略
GET/api/trademark/data/detail单品详情:app_num + ipoffice
POST/api/image/search图形近似检索(multipart,可带尼斯分类)
GET/api/trademark/commercial/tools工具目录与用量口径
GET/api/trademark/commercial/balance额度余额
GET/api/trademark/commercial/usage用量明细
POST/api/trademark/commercial/keys/rotate · /revokeKey 轮换 / 作废

REST 示例

curl · search.sh
curl -X POST https://api.tmglobal.example/api/trademark/search \
  -H "Authorization: Bearer $TM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mark":"HUAWEI","mode":"smart","size":20}'

MCP 配置

mcp · client config
{
  "mcpServers": {
    "tm-global": {
      "command": "node",
      "args": ["/abs/path/TMOnline/mcp/src/index.js"],
      "env": {
        "TM_KEY": "<YOUR_KEY>",
        "TM_BASE_URL": "http://127.0.0.1:8000"
      }
    }
  }
}
// 说明:npm 包尚未发布(Q3),请用本地 node 路径启动;
// npx -y @tmglobal/mcp 仅在发布后可用。
MCP

MCP 提供的三个工具

基于开放 API 封装,工具语义与 REST 端点一一对应;同一把 Key 通用。

search_trademark

文字检索:17 种模式、局/分类/状态过滤、分页排序。

get_trademark_detail

著录详情:当事人、尼斯分类、商品服务、事件时间线。

image_similarity

图形近似检索:返回相似商标与形/色/概念证据。

兼容 Claude Desktop / Claude Code / Cursor / Cline / Zed 等支持 MCP 的客户端。

常见问题

免费试用包含什么?

30 天试用含网页检索、REST API 与 MCP 访问。

Key 在哪创建?

登录后在账户中心创建、轮换或作废;明文仅在创建时显示一次。

有调用频率限制吗?

按档位限流(Scale 为专属速率);超出时返回 429,建议指数退避重试。

先把 Key 拿到手

免费试用即含 API 访问;用同一把 Key 同时接入 REST 与 MCP。