Trademark search

商标搜索 MCP 服务

通过 AI 助手查询某个名称是否已在美国 (USPTO) 和欧盟 (EUIPO) 注册为商标或处于申请中，可按尼斯分类和商标指定的 商品与服务文字进行搜索，在购买域名或设计徽标前先行查询。查看单个商标，并逐步跟进 美国商标的案卷，其文件可保存为 PDF。所有工具都只读取公开登记信息：不会提交任何申请，唯一 写入的文件是 PDF，保存在服务自己的输出目录中。

搜索美国商标无需任何条件：不需要账号或密钥。查看美国商标的历史记录和文件需要免费的 USPTO TSDR API 密钥。搜索欧盟商标需要 EUIPO 应用的客户端 ID 和密钥，并订阅 Trademark Search；此订阅需由 EUIPO 人工审批（请预留一周或更长时间）。不会搜索罗马尼亚 OSIM、WIPO 或其他国家的商标局，且每条结果都会说明这一点。

可以查询什么

• “Turnip 是否已经在美国或欧盟注册为软件商标？”
• “搜索第 9 类和第 42 类中的 Blue Night，包括失效商标，并显示相似的名称。”
• “哪些有效的美国商标包含 talon 一词，并涵盖移动应用程序？”
• “最相近的美国商标案卷中发生了什么？有人提出异议吗？”
• “将该商标案卷中自 2025 年 1 月以来的审查意见保存为一个 PDF。”

安装

使用 Claude Code：

claude mcp add trademarks -- npx -y @foreverworks/mcp-trademarks

Claude Desktop（Settings、Developer、Edit Config）和大多数其他客户端会以 JSON 格式读取相同的命令：

{
  "mcpServers": {
    "trademarks": {
      "command": "npx",
      "args": ["-y", "@foreverworks/mcp-trademarks"]
    }
  }
}

每个客户端都会在 Node 22.19 或更高版本上运行已发布的软件包。VS Code 和 Claude Desktop 安装包在添加服务时会询问各项设置；可将可选项留空。Cursor 则会从环境变量中读取各项设置（例如 ${env:USPTO_TSDR_API_KEY_FILE}），因此请在启动 Cursor 前设置这些变量。所有设置均为可选；配置说明了哪些工具需要哪些设置。

从克隆版本运行

git clone https://github.com/foreverworks/mcps.git && cd mcps
npm ci && npm run build
claude mcp add trademarks -- node "$PWD/servers/trademarks/dist/index.js"

在 JSON 配置中，命令为 node，唯一参数是 servers/trademarks/dist/index.js 的完整路径。若要通过 HTTP 在多个客户端之间共享同一个运行中的实例，请参阅 docs/deploying.md。

配置

所有设置均为可选项。缺少凭据不会导致服务停止：其来源在 health 中显示为 not_configured，搜索会标记相应机构为未搜索，TSDR 工具会返回 config 错误，并提供相应的解决办法。

变量	必需	含义
USPTO_TSDR_API_KEY_FILE	查询美国文件时需要	保存 USPTO TSDR API 密钥的文件（本地运行时使用 USPTO_TSDR_API_KEY）。
EUIPO_CLIENT_ID_FILE、EUIPO_CLIENT_SECRET_FILE	查询 EM 时需要	保存 EUIPO 应用客户端 ID 和密钥的文件（本地运行时使用 EUIPO_CLIENT_ID 和 EUIPO_CLIENT_SECRET）。
EUIPO_ENVIRONMENT	否	production（未设置时的默认值）或 sandbox，后者包含测试数据。
TRADEMARKS_SOURCES	否	要运行的来源，以逗号分隔：uspto、euipo、tsdr。未设置时使用全部三个。
TRADEMARKS_OUTBOX_DIR	否	download_mark_documents 保存 PDF 的位置；默认位于状态文件夹中的 outbox/。文件权限为 0640，因此部署可以与用户组共享该文件夹。
TRADEMARKS_STATE_DIR	否	状态文件夹；默认值见 docs/configuration.md。
TRADEMARKS_USPTO_URL	否	USPTO 搜索后端的基础 URL；未设置时为 https://tmsearch.uspto.gov/prod-stage-v1-0-0/。
TRADEMARKS_TSDR_URL	否	TSDR 的基础 URL；未设置时为 https://tsdrapi.uspto.gov/ts/cd。

