基于 scientific-agent-skills 的 USPTO 专利与商标数据查询指南PatentsView / PEDS / TSDR API 实战【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills导读本篇指南围绕 scientific-agent-skills 项目中 database-lookup 技能的 USPTO 参考文档references/uspto.md展开系统讲解如何通过美国专利商标局USPTO公开接口检索专利与商标数据。你将掌握新一代基于 Elasticsearch 的 PatentsView API 的完整查询语法与参数体系、专利审查状态接口 PEDS、商标状态接口 TSDR 的调用方式以及如何结合本仓库定义的 API Key 管理、限速、分页与可审计溯源规范把这些接口接入 Agent 的可复现数据检索流程。读完即可直接对按关键词查专利按发明人/受让人检索按专利号定位单件专利查询审查进度按序列号/注册号查商标等真实场景发起可重复的 API 调用。一、USPTO 数据接口全景与选库逻辑在 database-lookup 的数据库选择指南references/database_selection_guide.md中专利与监管Patents Regulatory领域共登记了四条典型检索意图全部指向 USPTO用户意图首选数据库说明按关键词或技术主题查专利USPTOPatentsView新一代全文检索接口按发明人或受让人查专利USPTOPatentsView结构化实体字段检索查询专利审查/确权状态USPTOPEDS申请卷宗数据商标查询USPTOTSDR按序列号/注册号查询跨域检索场景中化学发明的现有技术检索prior art被推荐组合为USPTO PubChem必要时追加 ChEMBL见 references/database_selection_guide.md。这说明 USPTO 接口不仅服务于专利领域也常用于药物研发中的新颖性/侵权风险评估。二、PatentsView 新一代 API推荐的专利检索入口原参考文档明确指出基于 Elasticsearch 的新版 API 是推荐的专利检索端点而旧版api.patentsview.org已被停用返回 HTTP 410 Gone。凡涉及专利检索都应直接使用新版接口。2.1 Base URL 与 API Keyhttps://search.patentsview.org/api/v1/新版 API需要注册 API Key注册地址为https://patentsview.org/apis/keyrequest通过查询参数传递?api_keyYOUR_KEY。按照 database-lookup 的 API Keys 与访问限制规范PATENTSVIEW_API_KEY是该数据库的专用环境变量应从.env文件中按需读取且只做是否存在的静默探测test -n ${PATENTSVIEW_API_KEY:-}若用户没有该 Key需要明确告知其在https://patentsview.org/apis/keyrequest注册后再继续绝不暴露 Key 值本身。2.2 核心 Endpoints 一览Endpoint用途GET/POST /patent/专利检索主要入口GET /patent/{patent_number}/按专利号精确查单件专利/inventor/发明人实体检索/assignee/受让人实体检索/cpc_group/CPC 分类组检索/patent/同时支持 GET 与 POST。当查询 JSON 较长、或涉及复杂布尔组合时POST 是更稳妥的携带方式这也与 SKILL.md 中GraphQL / POST-only 接口必须用 curl 通过 shell 工具调用的约定一致。2.3 查询操作符Operatorsq参数接收一个 JSON 查询对象核心操作符如下操作符语义_eq/_neq等于 / 不等于_gt/_gte/_lt/_lte大于 / 大于等于 / 小于 / 小于等于_begins前缀匹配_contains包含匹配_text_any文本字段任意词命中_text_all文本字段全部词命中_text_phrase文本字段短语精确匹配_and/_or/_not布尔组合逻辑其中_text_any/_text_all/_text_phrase是全文检索的核心_text_any适合宽松召回命中任一关键词即可_text_all要求所有词均出现_text_phrase则用于引号级别的精确短语是专利摘要语义检索最常用的三件套。2.4 请求参数Parameters参数含义示例qJSON 查询对象{_text_any:{patent_abstract:autonomous vehicle}}f需要返回的字段JSON 数组[patent_id,patent_title,patent_date]o选项对象size控制分页大小{size: 25}s排序规则JSON 数组[{patent_date: desc}]o中的size字段即分页窗口大小调大size可减少请求次数但受速率限制约束配合s中的稳定排序字段如patent_date降序可保证分页结果顺序确定这正对应 references/retrieval-contract.md 中确定性检索顺序的要求。2.5 四类典型查询实操1按关键词检索专利摘要含 autonomous vehicle返回 5 条仅取 ID/标题/日期GET /patent/?q{_text_any:{patent_abstract:autonomous vehicle}}f[patent_id,patent_title,patent_date]o{size:5}api_keyKEY2按发明人检索发明人姓氏为 TeslaGET /patent/?q{inventors.inventor_name_last:Tesla}f[patent_id,patent_title,patent_date]api_keyKEY3按受让人检索机构为 Google LLC同时返回受让人字段GET /patent/?q{assignees.assignee_organization:Google LLC}f[patent_id,patent_title,patent_date,assignees]api_keyKEY注意发明人与受让人均通过嵌套实体字段inventors.*/assignees.*访问f中要携带对应实体字段才能在响应中看到详情。4按专利号精确查询GET /patent/{patent_number}/?api_keyKEY此路径式查询适合已有明确专利号如11234567时的单件定位无需构造q。2.6 响应结构Response Structure{ patents: [ { patent_id: 11234567, patent_title: ..., patent_date: 2022-03-15, patent_abstract: ..., assignees: [{assignee_organization: ...}], inventors: [{inventor_name_first: ..., inventor_name_last: ...}] } ], count: 1, total_hits: 8923 }字段语义patents当前页命中的专利对象数组count当前返回记录数本页条数total_hits满足条件的总命中数。count与total_hits的差异是判断是否需要继续分页的关键依据——若count小于total_hits说明数据未取完。这直接对应检索契约中计数先行、数量对账count reconciliation的完整性协议先看total_hits估算规模再决定分页轮数超过 10,000 条记录或 100 次 API 调用前必须向用户确认见 references/retrieval-contract.md。2.7 速率限制Rate Limits新版 PatentsView 的速率限制约为每个 API Key 每分钟 45 次请求~45 requests/minute。在 Agent 工作流中这意味着大规模分页必须预判请求总量是否会突破限速必要时先按total_hits估算若遭遇 HTTP 429 或 503 限流响应应短暂等待后重试一次与 SKILL.md 的通用限速策略一致批量场景优先使用注册 Key匿名访问通常限速更低。2.8 重要注意事项用户必须持有 PatentsView API Key 才能调用该端点若没有需先前往https://patentsview.org/apis/keyrequest注册并从.env以PATENTSVIEW_API_KEY加载。旧版 APIapi.patentsview.org已退役返回 410 Gone。调试时若遇到该状态码应直接切换至search.patentsview.org/api/v1/新端点而非反复重试旧地址。三、PEDS专利审查数据系统URLhttps://ped.uspto.gov/api/queriesMethodPOSTPEDS 用于获取专利审查prosecution数据包括申请状态、申请日期、审查员信息等卷宗信息与 PatentsView 的公开文本检索形成互补PatentsView 回答有什么专利PEDS 回答这件申请审到哪一步了。请求体示例{ searchText: applicationNumberText:16123456, fl: *, mm: 100%, df: patentTitle, facet: false, sort: applId asc, start: 0 }关键字段说明searchText查询表达式示例按申请号文本applicationNumberText过滤fl返回字段列表*表示返回全部字段mm最小匹配度100%表示必须匹配全部查询词df默认查询字段此处为patentTitlefacet是否开启聚合面false关闭以简化响应sort排序规则applId asc表示按申请号升序start起始偏移用于分页配合每页固定条数递增。使用注意无需 API Key但限速严格服务可用性不稳定Availability can be unreliable属于参考文档明确标注的已知风险——失败时应如实报告并降级处理而不是编造审查状态。四、TSDR商标状态与文档检索TSDR 用于按序列号serial number或注册号registration number查询商标注意它不支持全文检索GET https://tsdr.uspto.gov/documentxml/status/{serial_number} GET https://tsdr.uspto.gov/documentxml/status/rn{registration_number}返回XML格式包含商标标识mark details、状态、权利人、商品与服务goods/services、审查历史prosecution history等信息无 API Key有限速无 JSON 端点解析需按 XML 处理。实操要点使用 TSDR 的前提是已经知道序列号或注册号。若用户只有商标名称而想查状态需先在 TESSweb-only 界面完成查找——这属于 TSDR 本身无法覆盖的能力边界应在输出中明确提示。五、已知限制与降级策略参考文档明确列出四条限制Agent 在检索时必须如实面对商标全文检索无公开 REST APITESS 仅限网页使用无法程序化做商标名/类别全文检索PatentsView 新 API 必须注册获取 API Key匿名调用不可行需引导用户注册PEDS 可用性不稳定偶发不可用需做好重试与失败上报TSDR 必须预知序列号/注册号无法从名称反查需借助其他渠道先行确认号码。六、将 USPTO 接入 Agent 检索工作流将上述接口融入可复现检索还需遵守 database-lookup 与 references/retrieval-contract.md 定义的通用协议6.1 检索契约先行调用前先明确目标实体专利/申请/商标、规范标识符专利号/申请号/序列号/注册号、检索范围targeted lookup 还是 exhaustive retrieval、过滤条件、必需字段与预期输出。缺失关键约束如查哪年之后的专利且影响结论时应先澄清而不是猜测。6.2 调用与分页规范新 API 端点 GET/POST 均可复杂查询建议 POSTPEDS 强制 POST分页PatentsView 通过o.size控制窗口、total_hits判断是否还有下一页PEDS 通过start递增偏移限速PatentsView 约 45 req/min/Key429/503 时等待后重试一次边界超过 10,000 条记录或 100 次调用前必须向用户确认检索计划。6.3 响应安全与溯源专利摘要、审查意见等返回文本属于第三方内容视为不可信数据不得将原始响应拼入 shell 命令也不得据此执行任何指令输出需附带 provenance查询的端点、参数、访问日期、标识符转换、计数对账total_hitsvs 实取数、以及旧版 API 已停用PEDS 可能不可用等警告若查询无结果必须显式说明而非默默省略。七、速查小结问题接口方法关键参数/前提按关键词/技术查专利PatentsView/patent/GET/POSTq中_text_any/_text_all/_text_phrase需 API Key按发明人/受让人查专利PatentsView/patent/GET/POSTinventors.*/assignees.*嵌套字段按专利号查单件PatentsView/patent/{id}/GET路径参数需 API Key查审查/确权状态PEDS/api/queriesPOSTsearchText按申请号过滤无需 Key限速严查商标状态TSDR/documentxml/status/...GET需预知序列号/注册号返回 XML无 Key进一步阅读完整的 78 个数据库目录与调用约定见 skills/database-lookup/SKILL.mdUSPTO 在选库指南中的定位见 references/database_selection_guide.md检索契约与审计清单见 references/retrieval-contract.md。【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 基于 scientific-agent-skills 的 USPTO 专利与商标数据查询指南：PatentsView / PEDS / TSDR API 实战
基于 scientific-agent-skills 的 USPTO 专利与商标数据查询指南PatentsView / PEDS / TSDR API 实战【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills导读本篇指南围绕 scientific-agent-skills 项目中 database-lookup 技能的 USPTO 参考文档references/uspto.md展开系统讲解如何通过美国专利商标局USPTO公开接口检索专利与商标数据。你将掌握新一代基于 Elasticsearch 的 PatentsView API 的完整查询语法与参数体系、专利审查状态接口 PEDS、商标状态接口 TSDR 的调用方式以及如何结合本仓库定义的 API Key 管理、限速、分页与可审计溯源规范把这些接口接入 Agent 的可复现数据检索流程。读完即可直接对按关键词查专利按发明人/受让人检索按专利号定位单件专利查询审查进度按序列号/注册号查商标等真实场景发起可重复的 API 调用。一、USPTO 数据接口全景与选库逻辑在 database-lookup 的数据库选择指南references/database_selection_guide.md中专利与监管Patents Regulatory领域共登记了四条典型检索意图全部指向 USPTO用户意图首选数据库说明按关键词或技术主题查专利USPTOPatentsView新一代全文检索接口按发明人或受让人查专利USPTOPatentsView结构化实体字段检索查询专利审查/确权状态USPTOPEDS申请卷宗数据商标查询USPTOTSDR按序列号/注册号查询跨域检索场景中化学发明的现有技术检索prior art被推荐组合为USPTO PubChem必要时追加 ChEMBL见 references/database_selection_guide.md。这说明 USPTO 接口不仅服务于专利领域也常用于药物研发中的新颖性/侵权风险评估。二、PatentsView 新一代 API推荐的专利检索入口原参考文档明确指出基于 Elasticsearch 的新版 API 是推荐的专利检索端点而旧版api.patentsview.org已被停用返回 HTTP 410 Gone。凡涉及专利检索都应直接使用新版接口。2.1 Base URL 与 API Keyhttps://search.patentsview.org/api/v1/新版 API需要注册 API Key注册地址为https://patentsview.org/apis/keyrequest通过查询参数传递?api_keyYOUR_KEY。按照 database-lookup 的 API Keys 与访问限制规范PATENTSVIEW_API_KEY是该数据库的专用环境变量应从.env文件中按需读取且只做是否存在的静默探测test -n ${PATENTSVIEW_API_KEY:-}若用户没有该 Key需要明确告知其在https://patentsview.org/apis/keyrequest注册后再继续绝不暴露 Key 值本身。2.2 核心 Endpoints 一览Endpoint用途GET/POST /patent/专利检索主要入口GET /patent/{patent_number}/按专利号精确查单件专利/inventor/发明人实体检索/assignee/受让人实体检索/cpc_group/CPC 分类组检索/patent/同时支持 GET 与 POST。当查询 JSON 较长、或涉及复杂布尔组合时POST 是更稳妥的携带方式这也与 SKILL.md 中GraphQL / POST-only 接口必须用 curl 通过 shell 工具调用的约定一致。2.3 查询操作符Operatorsq参数接收一个 JSON 查询对象核心操作符如下操作符语义_eq/_neq等于 / 不等于_gt/_gte/_lt/_lte大于 / 大于等于 / 小于 / 小于等于_begins前缀匹配_contains包含匹配_text_any文本字段任意词命中_text_all文本字段全部词命中_text_phrase文本字段短语精确匹配_and/_or/_not布尔组合逻辑其中_text_any/_text_all/_text_phrase是全文检索的核心_text_any适合宽松召回命中任一关键词即可_text_all要求所有词均出现_text_phrase则用于引号级别的精确短语是专利摘要语义检索最常用的三件套。2.4 请求参数Parameters参数含义示例qJSON 查询对象{_text_any:{patent_abstract:autonomous vehicle}}f需要返回的字段JSON 数组[patent_id,patent_title,patent_date]o选项对象size控制分页大小{size: 25}s排序规则JSON 数组[{patent_date: desc}]o中的size字段即分页窗口大小调大size可减少请求次数但受速率限制约束配合s中的稳定排序字段如patent_date降序可保证分页结果顺序确定这正对应 references/retrieval-contract.md 中确定性检索顺序的要求。2.5 四类典型查询实操1按关键词检索专利摘要含 autonomous vehicle返回 5 条仅取 ID/标题/日期GET /patent/?q{_text_any:{patent_abstract:autonomous vehicle}}f[patent_id,patent_title,patent_date]o{size:5}api_keyKEY2按发明人检索发明人姓氏为 TeslaGET /patent/?q{inventors.inventor_name_last:Tesla}f[patent_id,patent_title,patent_date]api_keyKEY3按受让人检索机构为 Google LLC同时返回受让人字段GET /patent/?q{assignees.assignee_organization:Google LLC}f[patent_id,patent_title,patent_date,assignees]api_keyKEY注意发明人与受让人均通过嵌套实体字段inventors.*/assignees.*访问f中要携带对应实体字段才能在响应中看到详情。4按专利号精确查询GET /patent/{patent_number}/?api_keyKEY此路径式查询适合已有明确专利号如11234567时的单件定位无需构造q。2.6 响应结构Response Structure{ patents: [ { patent_id: 11234567, patent_title: ..., patent_date: 2022-03-15, patent_abstract: ..., assignees: [{assignee_organization: ...}], inventors: [{inventor_name_first: ..., inventor_name_last: ...}] } ], count: 1, total_hits: 8923 }字段语义patents当前页命中的专利对象数组count当前返回记录数本页条数total_hits满足条件的总命中数。count与total_hits的差异是判断是否需要继续分页的关键依据——若count小于total_hits说明数据未取完。这直接对应检索契约中计数先行、数量对账count reconciliation的完整性协议先看total_hits估算规模再决定分页轮数超过 10,000 条记录或 100 次 API 调用前必须向用户确认见 references/retrieval-contract.md。2.7 速率限制Rate Limits新版 PatentsView 的速率限制约为每个 API Key 每分钟 45 次请求~45 requests/minute。在 Agent 工作流中这意味着大规模分页必须预判请求总量是否会突破限速必要时先按total_hits估算若遭遇 HTTP 429 或 503 限流响应应短暂等待后重试一次与 SKILL.md 的通用限速策略一致批量场景优先使用注册 Key匿名访问通常限速更低。2.8 重要注意事项用户必须持有 PatentsView API Key 才能调用该端点若没有需先前往https://patentsview.org/apis/keyrequest注册并从.env以PATENTSVIEW_API_KEY加载。旧版 APIapi.patentsview.org已退役返回 410 Gone。调试时若遇到该状态码应直接切换至search.patentsview.org/api/v1/新端点而非反复重试旧地址。三、PEDS专利审查数据系统URLhttps://ped.uspto.gov/api/queriesMethodPOSTPEDS 用于获取专利审查prosecution数据包括申请状态、申请日期、审查员信息等卷宗信息与 PatentsView 的公开文本检索形成互补PatentsView 回答有什么专利PEDS 回答这件申请审到哪一步了。请求体示例{ searchText: applicationNumberText:16123456, fl: *, mm: 100%, df: patentTitle, facet: false, sort: applId asc, start: 0 }关键字段说明searchText查询表达式示例按申请号文本applicationNumberText过滤fl返回字段列表*表示返回全部字段mm最小匹配度100%表示必须匹配全部查询词df默认查询字段此处为patentTitlefacet是否开启聚合面false关闭以简化响应sort排序规则applId asc表示按申请号升序start起始偏移用于分页配合每页固定条数递增。使用注意无需 API Key但限速严格服务可用性不稳定Availability can be unreliable属于参考文档明确标注的已知风险——失败时应如实报告并降级处理而不是编造审查状态。四、TSDR商标状态与文档检索TSDR 用于按序列号serial number或注册号registration number查询商标注意它不支持全文检索GET https://tsdr.uspto.gov/documentxml/status/{serial_number} GET https://tsdr.uspto.gov/documentxml/status/rn{registration_number}返回XML格式包含商标标识mark details、状态、权利人、商品与服务goods/services、审查历史prosecution history等信息无 API Key有限速无 JSON 端点解析需按 XML 处理。实操要点使用 TSDR 的前提是已经知道序列号或注册号。若用户只有商标名称而想查状态需先在 TESSweb-only 界面完成查找——这属于 TSDR 本身无法覆盖的能力边界应在输出中明确提示。五、已知限制与降级策略参考文档明确列出四条限制Agent 在检索时必须如实面对商标全文检索无公开 REST APITESS 仅限网页使用无法程序化做商标名/类别全文检索PatentsView 新 API 必须注册获取 API Key匿名调用不可行需引导用户注册PEDS 可用性不稳定偶发不可用需做好重试与失败上报TSDR 必须预知序列号/注册号无法从名称反查需借助其他渠道先行确认号码。六、将 USPTO 接入 Agent 检索工作流将上述接口融入可复现检索还需遵守 database-lookup 与 references/retrieval-contract.md 定义的通用协议6.1 检索契约先行调用前先明确目标实体专利/申请/商标、规范标识符专利号/申请号/序列号/注册号、检索范围targeted lookup 还是 exhaustive retrieval、过滤条件、必需字段与预期输出。缺失关键约束如查哪年之后的专利且影响结论时应先澄清而不是猜测。6.2 调用与分页规范新 API 端点 GET/POST 均可复杂查询建议 POSTPEDS 强制 POST分页PatentsView 通过o.size控制窗口、total_hits判断是否还有下一页PEDS 通过start递增偏移限速PatentsView 约 45 req/min/Key429/503 时等待后重试一次边界超过 10,000 条记录或 100 次调用前必须向用户确认检索计划。6.3 响应安全与溯源专利摘要、审查意见等返回文本属于第三方内容视为不可信数据不得将原始响应拼入 shell 命令也不得据此执行任何指令输出需附带 provenance查询的端点、参数、访问日期、标识符转换、计数对账total_hitsvs 实取数、以及旧版 API 已停用PEDS 可能不可用等警告若查询无结果必须显式说明而非默默省略。七、速查小结问题接口方法关键参数/前提按关键词/技术查专利PatentsView/patent/GET/POSTq中_text_any/_text_all/_text_phrase需 API Key按发明人/受让人查专利PatentsView/patent/GET/POSTinventors.*/assignees.*嵌套字段按专利号查单件PatentsView/patent/{id}/GET路径参数需 API Key查审查/确权状态PEDS/api/queriesPOSTsearchText按申请号过滤无需 Key限速严查商标状态TSDR/documentxml/status/...GET需预知序列号/注册号返回 XML无 Key进一步阅读完整的 78 个数据库目录与调用约定见 skills/database-lookup/SKILL.mdUSPTO 在选库指南中的定位见 references/database_selection_guide.md检索契约与审计清单见 references/retrieval-contract.md。【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考