K-Dense-AI · Divyansh151005 · Aug 30, 2026
diff --git a/skills/database-lookup/SKILL.md b/skills/database-lookup/SKILL.md
@@ -4,7 +4,7 @@ description: Query documented public database APIs with explicit endpoints, filt
 allowed-tools: Read Bash
 license: MIT
 metadata:
-  version: "1.3"
+  version: "1.4"
   skill-author: "K-Dense Inc."
 ---
 
@@ -117,7 +117,7 @@ Some databases require API keys or have access restrictions. When an API key is
 | BLS | `BLS_API_KEY` | https://data.bls.gov/registrationEngine/ |
 | NCBI (GEO, Gene) | `NCBI_API_KEY` | https://www.ncbi.nlm.nih.gov/account/settings/ |
 | OpenFDA | `OPENFDA_API_KEY` | https://open.fda.gov/apis/authentication/ |
-| USPTO (PatentsView) | `PATENTSVIEW_API_KEY` | https://patentsview.org/apis/keyrequest |
+| USPTO Open Data Portal (PatentsView bulk) | `USPTO_ODP_API_KEY` | https://data.uspto.gov/apikey |
 | Data Commons | `DATACOMMONS_API_KEY` | Google Cloud Console |
 | Materials Project | `MP_API_KEY` | https://materialsproject.org (free account) |
 | NASA | `NASA_API_KEY` | https://api.nasa.gov (free, DEMO_KEY available) |

diff --git a/skills/database-lookup/references/clinicaltrials.md b/skills/database-lookup/references/clinicaltrials.md
@@ -83,4 +83,22 @@ GET /studies/metadata
 Uses cursor-based pagination via `pageToken` (NOT numeric offsets). Include `countTotal=true` on first request to get total.
 
 ## Rate Limits
-No API key. Be reasonable — a few requests per second. Bulk: https://clinicaltrials.gov/AllAPIJSON.zip
+No API key. Be reasonable — a few requests per second.
+
+## Bulk download
+
+Prefer the v2 `/studies` API with `pageToken` pagination for programmatic
+retrieval. The former bulk URL `https://clinicaltrials.gov/AllAPIJSON.zip`
+returns **404** and must not be used.
+
+For a full-registry **XML** dump, use:
+
+```
+https://clinicaltrials.gov/AllPublicXML.zip
+```
+
+That path redirects to `https://clinicaltrials.gov/api/legacy/public-xml?format=zip`
+and returns `Content-Type: application/zip` (`ctg-public-xml.zip`). Confirm the
+redirect still yields a zip before large downloads; CSV / pipe-delimited export
+options are documented under ClinicalTrials.gov Data API “Download” pages when
+XML is not appropriate.
diff --git a/skills/database-lookup/references/database_selection_guide.md b/skills/database-lookup/references/database_selection_guide.md
@@ -126,8 +126,8 @@ Match the user's intent to the right database(s). Many queries benefit from hitt
 ### Patents & Regulatory
 | User is asking about... | Primary database(s) | Also consider |
 |---|---|---|
-| Patents by keyword or technology | USPTO (PatentsView) | — |
-| Patents by inventor or assignee | USPTO (PatentsView) | — |
+| Patents by keyword or technology | USPTO ODP PatentsView bulk (PatentSearch API paused) | — |
+| Patents by inventor or assignee | USPTO ODP PatentsView bulk (PatentSearch API paused) | — |
 | Patent prosecution status | USPTO (PEDS) | — |
 | Trademark lookup | USPTO (TSDR) | — |
 | SEC company filings, 10-K, 10-Q | SEC EDGAR | — |

diff --git a/skills/database-lookup/references/uspto.md b/skills/database-lookup/references/uspto.md
@@ -1,93 +1,57 @@
 # USPTO Public APIs
 
-## 1. PatentsView API (Primary Patent Search)
+## 1. PatentsView → Open Data Portal (ODP)
 
-The newer Elasticsearch-based API is the recommended endpoint.
+**Status (checked 2026-08-30):** The PatentsView PatentSearch API that lived at
+`https://search.patentsview.org/api/v1/` is **unavailable**. The host no longer
+resolves (NXDOMAIN). USPTO migrated PatentsView onto the Open Data Portal on
+2026-03-20; PatentSearch and related interactive features are paused with no
+published relaunch date. Do **not** call `search.patentsview.org`, do **not**
+register at the old `patentsview.org/apis/keyrequest` flow, and do **not** treat
+legacy `api.patentsview.org` query URLs as live search endpoints (they redirect
+to the transition guide).
 
-### Base URL
+### Current access path
 
-```
-https://search.patentsview.org/api/v1/
-```
-
-**API key required** — register at `https://patentsview.org/apis/keyrequest`
-
-Pass as query parameter: `?api_key=YOUR_KEY`
-
-### Key Endpoints
-
-#### Search patents
-```
-GET or POST /patent/
-```
+Use ODP for PatentsView **bulk datasets** and data dictionaries:
 
-Query parameter `q` accepts a JSON query object.
+- Transition guide: https://data.uspto.gov/support/transition-guide/patentsview
+- PatentsView program page: https://www.uspto.gov/ip-policy/economic-research/patentsview
+- ODP home / bulk directory: https://data.uspto.gov/
 
