OpenParable
Skip to content
← Back to skills

Patent Fetch

Documents
patent-fetch

Patent Fetch is an Agent Skill for documents published in the ZimoLiao/scholaraio repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when the user has a patent publication number, patent URL, or patent-search result and wants the PDF fetched into the configured patent inbox.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/ZimoLiao/scholaraio/blob/HEAD/.claude/skills/patent-fetch/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/patent-fetch, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

patent-fetch — 专利 PDF 下载

优先通过 USPTO PPUBS 官方导出接口下载美国专利 PDF，并在必要时回退到 Google Patents 页面抓取，自动保存到 configured patent inbox（fresh 默认 data/spool/inbox-patent/），供后续 pipeline ingest 入库。旧版 data/inbox-patent/ 先用 scholaraio migrate upgrade --migration-id <id> --confirm 迁移。

常与 patent-search 配合使用：先用 patent-search 发现专利，再用 patent-fetch 或 --fetch 参数下载 PDF。

功能

  • 专利 ID 直输：只需输入专利公开号（如 US20240176406A1），优先走 USPTO 官方导出
  • 完整 URL 支持：也支持直接传入完整的专利页面链接
  • 官方下载优先：美国专利优先走 PPUBS 导出，避免 Google 页面抓取不稳定
  • 自动去重：如果目标文件已存在，跳过下载
  • 仅用于发现下载：不入库，下载后需手动执行 scholaraio pipeline ingest 走专利入库流程

用法

通过专利 ID 下载

scholaraio patent-fetch US20240176406A1

通过完整 URL 下载

scholaraio patent-fetch "https://patents.google.com/patent/US20240176406A1"

与 patent-search 联动

# 方式一：搜索后根据提示手动下载
scholaraio patent-search "neural network" --count 5
# 输出中每条结果会显示：下载: scholaraio patent-fetch <公开号>

# 方式二：搜索时自动下载所有结果 PDF
scholaraio patent-search "neural network" --count 5 --fetch

输出示例

已下载: /path/to/data/spool/inbox-patent/US20240176406A1.pdf (1679017 bytes)
已保存到: /path/to/data/spool/inbox-patent/US20240176406A1.pdf

如果文件已存在：

文件已存在: /path/to/data/spool/inbox-patent/US20240176406A1.pdf
已保存到: /path/to/data/spool/inbox-patent/US20240176406A1.pdf

如果页面没有 PDF 链接：

未在该页面找到 PDF 下载链接

推荐工作流

手动下载流程

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

# 2. 根据公开号下载目标专利 PDF
scholaraio patent-fetch US20230123456A1

# 3. 走正常专利入库流程（自动按公开号去重、标记 patent 类型）
scholaraio pipeline ingest

# 4. 本地检索
scholaraio search "voltage overshoot"

自动下载流程

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

# 2. 直接入库
scholaraio pipeline ingest

故障排除

页面请求超时或下载失败

  • 美国专利默认优先走 USPTO PPUBS 官方导出，通常不需要额外代理
  • 若已回退到 Google Patents，某些网络环境下可能需要配置 HTTP 代理

未在该页面找到 PDF 下载链接

  • 该专利可能尚未上传 PDF（如非常新的 WO 专利）
  • 尝试在浏览器中打开页面确认是否有 PDF 下载入口
  • 部分非美国专利或特殊文档类型可能需要换源（如 EPO）

下载失败

  • 检查 configured patent inbox（fresh 默认 data/spool/inbox-patent/）是否有写入权限
  • 确认磁盘空间充足

相关功能

  • scholaraio patent-search — USPTO 专利搜索（发现专利公开号，支持 --fetch 自动下载）
  • scholaraio pipeline ingest — 将 inbox-patent 中的 PDF 入库
  • scholaraio search / scholaraio vsearch — 本地知识库检索