patent-watch 0.1.0__tar.gz

patent_watch-0.1.0/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+dist/
+.venv/

patent_watch-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Calidran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

patent_watch-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.5
+Name: patent-watch
+Version: 0.1.0
+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/calidran/patent-watch
+Project-URL: API docs, https://api.patentdata.ai/docs
+Author-email: Calidran <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_...  Impossible Foods Inc.  apps=412 patents=180 pending=95
+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.

patent_watch-0.1.0/README.md

@@ -0,0 +1,46 @@
+# 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_...  Impossible Foods Inc.  apps=412 patents=180 pending=95
+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.

patent_watch-0.1.0/patent_watch.py

@@ -0,0 +1,166 @@
+"""
+patent-watch — a small agent over the patent-status API (https://github.com/calidran/patent-api).
+
+    patent-watch signup you@example.com            # gets a key; prints the Stripe link to fund it ($20 = 1,000 requests)
+    patent-watch resolve "Impossible Foods"         # company name -> entity id + counts
+    patent-watch pending ent_...                    # the entity's pending applications
+    patent-watch poll ent_... --slack $WEBHOOK      # diff against last run; notify on new events (run from cron)
+    patent-watch monitor ent_... --webhook URL      # server-side monitor: the API pushes signed events to your URL
+
+Config: PATENT_API_KEY (or ~/.patent-watch.json written by `signup`), PATENT_API_URL (default https://api.patentdata.ai).
+State for `poll` lives in ~/.patent-watch-state.json (last seen transaction per application).
+"""
+from __future__ import annotations
+
+import json
+import os
+import sys
+from datetime import date
+from pathlib import Path
+
+import click
+import httpx
+
+CONFIG = Path.home() / ".patent-watch.json"
+STATE = Path.home() / ".patent-watch-state.json"
+EVENTS = ("office_action", "allowance", "abandonment", "grant", "publication", "assignment", "ptab_petition")
+
+
+def base_url() -> str:
+    return os.environ.get("PATENT_API_URL", "").strip() or _config().get("url") or "https://api.patentdata.ai"
+
+
+def _config() -> dict:
+    return json.loads(CONFIG.read_text()) if CONFIG.exists() else {}
+
+
+def api_key() -> str:
+    key = os.environ.get("PATENT_API_KEY", "").strip() or _config().get("api_key")
+    if not key:
+        raise click.ClickException("no API key: run `patent-watch signup <owner-email>` or set PATENT_API_KEY")
+    return key
+
+
+def client() -> httpx.Client:
+    return httpx.Client(base_url=base_url(), headers={"X-API-KEY": api_key()}, timeout=30)
+
+
+def get(c: httpx.Client, path: str, **params) -> dict:
+    r = c.get(path, params={k: v for k, v in params.items() if v is not None})
+    if r.status_code == 402:
+        body = r.json()
+        raise click.ClickException(f"key not funded: {body['checkout']} (min ${body['minimum_usd']}); run `patent-watch fund`")
+    if r.status_code >= 400:
+        raise click.ClickException(f"{r.status_code} {r.text[:300]}")
+    return r.json()
+
+
+@click.group(help=__doc__)
+def cli() -> None:
+    pass
+
+
+@cli.command(help="Create an API key for this agent under your (human) email. Prints the funding link.")
+@click.argument("owner_email")
+@click.option("--agent-name", default="patent-watch")
+@click.option("--url", default=None, help="API base URL")
+def signup(owner_email: str, agent_name: str, url: str | None) -> None:
+    u = url or base_url()
+    r = httpx.post(f"{u}/agent/signup", json={"owner_email": owner_email, "agent_name": agent_name}, timeout=30)
+    if r.status_code >= 400:
+        raise click.ClickException(f"{r.status_code} {r.text[:300]}")
+    data = r.json()
+    CONFIG.write_text(json.dumps({"api_key": data["api_key"], "org_id": data["org_id"], "url": u}, indent=1))
+    CONFIG.chmod(0o600)
+    click.echo(f"saved key to {CONFIG} (org {data['org_id']})")
+    fund_link(u, data["api_key"])
+
+
+def fund_link(u: str, key: str, amount: int = 20) -> None:
+    r = httpx.post(f"{u}/agent/checkout-link", json={"amount_usd": amount}, headers={"X-API-KEY": key}, timeout=30)
+    if r.status_code == 503:
+        click.echo("billing is not configured on this server yet; ask the operator for credits")
+        return
+    r.raise_for_status()
+    click.echo(f"fund it here (${amount} = {amount * 50} requests, no expiry): {r.json()['url']}")
+
+
+@cli.command(help="Print a Stripe link to add credits.")
+@click.option("--amount", default=20, type=int)
+def fund(amount: int) -> None:
+    fund_link(base_url(), api_key(), amount)
+
+
+@cli.command(help="Resolve a company or inventor name to entity ids.")
+@click.argument("name")
+@click.option("--type", "type_", type=click.Choice(["assignee", "inventor"]), default=None)
+def resolve(name: str, type_: str | None) -> None:
+    with client() as c:
+        for e in get(c, "/v1/entities/search", q=name, type=type_, limit=10)["entities"]:
+            cnt = e["counts"]
+            click.echo(f"{e['entity_id']}  {e['canonical_name']:50s} apps={cnt['applications']} patents={cnt['patents']} pending={cnt['pending']}  ({e['source']})")
+
+
+@cli.command(help="List an entity's pending applications.")
+@click.argument("entity_id")
+def pending(entity_id: str) -> None:
+    with client() as c:
+        for a in _all_pending(c, entity_id):
+            click.echo(f"{a['application_number']}  {a['filing_date']}  {a['status']['description'][:45]:45s}  {a['title'][:60]}")
+
+
+def _all_pending(c: httpx.Client, entity_id: str) -> list[dict]:
+    out, cursor = [], None
+    while True:
+        page = get(c, f"/v1/entities/{entity_id}/applications", status="pending", limit=100, cursor=cursor)
+        out += page["applications"]
+        cursor = page.get("next_cursor")
+        if not cursor:
+            return out
+
+
+@cli.command(help="Diff each pending application's timeline against the last run and notify on new events. Cron-friendly.")
+@click.argument("entity_id")
+@click.option("--slack", "slack_webhook", default=None, help="Slack incoming-webhook URL")
+@click.option("--since-days", default=30, help="On first run, look back this many days")
+def poll(entity_id: str, slack_webhook: str | None, since_days: int) -> None:
+    state = json.loads(STATE.read_text()) if STATE.exists() else {}
+    seen: dict[str, str] = state.setdefault(entity_id, {})
+    lines = []
+    with client() as c:
+        for a in _all_pending(c, entity_id):
+            n = a["application_number"]
+            since = seen.get(n) or (date.fromordinal(date.today().toordinal() - since_days)).isoformat()
+            tl = get(c, f"/v1/applications/{n}/transactions", since=since)
+            new = [t for t in tl["transactions"] if t["event_type"] in EVENTS and (t["date"] > since or n not in seen)]
+            for t in sorted(new, key=lambda t: t["date"]):
+                lines.append(f"{t['date']}  {t['event_type']:14s} {n}  {a['title'][:50]}  ({t['code']}: {t['description']})")
+            if tl["transactions"]:
+                seen[n] = max(t["date"] for t in tl["transactions"])
+            elif n not in seen:
+                seen[n] = since
+    STATE.write_text(json.dumps(state, indent=1))
+    if not lines:
+        click.echo("no new events")
+        return
+    text = "\n".join(lines)
+    click.echo(text)
+    if slack_webhook:
+        httpx.post(slack_webhook, json={"text": f"patent-watch {entity_id}:\n```{text}```"}, timeout=30).raise_for_status()
+
+
+@cli.command(help="Create a server-side monitor: the API POSTs signed events to your webhook the night they appear.")
+@click.argument("entity_id")
+@click.option("--webhook", required=True)
+@click.option("--events", default=",".join(EVENTS), show_default=True)
+def monitor(entity_id: str, webhook: str, events: str) -> None:
+    with client() as c:
+        r = c.post("/v1/monitors", json={"targets": {"entity_ids": [entity_id]}, "events": events.split(","), "webhook_url": webhook})
+        if r.status_code >= 400:
+            raise click.ClickException(f"{r.status_code} {r.text[:300]}")
+        m = r.json()
+        click.echo(f"monitor {m['monitor_id']} created; verify X-Signature with secret: {m['secret']}")
+
+
+if __name__ == "__main__":
+    cli()

