Patent Downloader

专利下载器 SDK

一个支持 MCP 的 Python SDK，可从 Google Patents 下载专利。

为 AI Agent 一键安装

将以下说明发送给你的编码 Agent（OpenCode / Cursor / Claw 等），即可自动安装并配置该技能：

Read https://raw.githubusercontent.com/Edison-A-N/patent_downloader/main/docs/skills/install.md and follow the steps to install.

详细的命令行用法请参阅 docs/skills/usage.md。

功能

• 从 Google Patents 下载专利 PDF
• 获取专利信息（标题、发明人、受让人等）
• 支持 MCP 服务
• 命令行界面
• API 简洁，并支持错误处理
• 支持从文件（TXT/CSV）批量下载

安装

# Using uv (recommended)
uv add patent-downloader
uv add "patent-downloader[mcp]"

# Using pip
pip install patent-downloader
pip install "patent-downloader[mcp]"

快速开始

Python API

from patent_downloader import PatentDownloader

# Download a patent
downloader = PatentDownloader()
success = downloader.download_patent("WO2013078254A1", "./patents")

# Get patent info
info = downloader.get_patent_info("WO2013078254A1")
print(f"Title: {info.title}")

# Download multiple patents
results = downloader.download_patents(["WO2013078254A1", "US20130123448A1"])

# Download patents from file
results = downloader.download_patents_from_file("patents.txt", has_header=False)

命令行

# Download patents
patent-downloader download WO2013078254A1
patent-downloader download WO2013078254A1 US20130123448A1 --output-dir ./patents

# Download patents from file
patent-downloader download --file patents.txt
patent-downloader download --file patents.csv --has-header

# Get patent info
patent-downloader info WO2013078254A1

# Start MCP server
patent-downloader mcp-server

MCP 服务

MCP 服务提供以下功能：

• download_patent：下载单个专利
• download_patents：下载多个专利
• get_patent_info：获取专利信息

你可以在 MCP 配置中使用 OUTPUT_DIR 环境变量设置默认下载目录。这样可以为所有专利下载设置固定路径。

Cursor 快速安装

使用 uvx（无需安装）

基本安装（默认下载目录：~/downloads）：

cursor://anysphere.cursor-deeplink/mcp/install?name=patent-downloader&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyItLXdpdGgiLCAibWNwIiwgInBhdGVudC1kb3dubG9hZGVyIiwgIm1jcC1zZXJ2ZXIiXX0

注意：如果需要自定义下载目录，安装后需要手动编辑 mcp.json 文件，并添加 env 部分：

{
  "mcpServers": {
    "patent-downloader": {
      "command": "uvx",
      "args": ["--with", "mcp", "patent-downloader", "mcp-server"],
      "env": {
        "OUTPUT_DIR": "~/Downloads/patents"
      }
    }
  }
}

手动设置

# Start server
patent-downloader mcp-server

# Using uvx to run without installation (specify MCP dependencies):
uvx --with mcp patent-downloader mcp-server

API

PatentDownloader

# Download patent
downloader.download_patent(patent_number, output_dir=".")

# Download multiple patents
downloader.download_patents(patent_numbers, output_dir=".")

# Download patents from file
downloader.download_patents_from_file(file_path, has_header=False, output_dir=".")

# Get patent info
downloader.get_patent_info(patent_number)

PatentInfo

@dataclass
class PatentInfo:
    patent_number: str
    title: str
    inventors: List[str]
    assignee: str
    publication_date: str
    abstract: str
    url: Optional[str] = None

文件格式支持

该 SDK 支持从 TXT 和 CSV 文件中读取专利号：

TXT 文件

• 每行一个专利号
• 可选标题行（使用 --has-header 标志）
• 示例：

  WO2013078254A1
  US20130123448A1
  EP1234567A1
  

CSV 文件

• 单列专利号
• 可选标题行（使用 --has-header 标志）
• 示例：

  patent_number
  WO2013078254A1
  US20130123448A1
  EP1234567A1
  

许可证

MIT 许可证