uspto-database

USPTO Database 是一个用于美国专利与商标官方记录查询的工作流技能。当任务需要来自 USPTO 系统的官方的专利或商标记录时，可使用该技能。

适用场景

检索授权专利或授权前公开文献。
查询专利申请状态、file-wrapper 数据、转让信息或公开审查历史。
查询商标状态、文件或转让历史。
构建可复现的现有技术、专利组合或 IP 态势研究日志。
将 USPTO 记录与 Google Patents、Lens.org、Semantic Scholar 或公司专利页面等二手工具进行对比。

该技能不用于提供法律建议，应视为数据收集与记录核验工作流。

来源选择

优先使用官方 USPTO 或 USPTO 支持的渠道：

Open Data Portal（ODP）：迁移后的 USPTO 数据集与 API 的当前入口。
Patent File Wrapper：公开专利申请书目数据与 file wrapper 记录。
PatentSearch API：PatentsView 搜索 API，用于授权专利与授权前公开数据集。
TSDR Data API：商标状态与文件检索。
Patent and Trademark Assignment Search：所有权转移记录。
ODP 中的 PTAB 数据：专利审判与上诉委员会程序。

二手来源仅作为便利索引使用；当结果重要时，应交叉核对官方记录。

认证与密钥

许多 USPTO API 流程需要 API 密钥。密钥应存储在环境变量或密钥管理器中，切勿写入提交文件或粘贴到记录中。常见环境变量名：

export USPTO_API_KEY="..." export PATENTSVIEW_API_KEY="..."

对于 PatentSearch，通过 X-Api-Key 请求头发送密钥。对于 TSDR，遵循当前 USPTO API Manager 说明与速率限制指引。

PatentSearch 工作流

当问题涉及趋势、发明人、受让人、分类、日期或组合切片时，使用 PatentSearch 进行广泛的专利与授权前公开检索。

流程：

从当前 PatentSearch 参考或 Swagger UI 确定端点。
构造带明确过滤条件的 JSON 查询。
只请求分析所需字段。
以确定性方式排序与分页。
记录端点、查询体、日期、数据时效说明与结果数量。

Python 请求骨架：

import os import requests

API_KEY = os.environ["PATENTSVIEW_API_KEY"] BASE = "https://search.patentsview.org/api/v1"

payload = { "q": { "_and": [ {"patent_date": {"_gte": "2024-01-01"}}, {"assignees.assignee_organization": {"_text_any": ["Google", "Alphabet"]}}, ] }, "f": ["patent_id", "patent_title", "patent_date"], "s": [{"patent_date": "desc"}], "o": {"per_page": 100, "page": 1}, }

response = requests.post( f"{BASE}/patent/", headers={"X-Api-Key": API_KEY, "Content-Type": "application/json"}, json=payload, timeout=30, ) response.raise_for_status() print(response.json())

复用查询前，请在实时 PatentSearch 文档中核实当前端点名称、字段路径、请求参数与 API 密钥可用性。

商标/TSDR 工作流

当任务需要商标案件状态、文件、图像、所有者历史或审查事件时，使用 TSDR。

流程：

规范化序列号或注册号。
核查当前 TSDR API 说明与所需 API 密钥请求头。
先获取状态，仅在需要时获取文件。
遵守 PDF、ZIP 与多案件下载的较低速率限制。
在输出中记录检索日期与序列号/注册号标识。

大批量商标拉取时，优先使用有文档说明的批量数据流程，而非抓取公开页面。

File Wrapper 与审查历史

对于申请状态、交易历史与审查文件：

从 ODP Patent File Wrapper 检索开始。
可用时使用精确标识：申请号、公开号、专利号或当事人名称。
记录该记录是授权专利、授权前公开还是待审申请。
引用前，在记录详情页交叉核对文件日期与状态。

转让工作流

对于专利或商标所有权：

按专利/申请/注册号、转让人、受让人或 reel/frame（如有）检索官方转让数据。
记录转让文本、签署日期、登记日期与各方。
区分转让记录与当前法律所有权结论。
若所有权具有实质影响，将结果标记为需律师或主题专家复核。

可复现输出

每次 USPTO 研究都应包含日志表：

Source	Date searched	Identifier/query	Filters	Results	Notes
PatentSearch	2026-05-11	`assignee=Alphabet AND date>=2024`	patent endpoint	118	API docs checked before run
TSDR	2026-05-11	`serial=90000000`	status only	1	API-key flow, no document bulk pull

最终写作时区分：

官方记录事实
推断分析
二手来源便利匹配
未解决的缺口或需法律复核的记录

复核清单

是否优先使用官方 USPTO 或 USPTO 支持的来源？
运行代码前是否核实当前端点与字段名称？
API 密钥是否未出现在文件、shell 历史与输出日志中？
查询日志是否包含检索日期与精确请求形态？
是否遵守速率限制？
是否避免法律结论或明确升级处理？
二手来源是否标注为二手？

参考资料

USPTO APIs catalog
USPTO Open Data Portal
PatentSearch API reference
PatentSearch API updates
TSDR API bulk download FAQ

技能介绍