patent_watch-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "patent-watch"
+version = "0.1.0"
+description = "Watch a company's US patent applications: office actions, allowances, abandonments, grants, assignments, PTAB petitions — to Slack, email, or a webhook."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Calidran", email = "rish@patentdata.ai" }]
+keywords = ["patents", "uspto", "patent-status", "office-action", "mcp", "agents"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Legal Industry",
+  "Programming Language :: Python :: 3",
+  "Topic :: Office/Business",
+]
+requires-python = ">=3.11"
+dependencies = ["httpx>=0.27", "click>=8.1"]
+
+[project.urls]
+Homepage = "https://patentdata.ai"
+Source = "https://github.com/calidran/patent-watch"
+"API docs" = "https://api.patentdata.ai/docs"
+
+[project.scripts]
+patent-watch = "patent_watch:cli"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["patent_watch.py"]

patent_watch-0.1.0/uv.lock

@@ -0,0 +1,104 @@
+version = 1
+revision = 3
+requires-python = ">=3.11"
+
+[[package]]
+name = "anyio"
+version = "4.15.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.15'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a9/d2/f4d173e22df740bc37b1db102b386ba719b66e95b0f0d751f556b387e6d2/anyio-4.15.1.tar.gz", hash = "sha256:9f28306018cbd6d329e64a36d58256edff76dd996fe423bc957326e578b82a94", size = 276966, upload-time = "2026-09-05T10:42:39.44Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/b8/4bd346e22b28902df4d651910f5242c28d84e4a5c2435ca5c3f797ed7e2e/anyio-4.15.1-py3-none-any.whl", hash = "sha256:6152fdbbf9a77fdec97731721bebf7c4c44f7c29b424b0065826173efc7ed101", size = 132079, upload-time = "2026-09-05T10:42:37.923Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.7.22"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a3/c2/24167ea9858356b47a87a50d39908bfdb72ceeefe0041586e704e5376b3a/certifi-2026.7.22.tar.gz", hash = "sha256:741e2c3b351ddf169a738da9f2c048608ff7f2c5cc02f1ebc6b118bb090d5d55", size = 138112, upload-time = "2026-07-22T03:35:12.644Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0b/a7/71ac2cff56fec219ed242bb11b8efb69fcc4bec75db06fb7bfe35de520e6/certifi-2026.7.22-py3-none-any.whl", hash = "sha256:62f22742b58a1a33014a2b6b706588a8d7e2a88ae7bd1a6ebe8c992928483775", size = 136983, upload-time = "2026-07-22T03:35:11.276Z" },
+]
+
+[[package]]
+name = "click"
+version = "8.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c7/0e/7fa0ef50764b67090eca4114772a2abf8b6148198475e54c660b97caeee6/click-8.5.0.tar.gz", hash = "sha256:ba0d2089de75ea0310e2dde03160e6ca10009947fb95a182f9b54021bb272e34", size = 382235, upload-time = "2026-08-26T13:33:14.56Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/58/50/6c0d534c5f134586a8e1ba4e330569e32f057e33372ae556463212fb4cd3/click-8.5.0-py3-none-any.whl", hash = "sha256:255bc9599cf7748b4b1a446ccc735421bd08a2ae529a8b88597d3de5664ee360", size = 125251, upload-time = "2026-08-26T13:33:12.928Z" },
+]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.19"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/5f/f7/abb373e5757eaec4b922b92f97ec8d6d7e057cf06778247604fbc4e7c3f3/idna-3.19.tar.gz", hash = "sha256:5e0811a4383b21dc5838069f801c4fb62113b7447663d2530d2bd6e77b49bf15", size = 215237, upload-time = "2026-08-18T05:14:24.27Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/57/b0/0e52c878c53f245edd3a11020f20979b3f490f245af532c7cae3027754b5/idna-3.19-py3-none-any.whl", hash = "sha256:815e7be7a7806d54abb586dc943addc79e8b2ee16915059658cbeff4b1b43bf4", size = 68550, upload-time = "2026-08-18T05:14:22.343Z" },
+]
+
+[[package]]
+name = "patent-watch"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "click" },
+    { name = "httpx" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "click", specifier = ">=8.1" },
+    { name = "httpx", specifier = ">=0.27" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f6/cc/6253133b5bb138fc3306cebfbda2c520f545d36b5be2c7255cc528bb45d6/typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5", size = 113555, upload-time = "2026-07-02T08:40:05.92Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" },
+]