Uspto Office Actions

@pipeworx/uspto-office-actions

USPTO 专利审查历史——审查意见通知书全文、审查员／申请人引用（以及通过 AI/ML 提取的“增强引用”元数据）、权利要求级驳回数据（35 U.S.C. 101/102/103/112），以及专利申请复议请求的专员最终决定。

属于 Pipeworx——一个将 AI Agent 连接到 1837+ 个实时数据源的 MCP 网关。这是一项独立的非官方集成，与上游提供方无关联、未获其认可，也未由其发布。

工具

• search_office_actions(application_number | patent_number, limit) — 查询某项申请的审查意见通知书：通知书类型、邮寄日期、审查员员工编号、技术中心，按时间从新到旧排列。
• get_office_action_text(document_id | (application_number + mail_date)) — 获取一份审查意见通知书的全文、文本长度及是否经过截断的标记。
• get_office_action_rejections(application_number, limit) — 权利要求级驳回数据：先提供 101/102/103/112／重复授权驳回记录的汇总计数，最后提供逐条记录详情。
• get_office_action_citations(application_number, limit) — 查询审查意见通知书中引用的文献、引用方（审查员或申请人），以及 USPTO 提供该引用的 AI/ML 提取增强引用字段（类别代码、权利要求／段落对应内容）。
• search_petition_decisions(query | application_number, decided_after, decided_before, limit, offset) — 查询专员／复议请求办公室的最终决定：决定类型、决定日期、复议请求类型、作出决定的办公室。

身份验证

使用平台密钥（PLATFORM_USPTO_KEY），也可通过 _apiKey 使用自带密钥。可在 https://data.uspto.gov/myodp 免费获取密钥。截至 2026-10，USPTO 要求新建或续期的 ODP 账户完成 ID.me 身份验证，并填写四项个人资料字段。如果账户尚未完成这些步骤，即使密钥格式正确，使用该账户生成的自带密钥也会被判定为无效。

数据来源

• USPTO，Open Data Portal——Office Action Text Retrieval 数据集（公有领域，CC0 标记）。涵盖从 1200 万号段申请开始发布的审查意见通知书。
• USPTO，Open Data Portal——Office Action Citations 数据集。
• USPTO，Open Data Portal——Office Action Rejection 数据集。
• USPTO，Open Data Portal——Enriched Citation（AI/ML 提取）数据集。
• USPTO，Open Data Portal——Final Petition Decisions 数据集。

仅注明发布方和数据集，切勿注明路由——具体端点见 src/index.ts。

说明

