uspto-database

用途

USPTO Database 用于访问美国专利商标局（USPTO）提供的专利和商标数据 API，支持知识产权分析与现有技术检索。适用场景包括：按关键词、发明人、受让人、分类或日期检索专利；获取专利权利要求、摘要、引用等完整数据；按序列号或注册号查询商标；查看商标状态、归属与审查历史；通过 PEDS 获取专利申请审查数据；检索审查意见通知书文本、引用与驳回理由；跟踪专利与商标的转让；分析专利引用（前向与后向）；获取专利诉讼记录；分析公司或发明人的专利/商标组合。

主要能力

该技能覆盖 USPTO 多个专门的 API：

PatentSearch API：基于 ElasticSearch 的专利检索（2025 年 5 月取代旧版 PatentsView），支持按关键词、发明人、受让人、分类、日期搜索，数据涵盖至 2025 年 6 月 30 日，速率限制为每分钟 45 次请求，基础 URL 为 https://search.patentsview.org/api/v1/。
PEDS（Patent Examination Data System）：提供 1981 年至今的申请状态与事务历史、审查意见日期与审查事件，可使用 uspto-opendata-python Python 库，已取代已停用的 PAIR Bulk Data（PBD）。
TSDR（Trademark Status & Document Retrieval）：提供商标状态、归属、审查历史，支持按序列号或注册号检索，基础 URL 为 https://tsdrapi.uspto.gov/ts/cd/。
其他 API：专利转让检索、商标转让检索、增强引用 API、审查意见通知书文本/引用/驳回检索、PTAB API、专利诉讼案件、Cancer Moonshot 数据集。

使用方式

所有 USPTO API 均需 API 密钥，需在 https://account.uspto.gov/api-manager/ 注册，并设置为环境变量：

export USPTO_API_KEY="your_api_key_here"

该技能包含常用操作的 Python 脚本：scripts/patent_search.py（PatentSearch API 客户端）、scripts/peds_client.py（PEDS 客户端）、scripts/trademark_client.py（TSDR 客户端）。

专利检索示例：

from scripts.patent_search import PatentSearchClient

client = PatentSearchClient()

# 按摘要关键词检索
results = client.search_patents({
    "patent_abstract": {"_text_all": ["machine", "learning"]}
})

for patent in results['patents']:
    print(f"{patent['patent_number']}: {patent['patent_title']}")

也可使用 search_by_inventor、search_by_assignee、search_by_date_range、search_by_classification 以及 advanced_search（组合关键词、受让人、日期范围、CPC 分类）等方法。如需复杂查询，可直接调用 API。查询支持等值、比较（_gt、_gte、_lt、_lte、_neq）、文本搜索（_text_all、_text_any、_text_phrase）、字符串匹配（_begins、_contains）和逻辑操作（_and、_or、_not）。最佳实践：文本字段使用 _text_* 操作符，性能优于 _contains 或 _begins。可用端点包括 /patent、/publication、/inventor、/assignee、/cpc_subclass、/cpc_at_issue、/uspc、/ipc、/claims、/brief_summary_text、/detail_description_text 等。

PEDS 检索示例：

先安装：uv pip install uspto-opendata-python

from scripts.peds_client import PEDSHelper

helper = PEDSHelper()
app_data = helper.get_application("16123456")
print(f"Title: {app_data['title']}")
print(f"Status: {app_data['app_status']}")

可调用 get_patent、get_transaction_history、get_office_actions、get_status_summary、analyze_prosecution 等方法。常见事务代码包括 CTNF（非最终驳回）、CTFR（最终驳回）、NOA（允许通知）、WRIT（提交答复）、ISS.FEE（发证费支付）、ABND（申请放弃）、AOPF（审查意见邮寄）。

商标检索示例：

from scripts.trademark_client import TrademarkClient

client = TrademarkClient()
tm_data = client.get_trademark_by_serial("87654321")
tm_data = client.get_trademark_by_registration("5678901")

还可调用 get_trademark_status、check_trademark_health 进行状态与健康检查，或按多个序列号监控商标组合。常见商标状态包括 REGISTERED、PENDING、PUBLISHED FOR OPPOSITION、ABANDONED、CANCELLED、SUSPENDED、REGISTERED AND RENEWED。

转让记录检索：

专利转让 API 基础 URL 为 https://assignment-api.uspto.gov/patent/v1.4/，可按专利号或公司名检索，返回 XML。常见转让类型包括 ASSIGNMENT OF ASSIGNORS INTEREST（所有权转移）、SECURITY AGREEMENT（担保权益）、MERGER（公司合并）、CHANGE OF NAME（更名）、ASSIGNMENT OF PARTIAL INTEREST（部分所有权）。

适用场景

适用于专利检索与现有技术调查、专利审查历史与审查意见分析、商标检索与状态监控、专利/商标组合管理与归属跟踪、专利引用分析、专利诉讼与 PTAB 程序检索等知识产权相关工作。

限制与注意事项

所有 USPTO API 均需 API 密钥；密钥应存入环境变量，切勿提交到版本控制，可在所有 USPTO API 间共用同一密钥。
速率限制：PatentSearch 为每分钟 45 次请求；遇到速率限制错误应实现指数退避，并在可能时缓存响应。
并非所有专利/商标的所有字段都会填充，应妥善处理缺失数据并统一解析日期。
旧版 API 停用情况：PatentsView 旧版 API 已于 2025 年 5 月 1 日停用，应改用 PatentSearch API；PAIR Bulk Data 已停用。
资料中未明确说明收费、价格或付费方式，相关内容暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制与注意事项