各工具所需条件：

工具	机构	所需条件
search_marks、get_mark	US	无。
search_marks、get_mark	EM	EUIPO 客户端 ID 和密钥，以及获批的订阅。
mark_history、mark_documents、download_mark_documents	US	TSDR API 密钥。

获取 USPTO TSDR API 密钥

1. 在 https://account.uspto.gov 创建 USPTO.gov 账户：免费，支持两步登录，且无需身份验证（不同于需要 ID.me 的 Open Data Portal 密钥）。
2. 打开 API 密钥管理器 https://account.uspto.gov/profile/api-manager，并申请 TSDR API 密钥。Open Data Portal 密钥是另一种密钥，TSDR 不接受该密钥。
3. 将密钥写入只有服务用户可读取的文件，并将 USPTO_TSDR_API_KEY_FILE 指向该文件。密钥有效期为一年；管理器会显示到期时间，并可续期。

获取 EUIPO 凭据

1. 创建 EUIPO 用户账户，并在 https://dev.euipo.europa.eu 登录。
2. 在 Apps 下注册一个应用。应用会获得客户端 ID 和密钥：分别将它们写入只有服务用户可读取的文件。
3. 为应用订阅 Trademark Search 产品（生产环境，或用于测试数据的 sandbox），并接受其使用条款。“大多数订阅申请都需要审批”，审批通过后 EUIPO 会向账户发送邮件。在此之前，EUIPO 会发放令牌，但会拒绝调用，并在 health 中将 EM 显示为 pending。

服务会连接到 tmsearch.uspto.gov、tsdrapi.uspto.gov、api.euipo.europa.eu 和 euipo.europa.eu（令牌端点）；使用 sandbox 时，还会连接到 api-sandbox.euipo.europa.eu 和 auth-sandbox.euipo.europa.eu。设置了 MCP_EGRESS_ALLOW 的部署必须允许连接这些地址。所有服务通用的变量（传输方式、限制、出口规则）见 docs/configuration.md。

首次运行

1. 请助手运行商标服务的 health 检查，查看每个来源的状态及其所需条件。当至少有一个来源可搜索，且没有已配置的来源发生故障时，ok 为 true；因此，pending 和 not_configured 不会导致部署的健康检查失败。
2. 在相应类别中搜索一个你知道已被注册的名称，了解命中结果是什么样的，然后再依赖未命中结果。

工具

所有工具都是读取操作：不会更改任何内容，且 download_mark_documents 只会写入服务自身的发件箱。

工具	访问权限	功能
health	读取	每个来源的状态（ok、not_configured 及所需信息、注册机构审批访问期间的 pending、failing）、是否为官方 API、similar 在该来源可查询的内容，以及没有任何来源覆盖的注册机构和原因。
search_marks	读取	同时在每个注册机构中搜索一个名称（也可指定注册机构）。每个注册机构会列出找到的商标，按最接近的结果排序，并提供状态、所有者、类别、申请日期、注册机构链接、相似度分数，以及各关系类型的数量。每个注册机构发起一次请求。
get_mark	读取	按注册机构和编号查询一个商标：状态、所有者、各类别的商品和服务（截取至 600 个字符），以及注册机构公布的日期（两者均提供申请和注册日期；状态日期和到期日仅由 EUIPO 提供，因为 USPTO 的搜索不会返回这两项）。
mark_history	读取	以 USPTO 的表述显示美国商标的状态、代码和日期，以及该商标档案中的全部步骤，按时间从新到旧排列；数据来自 USPTO 官方 TSDR API。
mark_documents	读取	列出美国商标档案中的文件，按时间从新到旧排列：日期、类型代码、说明、收件或发件、页数。
download_mark_documents	读取	根据类型代码和日期范围筛选文件，并将其合并为一个 PDF，存入发件箱，同时返回路径、SHA-256 和大小。不添加筛选条件时会下载整个档案，较早商标的档案可能有数百页。USPTO 每分钟允许 4 次下载。

search_marks 接受按原样填写的 name（名称，而非模式：不支持 *）； offices（EM、US、RO、WO，默认全部四个；未搜索的注册机构会说明原因）；classes（尼斯分类第 1 至 45 类，默认所有类别）；goods（必须按顺序共同出现在商标商品和服务描述中的词语）；match： exact（商标与名称一致）、word（商标包含该名称）或 similar （默认值：也包括读音相近或仅差一个字母的结果）；status：live （默认值：已注册和待审）或 all；以及 limit，每个注册机构列出的商标数量（1 至 100，默认 20）。

故障排除

某个注册机构显示 searched: false。 查看其 reason 或 error。 此处永远不会搜索 RO 和 WO，原因中会说明可供人工查询的位置；EM 出现 config 错误则表示尚未配置 EUIPO 凭据。未搜索某个注册机构并不代表没有相关商标。

TSDR 工具返回 config。 TSDR 无需密钥：获取一个密钥（见上文），或在 tsdr.uspto.gov 手动查看商标档案。

auth。 对于 TSDR：在 API 密钥管理器中确认该密钥是 TSDR API 密钥（Open Data Portal 密钥会被拒绝）且尚未过期。对于 EUIPO：在 dev.euipo.europa.eu 的 Apps 下，将客户端 ID 和密钥与应用中的值进行核对。

subscription，或 health 中的 EM pending。 EUIPO 已接受应用，但尚未接受调用：缺少 Trademark Search 订阅，或订阅仍在等待审批（第 3 步）。在此之前，请在 https://euipo.europa.eu/eSearch 手动搜索欧盟商标。

not_found。 USPTO 序列号为 8 位，EUIPO 申请编号为 9 位，包括前导零。

unsupported。 此处没有该注册机构的数据来源，或 EM 被要求提供商标档案，而 EUIPO 的 API 不提供此信息。消息中会说明查询位置。

rate_limited。 尝试三次后，注册机构仍在限制请求（TSDR 每分钟允许读取 60 次、下载文件 4 次）：请等待一分钟，并减少每次请求的数量。

api。 请求被拒绝、服务器错误在重试后仍未解决，或无法连接（状态码 0）。请一分钟后重试；若问题仍然存在，请运行 health。USPTO 搜索返回 401 或 403 可能意味着现在需要完成其页面上的浏览器验证，而此服务无法处理该验证。

drift。 注册机构返回了此服务无法识别的数据格式，或拒绝了此服务构建的查询。美国商标搜索使用的是未公开文档的 USPTO 后端，USPTO 可能随时更改；请报告此问题。

工作原理

查询结果说明

每个主管局都会在自己的版块中以以下三种方式之一作答：已搜索（found，注册簿自身统计的候选数；examined，返回的数量；如果有更多结果则为 more；以及 counts 和 marks）；未搜索，因为没有来源涵盖该主管局（reason，并说明可在哪里查询）；或未搜索，因为其来源故障或没有凭据（error，并附上相应的 remedy）。因此，空的 marks 列表始终表示“已搜索，未找到结果”，绝不表示“无法查询”。