• 旧版 developer.uspto.gov Office Action API 已失效（全部 301 重定向到 data.uspto.gov/home，已于 2026-10-18 确认）。本工具包调用其在 api.uspto.gov 上的有效替代接口。
• 经过 FIVE 轮实时探测，才找到真实的请求格式（fleet #3305，2026-10-18——先是 cluster-c 自行探测，然后是 Antonio，接着是本工具包自行跟进，再然后是 Antonio）。有 THREE 种格式已被证伪，而不只是尚未尝试——不要重试：(1) 确实存在简单的 GET /office-actions 资源（无密钥时返回 401，使用错误密钥时返回 403 "Forbidden"），但它会拒绝所有尝试过的查询格式（单独使用 q/size，或搭配旧版 criteria/rows），并返回 "missing path or query params"——其真实契约仍然未知，本工具包不会调用它；(2) GET <route>/search 和 GET <route>/<applicationNumber> 均已通过直接请求在线上游证伪——无论使用什么密钥，都会返回 403 "Missing Authentication Token"，这是 AWS 路由层表示“资源不存在”的特征；这两个子路径都不存在。(3) 本工具包实际调用的接口：POST /api/v1/patent/oa/<dataset>/<version>/records，使用表单编码的 criteria（Lucene）/start/rows——这些是开源 patent-dev/uspto-odp Go 客户端自身已检入的 OpenAPI 规范中的原始 dataset 路由。起初我们误以为它们已失效，因为使用虚假密钥探测这些路由时，返回的状态码与本工具包对不存在路径进行对照探测时的状态码（403）相同。这个子树上真正能区分两者的是响应正文：{"message":"Forbidden"} 表示“路由存在，但密钥无效”；{"message":"Missing Authentication Token"} 表示“资源不存在”——这是两个不同的 403 响应正文，之前却被混为同一个状态码。无密钥的实时探测已确认，四种 dataset/version 组合均返回 "Forbidden"。具体的 dataset/version 对照表及各条目对应的 swagger 文件，请参阅 src/index.ts 中的 OA_DATASETS——对于 enriched citations，主要候选项采用 swagger 文件自身的 dataset 名称（enriched_cited_reference_metadata，v3），而不是实时探测时猜测的 oa_enriched_citations v1/v2；后者保留为后备选项。万一这样仍然不对，每个工具都接受 include_raw: true，这会跳过常规解析和错误处理，直接返回上游 HTTP 状态码和正文前 500 个字符——实时探测可以自行诊断下一处问题，无需经历修改代码再重新部署的过程。
• 响应信封采用经典的 Solr 格式（{response:{numFound,docs:[...]}}，已通过开源 patent-dev/uspto-odp Go 客户端中的真实响应示例确认）。遇到无法识别的格式时会明确抛出错误（upstream_parse: ...）并附上原始正文，而不会悄然返回空结果。
• Final Petition Decisions 已全面确认，并非推测：其路由（/api/v1/petition/decisions/search，POST，JSON {q, pagination:{offset,limit}, filters:[{name,value}]}）和响应格式（{count, petitionDecisionDataBag:[...]}）均与同一个 Go 客户端已检入的真实响应示例一致；本工具包自身的探测也独立确认该路由在线上存在（返回 401 Unauthorized）。
• USPTO 的空日期哨兵值为 "0001-01-01T00:00:00"——在本工具包的所有输出中都按 null 处理（未授权的申请没有 grant_date，而不是公元 1 年的授权日期）。
• obsoleteDocumentIdentifier（USPTO 自身保留的、名称有些奇怪的字段）会以 document_id 的名称提供给调用方——它是稳定的文档级键，并非真正已废弃的数据。
• 构建本工具包时，无法从本地/开发环境访问 fleet 持有的凭证（平台密钥仅存储在已部署网关的机密存储中），因此下方的部署前冒烟测试会对 api.uspto.gov 发起真实网络调用，并确认请求/响应代码运行正常，但只能观察到认证拒绝路径，无法获取真实载荷。首次真实验证将在部署后通过在线认证探测完成。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "uspto-office-actions": {
      "url": "https://gateway.pipeworx.io/uspto-office-actions/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/uspto-office-actions/mcp 上的 tools/list 会返回上表中的工具，以及共享的 Pipeworx 元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于此表中的数量：目前，单个工具包端点除了列出该工具包自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，也是当天适用范围的权威说明。

这是有意为之，并非意外的多路复用。元工具让受限连接能够回答此工具包未涵盖的问题——通过 ask_pipeworx 路由至整个目录——而无需添加第二个 MCP 服务。目前无法挂载不带这些元工具的工具包端点；如果额外的架构定义带来的上下文开销超过了路由功能的价值，请连接完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接获取所有工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1837+ 个数据源。唯一的区别在于直接列出哪个工具包的工具；无论连接哪个，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/search_office_actions \
  -H 'Content-Type: application/json' \
  -d '{"application_number":"17248024","limit":5}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/search_office_actions。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经由网关中转：

{
  "mcpServers": {
    "uspto-office-actions": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-uspto-office-actions"]
    }
  }
}

也可以直接运行它，确认服务能够启动：

npx -y @pipeworx/mcp-uspto-office-actions

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，但仅提供此工具包的工具——不包含上述网关连接额外提供的共享元工具。来源相同，工具相同，不提供 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——此功能既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Uspto Office Actions data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT