Metadata-Version: 2.5
Name: patent-watch
Version: 0.1.1
Summary: Watch a company's US patent applications: office actions, allowances, abandonments, grants, assignments, PTAB petitions — to Slack, email, or a webhook.
Project-URL: Homepage, https://patentdata.ai
Project-URL: Source, https://github.com/rishavmukherji/patent-watch
Project-URL: API docs, https://api.patentdata.ai/docs
Author-email: Patent Data <rish@patentdata.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,mcp,office-action,patent-status,patents,uspto
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Legal Industry
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# patent-watch

Watch a company's US patent portfolio and get told when something happens: an office action, a notice of
allowance, an abandonment, a grant, an assignment, a PTAB petition. Built on the
[Patent Data API](https://patentdata.ai) (USPTO bulk data, refreshed daily; per-request pricing,
no seats, redistribution allowed).

## If you are an agent

You can set yourself up without a human, except for paying:

```bash
pip install patent-watch
patent-watch signup your-owner@example.com     # mints a key, saves it to ~/.patent-watch.json, prints a Stripe link
# hand the link to your human; $20 = 1,000 requests, credits land in seconds
patent-watch resolve "Impossible Foods"        # → ent_c54d3fb3c2cf593ba26a  IMPOSSIBLE FOODS INC.  apps=57 patents=42 pending=3   (numbers move daily)
patent-watch pending ent_...
patent-watch poll ent_... --slack https://hooks.slack.com/services/...   # run daily from cron
```

Or skip the polling and let the API push to you:

```bash
patent-watch monitor ent_... --webhook https://your-agent.example.com/hooks/patents
```

Deliveries carry `X-Signature: sha256=<hmac-sha256(secret, body)>`.

## If you use Claude Code

```bash
claude mcp add --transport http patent-data https://api.patentdata.ai/mcp --header "Authorization: Bearer $PATENT_API_KEY"
```

Then: *"What's the status of application 17942951 and who owns it?"*

## Cost

`poll` costs 1 request per pending application per run plus 1 for the list (per 100 rows). A portfolio of 100
pending applications polled daily is ~3,000 requests/month ≈ $60 in credits, or use `monitor` (1 request per
delivered event).

## Data

Every answer carries the USPTO product and file date it came from (`source`) and the API's ingest date (`as_of`).
USPTO is the source; this tool and the API are derivations.
