Metadata-Version: 2.5
Name: patent-clawel
Version: 1.0.0
Summary: patent_clawel SDK + CLI + MCP bridge — IP intelligence for AI agents.
Project-URL: Homepage, https://github.com/yourorg/marque
Project-URL: Documentation, https://github.com/yourorg/marque/tree/main/docs
Project-URL: Issues, https://github.com/yourorg/marque/issues
Author: patent_clawel maintainers
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,claude,cursor,ip-intelligence,mcp,openclaw,patent,skills,trademark
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: anyio>=4.4
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.5
Requires-Dist: rich>=13.7
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Description-Content-Type: text/markdown

# 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).

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

## Quick start

```python
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

```bash
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:

| target | path |
|--------|------|
| `claude-code` | `~/.claude/skills/patent-clawel/` |
| `openclaw` | `~/.openclaw/workspace/skills/patent-clawel/` |
| `cursor` | `~/.cursor/skills/patent-clawel/` |
| `codex` | `~/.codex/skills/patent-clawel/` |
| `gemini-cli` | `~/.gemini/skills/patent-clawel/` |
| `opencode` | `~/.opencode/skills/patent-clawel/` |

## MCP

```jsonc
// 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.