-Operators: `_eq`, `_neq`, `_gt`, `_gte`, `_lt`, `_lte`, `_begins`, `_contains`, `_text_any`, `_text_all`, `_text_phrase`, `_and`, `_or`, `_not`
-
-Parameters:
-- `q` — JSON query
-- `f` — fields to return (JSON array)
-- `o` — options: `{"size": 25}` for pagination
-- `s` — sort: `[{"patent_date": "desc"}]`
-
-#### Search by keyword
-```
-GET /patent/?q={"_text_any":{"patent_abstract":"autonomous vehicle"}}&f=["patent_id","patent_title","patent_date"]&o={"size":5}&api_key=KEY
-```
-
-#### Search by inventor
-```
-GET /patent/?q={"inventors.inventor_name_last":"Tesla"}&f=["patent_id","patent_title","patent_date"]&api_key=KEY
-```
+| Category | Example tables | ODP bulk dataset page |
+|---|---|---|
+| Granted patents — baseline / disambiguated | `g_patent`, `g_cpc_current`, `g_assignee_disambiguated` | https://data.uspto.gov/bulkdata/datasets/pvgpatdis |
+| Granted patents — long text | `g_brf_sum_text_*`, `g_claims_*`, `g_detail_desc_text_*` | https://data.uspto.gov/bulkdata/datasets/pvgpattxt |
+| Pre-grant publications — baseline / disambiguated | `pg_published_application`, `pg_cpc_current` | https://data.uspto.gov/bulkdata/datasets/pvpgpubdis |
+| Pre-grant publications — long text | `pg_brf_sum_text_*`, `pg_claims_*` | https://data.uspto.gov/bulkdata/datasets/pvpgpubtxt |
+| Sorted (beta) | `g_sorted_applicant`, `pg_sorted_individual` | https://data.uspto.gov/bulkdata/datasets/pvsorted |
+| Annualized | yearly CSV tables | https://data.uspto.gov/bulkdata/datasets/pvannual |
 
-#### Search by assignee
-```
-GET /patent/?q={"assignees.assignee_organization":"Google LLC"}&f=["patent_id","patent_title","patent_date","assignees"]&api_key=KEY
-```
-
-#### Lookup by patent number
-```
-GET /patent/{patent_number}/?api_key=KEY
-```
-
-#### Other entity endpoints
-```
-/inventor/
-/assignee/
-/cpc_group/
-```
-
-### Response Structure
-
-```json
-{
-  "patents": [
-    {
-      "patent_id": "11234567",
-      "patent_title": "...",
-      "patent_date": "2022-03-15",
-      "patent_abstract": "...",
-      "assignees": [{"assignee_organization": "..."}],
-      "inventors": [{"inventor_name_first": "...", "inventor_name_last": "..."}]
-    }
-  ],
-  "count": 1,
-  "total_hits": 8923
-}
-```
+Data dictionaries (when published) are linked from the “Documents and Resources”
+sidebar on each ODP dataset page above.
 
-### Rate Limits
+### Auth for ODP bulk / API access
 
-~45 requests per minute per API key.
+ODP access requires a USPTO.gov account (MFA). Obtain an **ODP** API key from
+https://data.uspto.gov/apikey — previously issued PatentsView PatentSearch keys
+are **not** compatible. Prefer loading the key from `.env` as `USPTO_ODP_API_KEY`
+and sending it with the header ODP documents for its Bulk Datasets API
+(commonly `X-API-KEY`). Never print the key in provenance.
 
-### Important Note
+If the user needs interactive keyword / inventor / assignee **search** rather
+than bulk tables, say clearly that PatentSearch is paused during the ODP
+transition and point them at the transition guide — do not invent a replacement
+search URL.
 
-The user must have a PatentsView API key for this endpoint. If they don't have one, let them know they need to register at `https://patentsview.org/apis/keyrequest`. Load the key from `.env` as `PATENTSVIEW_API_KEY`.
+### Historical note
 
-**Note:** The legacy API at `api.patentsview.org` has been decommissioned (returns 410 Gone). Only the new API above works.
+- Legacy PatentsView REST host `api.patentsview.org` is decommissioned for search;
+  requests redirect to the ODP transition guide.
+- The Elasticsearch PatentSearch base URL `https://search.patentsview.org/api/v1/`
+  must not be used until USPTO republishes an ODP-hosted replacement.
 
-## 3. PEDS — Patent Examination Data System
+## 2. PEDS — Patent Examination Data System
 
 **URL**: `https://ped.uspto.gov/api/queries`
 
@@ -109,7 +73,7 @@ For patent prosecution data (application status, filing dates, examiner info).
 
 No API key required but heavily rate limited. Availability can be unreliable.
 
-## 4. TSDR — Trademark Status & Document Retrieval
+## 3. TSDR — Trademark Status & Document Retrieval
 
 For trademark lookup by serial or registration number (not full-text search).
 
@@ -122,9 +86,10 @@ Returns XML with mark details, status, owner, goods/services, prosecution histor
 
 No API key. Rate limited. No JSON endpoint — responses are XML.
 
-## 5. Limitations
+## 4. Limitations
 
 - **No public REST API for trademark full-text search** (TESS is web-only)
-- PatentsView new API requires registration for an API key
+- **PatentsView PatentSearch API is paused** during the ODP migration; use ODP
+  bulk datasets for PatentsView tables until USPTO republishes search APIs
 - PEDS availability is inconsistent
 - TSDR requires knowing the serial/registration number already