| name | patent-fetch |
| description | 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. |
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-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 下载链接
推荐工作流
手动下载流程
scholaraio patent-search "quantum computing" --count 10
scholaraio patent-fetch US20230123456A1
scholaraio pipeline ingest
scholaraio search "voltage overshoot"
自动下载流程
scholaraio patent-search "quantum computing" --count 5 --fetch
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 — 本地知识库检索