• 关系在此处计算，且所有主管局使用相同方式。忽略大小写、重音符号、空格和标点，因此“Blue Night”、“BLUENIGHT”和“blue-night”是 identical；包含该名称的商标（TURNIP QPT、STURNIP）为 contains；来源返回的其他结果均为 similar。
• 注册簿按词语查找。 在 USPTO 搜索双词名称时，会同时找到单词连写和分写的商标；而以单词连写形式搜索同一名称时，则会漏掉分写的商标。复合名称也应尝试加空格搜索。
• 商品由注册簿筛选，仅限其来源支持此功能的情况。USPTO 支持搜索商品；EUIPO 的搜索 API 不支持（商品和服务信息仅随单个商标的详情提供）。每个已搜索的主管局都会在 goods_filter 中说明筛选情况：applied 表示已应用；unsupported 表示不支持，此时其商标列表未经筛选。类别表示商标可能发生冲突的范围；商品则说明是否确实冲突，因为第 9 类既包含软件，也包含太阳镜。
• **排序：**先列出完全相同的商标，再列出包含该名称的商标，最后列出相似商标。在前两组中，已注册商标排在待审商标之前；相似商标则按下文所述的相似度分数从高到低排列，然后按来源自身的相关性排序。
• 商标的 classes 是其当前涵盖的类别。 USPTO 会将从商标中取消的类别列为“(CANCELLED) IC 035”，此类类别不会计入类别筛选。失效商标保留其曾涵盖的类别。

相似度分数

每个包含词语的商标都有一个 similarity 分数，范围为 0 到 100。此处以相同方式为所有主管局计算该分数，因此 USPTO 和 EUIPO 的候选结果使用同一尺度。一半分数取决于商标的拼写：折叠文本之间的编辑距离（TURNIP 和 DURNIP 相差一个字母）。另一半取决于发音：语音键之间的编辑距离。语音键会改写同一发音的拼写（ph 和 f、ck 和 k、软音 c 或 g、不发音的 gh 或词尾 e），将发音相似的字母归为一类（d 和 t、b 和 p、m 和 n，以及所有元音），并合并重复字母，因此 TURNIP、DURNIP、TERNIP 和 DURNNIP 使用相同的键。TURNIP 与 TURNIP 的分数为 100，与 DURNIP 为 92，与 TURNIP QPT 为 67：该分数比较的是整个商标，因此商标包含该名称时，新增内容越多，分数越低；其 relation 会说明该商标包含该名称。这些键适用于使用拉丁字母的名称。该分数不考虑商品和服务，也不代表审查员会作出何种决定；不含文字的徽标则没有该分数。

来源（研究日期：2026-10-05）

主管局	来源	此处状态
US (USPTO)	tmsearch.uspto.gov 的搜索后端	已使用，非官方，无需密钥
US (USPTO)	TSDR API，商标档案	使用密钥后已使用，官方
EM (EUIPO)	Trademark Search API，dev.euipo.europa.eu	取得凭据后已使用，官方
RO (OSIM)	api.osim.ro:8443/tm-registry；TMview	未搜索
WO (WIPO)	Global Brand Database	未搜索
多个（TMview）	tmdn.org/tmview 前端 JSON	未使用

每个来源在该进程服务的所有会话中，每次只接收一个请求：USPTO 搜索每秒一个请求，TSDR 每秒一个请求且每十五秒可请求一个文档包，EUIPO 每秒四个请求。遇到 429 或服务器错误时，最多重试三次。 USPTO 搜索。 USPTO 有文档说明的 API 不支持按名称搜索：TSDR 只能按序列号或注册号查询，而开放数据门户（data.uspto.gov）提供批量数据（自 2026-06-18 起，仅限拥有 MFA 的 USPTO.gov 账户；申请其 API 密钥还需通过 ID.me 验证）。因此，服务端使用 USPTO 自有商标搜索页面的后端：其公开的 https://tmsearch.uspto.gov/configuration.json 指明了基础 URL（serviceUrlSearchElastic），而 POST <base>tmsearch 接受该页面构建的 Elasticsearch 查询（其捆绑文件中的 buildQueryTree）。该服务端会发送普通请求，并使用真实的 User-Agent；无需密钥，也无需通过挑战验证。页面会加载 AWS WAF 挑战脚本；调研时后端并不要求提供其令牌。本服务端不会应答或模拟该挑战。

• 条款： USPTO 的《USPTO 网站使用条款》（更新于 2026-08-13）禁止任何产生“异常大量数据库访问（搜索、页面或点击），无论是手动还是自动生成”的人访问，并指出在线数据库并非批量下载的来源。条款并未一概禁止自动访问，美国政府记录也不受版权保护。每个名称每秒至多一次请求，远低于上述两条限制。
• 风险： 后端没有文档说明，也没有版本，因此 health 会标记 official: false（限制）。
• 商品和服务使用索引的 GS 字段，并按页面自身细化查询的方式提问（match_phrase），通过 USPTO 的分析器进行处理。索引会保留商标已取消类别的文本，因此，如果某商标的词仅出现在这些类别中，该商标会被排除；如果这些词在其文本中完全没有出现（USPTO 匹配了复数形式或词干），则会保留该商标。
• similar 的匹配范围包括索引的语音字段（WMP5：将 d 视为 t、另一个元音或双写字母）、前缀匹配、一到两个字母的编辑距离，以及已记录的翻译：记录为表示该名称的商标会与之匹配，并在结果中返回其 translation。

TSDR 是 USPTO 官方的 Trademark Status and Document Retrieval API（“TSDR API v1”），密钥通过 USPTO-API-KEY 标头传递。 GET /casestatus/sn<serial>/info 会返回状态（USPTO 代码、描述句 extStatusDesc、摘要 tm5StatusDesc，例如“LIVE/REGISTRATION/Issued and Active”，以及关键日期）和 prosecutionHistory，其中包含每个步骤的日期、代码和说明；步骤日期是美国东部时间午夜的时间戳，因此日期就是其前 10 个字符。GET /casedocs/sn<serial>/info 会列出文件，但仅提供 XML（JSON 请求会收到 406），且文件没有自己的 ID，因此下载时按类型和日期选择： GET /casedocs/bundle.pdf?sn=&type=&fromDate=&toDate=，保存后会检查文件是否以 PDF 文件头开头。商标根据摘要的首个词判定为 registered、pending 或 dead，与 search_marks 使用相同规则。health 会读取 USPTO 自有文档示例（78787878）的状态。这些数据结构是根据公开序列号记录的；测试夹具中的所有名称、编号、地址和日期均为虚构。

EUIPO。 Trademark Search API（OpenAPI 1.1.0，来自 dev.euipo.europa.eu/product/trademark-search_110）涵盖欧盟商标和指定欧盟的国际注册：使用 RSQL query 调用 GET /trademarks（文字要素支持使用 * 通配符的 ==；不支持模糊或语音搜索），并可指定类别、状态，以及每页 10 至 100 条结果；调用 GET /trademarks/{applicationNumber} 可查询单个商标；默认方案每天允许 25,000 次调用。“沙盒环境的订阅请求最多可能需要一周。不过，生产环境的请求可能需要更长时间”（入门指南）。身份验证使用 EUIPO 令牌端点的 OAuth2 客户端凭据模式（作用域 uid），获取有效期两小时、仅保存在内存中的令牌；此外，每次请求都必须携带 X-IBM-Client-Id。EUIPO 在申请费缴清前不会公开申请人的姓名，因此此类商标不会列出所有者。

• 尚未对真实 API 进行测试。 适配器依据规范构建并经过测试。规范未明确规定的两点已通过防御性处理：== 是否忽略大小写（分别使用名称本身、大写、小写和标题大小写进行查询），以及 * 是否能在带引号的值中使用（仅当名称包含空格或 RSQL 字符时才加引号）。

未进行搜索。

• OSIM（罗马尼亚）： 其自有搜索（https://api.osim.ro:8443/tm-registry）会将所有访问者重定向到 reCAPTCHA 页面，且 OSIM 未发布 API。欧盟商标也涵盖罗马尼亚，因此 EM 可以回答部分问题。
• WIPO： 全球品牌数据库没有公共 API（WIPO 目录中的 API 面向合作知识产权局）；其条款禁止自动查询、批量下载和抓取，并将同一 IP 每分钟发出超过 10 次搜索操作视为过量（wipo.int/en/web/global-brand-database/terms_and_conditions，第 2.1 节）；其页面带有工作量证明验证码。指定欧盟（EM）或美国（序列号为 79xxxxxx）的国际注册仍会显示在相应结果中。
• TMview（tmdn.org/tmview）通过一个未公开文档的 JSON 后端（POST /tmview/api/search/results），在一次搜索中覆盖 EUIPO、OSIM、USPTO、WIPO 和大多数国家主管机构。该后端会重置任何 User-Agent 不是浏览器的连接，因此使用它就意味着伪装成浏览器。tmdn.org 法律页面指向的法律声明（euipn.org/en/info/legal-notices，查阅于 2026-10-05）声明，保留数据“以任何方式使用的权利，包括机器人、抓取工具或其他自动化流程”，但“EUIPO 以书面形式明确授权的情况除外”（TDM-RESERVATION: 1）。获得该授权后，它便能成为涵盖所有主管机构的单一来源；在此之前，请手动在该处查询 RO 和其他地区。

试用

npx tsx scripts/smoke.ts [name ...] 会驱动已构建的服务，对照真实注册机构进行测试：运行 health，在每个主管机构的第 9、35 和 42 类中查询每个名称，然后对找到的首个美国商标调用 get_mark。一次搜索约需 1 秒，几乎全部耗时都花在那次美国请求上。

局限

• 这是名称检查，不是商标清查意见。 混淆可能性也取决于商品和服务，以及任何字符串比较都无法识别的相似性。
• 美国搜索未公开文档且非官方。 USPTO 可能会在不另行通知的情况下更改或关闭该搜索；服务无法识别的数据结构会导致 drift，而不会被当作“未找到任何结果”。
• 未搜索 RO（OSIM）、WO（WIPO）以及仅由 TMview 覆盖的主管机构。 每条结果都会说明这一点，并指出可供查询的位置。
• EUIPO 的搜索依据文字进行：不支持语音或模糊匹配，因此 similar 在 EM 中的覆盖范围不如在美国广。
• 商标档案仅来自美国。 EUIPO 的 API 会提供欧盟商标的状态和状态日期，但不提供其历史记录或文件。

其他商标注册簿服务

检索日期：2026-10-15。没有商标局发布相关服务：USPTO、EUIPO、WIPO 或 OSIM 都没有在 MCP Registry、其网站或 GitHub 上提供此类服务。其他现有服务：

• Clarivate 的 CompuMark Trademark MCP：远程服务，需要 CompuMark 订阅，声称覆盖 188 个数据库。
• MarkMesh：远程服务，需要 API 密钥，覆盖 30 多个注册簿，试用期后按月收费。
• 未找到 Corsearch、Markify 或 Trademarkia 提供的服务。
• Antevo 的商标服务：远程服务且免费，无需账户；可在 19 个注册簿中筛查名称，包括美国和 EM，其中部分通过 TMview 查询；不支持按类别筛选，也无法按编号查询。
• TrademarkMind：远程服务；覆盖美国注册簿和 WIPO 的马德里注册簿，也会检查徽标；运营者未公开姓名。
• patent_mcp_server：开源；仅覆盖美国，使用与此服务相同的 USPTO 后端。
• 其他服务仅覆盖美国（Goalie IP、GleanMark），或可按编号查询美国商标。

它们都没有结合此服务的这些特点：直接查询各商标局，不查询其他来源，因此待审查的名称不会传给第三方；仅使用条款未禁止自动访问的来源，从不应对 USPTO 的机器人验证，也不使用 TMview 或 WIPO；由各商标局自行答复，未查询的商标局会说明原因，而不会显示为查询结果清晰；支持按尼斯分类筛选，并可按编号查询两个商标局中的商标；且可自托管。上述服务覆盖的商标局更多：如需查询 RO 和其他地区，它们或手动使用 TMview，覆盖范围更广。