patent-clawel · Python SDK + CLI + MCP bridge

The official Python toolkit for Marque — an agent-ready IP compliance API covering 15 official patent and trademark sources (USPTO, EUIPO, WIPO, EPO, Google Patents, KIPRIS and more).

pip install patent-clawel
# or, for the CLI globally:
pipx install patent-clawel

Quick start

from patent_clawel import PatentClawel

pc = PatentClawel()  # reads PATENT_CLAWEL_API_KEY, or auto-onboards a 7-day trial key

# Patent search
result = pc.search("wireless earphones", entity_type="patent",
                   sources=["google_patents", "wipo_patentscope"])
print(result.markdown)            # LLM-ready markdown
print(result.source_results)      # structured records

# Trademark search
pc.search("nike", entity_type="trademark", sources=["euipo", "uspto_tm"])

# Risk analysis
pc.analyze("nike", entity_type="trademark", prompt="Conflict risk summary")

# Logo / image search
with open("logo.png", "rb") as fp:
    pc.search_image(fp, entity_type="trademark")

CLI

patent-clawel auth login                       # auto-onboard a trial key
patent-clawel search "nike" --type trademark   # search command
patent-clawel analyze "wireless earphones"     # search + AI risk summary
patent-clawel sources health                   # platform availability
patent-clawel mcp serve                        # stdio MCP bridge for Claude Desktop
patent-clawel skill install --target claude-code   # writes Skill into agent dir

Skill install targets

skill install --target supports:

MCP

// Claude Desktop / Cursor / VS Code (.cursor/mcp.json):
{
  "mcpServers": {
    "patent-clawel": {
      "url": "https://your-host/mcp",
      "transport": "streamable-http",
      "headers": {"Authorization": "Bearer pcl_live_..."}
    }
  }
}

For clients that only support stdio MCP, run patent-clawel mcp serve and point them at the spawned process.