Patent Downloader

Patent Downloader SDK

Google Patents から特許をダウンロードするための、MCP に対応した Python SDK です。

AI エージェント向けワンラインインストール

スキルを自動でインストールして設定するには、以下の指示をコーディングエージェント（OpenCode / Cursor / Claw など）に送信してください。

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

CLI の詳しい使用方法については、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：特許を 1 件ダウンロード
• 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 ファイル

• 1 行につき特許番号 1 件
• ヘッダー行は省略可能（--has-header フラグを使用）
• 例：

  WO2013078254A1
  US20130123448A1
  EP1234567A1
  

CSV ファイル

• 特許番号 1 列
• ヘッダー行は省略可能（--has-header フラグを使用）
• 例：

  patent_number
  WO2013078254A1
  US20130123448A1
  EP1234567A1
  

ライセンス

MIT ライセンス