google-patent-cli

Google Patent CLI - AI-ready

An AI-ready search and fetch tool for Google Patents, designed for both humans and AI agents. It extracts structured data including title, abstract, filing date, assignee, description paragraphs, claims, and images.

Features

• Search patents by free-text query, assignee, country, and date.
• Fetch patent details by patent number (e.g., "US10000000").
• Formatted JSON output including description_paragraphs and claims.
• Pagination support via --limit option.
• Date filtering with --before and --after.
• Country filtering with --country (e.g., JP, US, CN).
• Language/locale support with --language (e.g., ja, en).
• Raw HTML output with --raw flag for debugging.
• Headless mode by default; use --head to show the browser.
• Model Context Protocol (MCP) support to integrate with AI agents.
• Robust formatting: Uses structured JSON for easy machine consumption.

Installation

Easy Install (Recommended)

Linux & macOS:

curl -fsSL https://raw.githubusercontent.com/sonesuke/google-patent-cli/main/install.sh | bash

Note: On Linux, this installs to ~/.local/bin without requiring sudo. Make sure ~/.local/bin is in your PATH.

Windows (PowerShell):

irm https://raw.githubusercontent.com/sonesuke/google-patent-cli/main/install.ps1 | iex

From Source (Cargo)

If you have Rust installed, you can build from source:

cargo install --path .

Model Context Protocol (MCP)

google-patent-cli supports the Model Context Protocol, allowing AI agents (like Claude Desktop) to search and fetch patents directly.

Available Tools

Tool Name	Description	Parameters
search_patents	Search Google Patents matching a query, assignee, and date filters.	query, assignee, limit, before, after, country, language
fetch_patent	Fetch details (metadata, description, claims) of a specific patent.	patent_id (required, e.g., "US9152718B2"), language, raw
execute_cypher	Execute a Cypher query on a loaded patent dataset.	dataset (required), query (required)

Usage

To start the MCP server over stdio:

google-patent-cli mcp

Configuration for Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "google-patent-cli": {
      "command": "/path/to/google-patent-cli",
      "args": ["mcp"]
    }
  }
}

Claude Code Plugin

google-patent-cli is also available as a Claude Code Plugin from the marketplace.

Installation

Install the plugin using the Claude Code CLI:

claude plugin marketplace add sonesuke/google-patent-cli

Available Skills

Skill	Description
patent-search	Search and analyze patents from Google Patents. Supports keyword search, assignee filtering, country filtering, date range filtering, and fetching patent details.
patent-analysis	Analyze patent search results using Cypher queries on datasets loaded by the patent-search skill.

Usage

Once installed, you can use the skills directly in Claude Code:

# Search for patents
/patent-search action:search query:"machine learning" limit:10

# Fetch patent details
/patent-search action:fetch patent_id:"US9152718B2"

# Analyze search results
/patent-analysis dataset:"search-abc123" analysis_type:count_by_assignee