agentleFS
ZimoLiaoZimoLiao/scholaraio/.claude/skills/patent-search/SKILL.md

patent-search

Skill589 starsChanged yesterdayMITView on GitHub

Use when the user wants USPTO patent discovery, patent metadata lookup, application lookup, or downloadable patent candidates before ingest.

  • Reads credentials

8 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use patent-exam-policy, patent-oa and 2 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • handsomestWeiSkill

    patent-exam-policy

    给交底用的政策简报:对照国知局近期口径,说明对交底写法/本稿的影响,并提示申请书式。技能进化仅为旁路,默认只改交底包,须另点名才改文件。

    Also in 3 projects that use this

  • handsomestWeiSkill

    patent-oa

    审查答复辅助:审查意见问答与草稿;库薄时引导案例入库。须显式触发。

    Also in 3 projects that use this

  • fuyuxiangSkill

    patent-disclosure

    生成专利技术交底书。当用户提到"专利"、"交底书"、"发明"、"技术方案"、"权利要求"时触发。通过多轮对话采集发明信息,生成符合规范的完整交底书文档和附图。

    Also in 3 projects that use this

  • +1 more from handsomestWei

The file

Files
SKILL.md

patent-search — USPTO 专利搜索

通过 USPTO Patent Public Search (PPUBS) 搜索美国专利,无需 API Key,无需注册账号。

同时保留 USPTO Open Data Portal (ODP) API 作为可选后端(需要 API Key),用于更结构化的申请号查询。

注意:本命令仅用于搜索发现,不会直接入库。 如需将专利纳入知识库,请后续通过 patent-fetch 或 --fetch 下载 PDF 后放入 configured patent inbox(fresh 默认 data/spool/inbox-patent/),再执行 scholaraio pipeline ingest 走正常的专利入库流程(含公开号去重)。

用法

关键词搜索(默认 PPUBS,无需 API Key)

# 基本搜索
scholaraio patent-search "artificial intelligence"

# 指定结果数量
scholaraio patent-search "neural network" --count 20

# 分页
scholaraio patent-search "semiconductor" --count 10 --offset 10

搜索并自动下载 PDF

# 搜索并自动下载所有结果中的专利 PDF 到 configured patent inbox
scholaraio patent-search "quantum computing" --count 5 --fetch

高级查询语法(PPUBS)

PPUBS 支持字段限定检索,基本语法为 ("term").field.:

# 标题检索
scholaraio patent-search '("artificial intelligence").title.'

# 发明人检索
scholaraio patent-search '("Smith").inventor.'

# 公开号检索
scholaraio patent-search '("US20230123456A1").publ.'

# 布尔组合
scholaraio patent-search '("artificial intelligence").title. AND ("neural network").title.'

使用 ODP API(需要 API Key)

若已配置 ODP API Key,可通过 --source odp 切换到 ODP 后端:

# ODP 关键词搜索
scholaraio patent-search "artificial intelligence" --source odp

# 按申请号查询详情(ODP 支持更完整的结构化元数据)
scholaraio patent-search --application 17123456 --source odp

ODP API Key 配置方式:

  • config.local.yaml:
    patent:
      uspto_odp_api_key: "your-api-key"
  • 环境变量:
    export USPTO_ODP_API_KEY="your-api-key"

输出示例

找到 3 / 1542 条 USPTO 专利结果

[1] SYSTEMS AND METHODS FOR MACHINE LEARNING BASED IMAGE PROCESSING
    Publication: US20230123456A1
    Inventors: John Doe, Jane Smith
    Filing: 2021-05-15
    Published: 2023-04-20
    Type: US-PGPUB
    下载: scholaraio patent-fetch US20230123456A1

[2] NEURAL NETWORK ACCELERATOR WITH DYNAMIC SPARSITY
    Publication: US11678901B2
    Inventors: Alice Wong
    Assignees: Example Corp
    Filing: 2020-03-10
    Published: 2023-06-13
    Type: USPAT
    下载: scholaraio patent-fetch US11678901B2

推荐工作流

方式一:搜索后手动下载

# 1. 搜索发现目标专利
scholaraio patent-search "quantum computing" --count 10

# 2. 根据输出提示,手动下载感兴趣的专利
scholaraio patent-fetch US20230123456A1

方式二:搜索并自动下载

# 1. 搜索并自动下载前 5 条结果的 PDF
scholaraio patent-search "quantum computing" --count 5 --fetch

# 2. 走正常 pipeline 入库
scholaraio pipeline ingest

# 3. 本地检索
scholaraio search "quantum computing"

故障排除

缺少 API Key(仅影响 --source odp)

搜索失败: 缺少 USPTO ODP API Key。请在 config.local.yaml 中配置...

解决方案:

  1. 如果不需 ODP 的额外功能,直接使用默认 PPUBS(不加 --source odp)
  2. 如需 ODP,访问 https://data.uspto.gov/apis/getting-started 注册账号
  3. 完成视频验证后获取 API Key
  4. 配置到 config.local.yaml 或环境变量

未找到专利

未找到与 '...' 相关的专利
  • 尝试简化关键词
  • 检查 PPUBS 字段语法是否正确(引号、括号、点号)
  • 对精确申请号查询,使用 --source odp --application <号码>

PPUBS 会话过期/403

  • 客户端会自动刷新会话并重试,通常无需手动处理
  • 若频繁失败,可能是网络波动,稍后再试

patent-fetch 下载失败

  • 美国专利会优先尝试 USPTO PPUBS 官方导出;若失败再回退 Google Patents
  • 该专利可能尚未提供可导出的 PDF(如非常新的 WO 专利)
  • 尝试在浏览器中打开专利页面确认
  • 部分专利需要换源(如 EPO)

相关功能

  • scholaraio patent-fetch — 下载指定专利 PDF 到 configured patent inbox(fresh 默认 data/spool/inbox-patent/)
  • scholaraio arxiv — arXiv 论文搜索与下载
  • 宿主 Agent 原生网页搜索 — 开放网页补充发现
  • scholaraio pipeline ingest — 将 inbox-patent 中的 PDF 入库
  • scholaraio search / scholaraio vsearch — 本地知识库检索

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.