alterlab-uspto — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited alterlab-uspto (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
USPTO provides specialized APIs for patent and trademark data. Search patents by keywords/inventors/assignees, retrieve examination history via PEDS, track assignments, analyze citations and office actions, access TSDR for trademarks, for IP analysis and prior art searches.
This skill should be used when:
The USPTO provides multiple specialized APIs for different data needs:
https://search.patentsview.org/api/v1/uspto-opendata-python Python libraryhttps://tsdrapi.uspto.gov/ts/cd/USPTO APIs require an API key. Register at: https://account.uspto.gov/api-manager/
API key for PatentSearch API is provided by PatentsView. Register at: https://patentsview.org/api-v01-information-page
Set the API key as an environment variable:
export USPTO_API_KEY="your_api_key_here"
export PATENTSVIEW_API_KEY="your_api_key_here"This skill includes Python scripts for common operations:
The PatentSearch API uses a JSON query language with various operators (_text_all/_text_any/_text_phrase, comparison _gte/_lte, logical _and/_or/_not). Best practice: use _text_* operators for text fields (more performant than _contains/_begins).
The scripts/patent_search.py PatentSearchClient wraps the common cases: search by keywords, inventor, assignee, date range, or CPC classification, plus advanced_search(...) to combine criteria. For full control, POST a JSON query to https://search.patentsview.org/api/v1/patent with an X-Api-Key header.
Available patent endpoints: /patent (granted), /publication (pregrant), /inventor, /assignee, /cpc_subclass, /cpc_at_issue, /uspc, /ipc, and text endpoints /claims, /brief_summary_text, /detail_description_text (beta).
See references/usage_examples.md (Task 1) for worked client and direct-API code, and references/patentsearch_api.md for the complete endpoint/field reference, query syntax, response formats, rate limits, and best practices.
PEDS provides comprehensive prosecution history: transaction events, status changes, and examination timeline. Install the library with uv pip install uspto-opendata-python.
The scripts/peds_client.py PEDSHelper covers application/patent lookup, transaction history, office actions, status summary, and analyze_prosecution.
Common transaction codes: CTNF (non-final rejection), CTFR (final rejection), NOA (notice of allowance), WRIT (response filed), ISS.FEE (issue fee), ABND (abandoned), AOPF (office action mailed).
See references/usage_examples.md (Task 2) for worked code and references/peds_api.md for the full data-field and transaction-code reference, library usage, and portfolio-analysis examples.
Access trademark status, ownership, and prosecution history. The scripts/trademark_client.py TrademarkClient looks up marks by serial or registration number, fetches status, runs check_trademark_health, and supports portfolio monitoring.
Common statuses: REGISTERED, PENDING, PUBLISHED FOR OPPOSITION, ABANDONED, CANCELLED, SUSPENDED, REGISTERED AND RENEWED.
See references/usage_examples.md (Task 3) for worked code and references/trademark_api.md for the TSDR + Trademark Assignment Search references, status codes, prosecution history, and ownership tracking.
Both patents and trademarks have Assignment Search APIs for tracking ownership changes.
Patent Assignment API base URL: https://assignment-api.uspto.gov/patent/v1.4/ — search by patent number (returns XML) or by company name (assigneeName criteria). Use an X-Api-Key header.
Common assignment types: ASSIGNMENT OF ASSIGNORS INTEREST (ownership transfer), SECURITY AGREEMENT, MERGER, CHANGE OF NAME, ASSIGNMENT OF PARTIAL INTEREST.
See references/usage_examples.md (Task 4) for worked request/XML-parsing code.
Multiple specialized APIs provide additional patent data.
#### Office Action Text Retrieval
Retrieve full text of office actions using application number. Integrate with PEDS to identify which office actions exist, then retrieve full text.
#### Enriched Citation API
Analyze patent citations:
#### Patent Litigation Cases API
Access federal district court patent litigation records:
#### PTAB API
Patent Trial and Appeal Board proceedings:
See references/additional_apis.md for comprehensive documentation on:
For full patent intelligence, combine APIs: use PatentSearch for the patent record, PEDS (analyze_prosecution + get_status_summary) for examination history, and the Patent Assignment API for ownership, then merge for citations and pendency. A complete comprehensive_patent_analysis(...) implementation is in references/usage_examples.md (Complete Analysis Example).
_text_* operators for text fields (more performant)search.patentsview.org/docs/ host is being retired as part of the USPTO Open Data Portal (ODP) consolidation; consult this page for the migration path and current endpoint references.references/usage_examples.md - Worked Python examples per task (search, PEDS, trademarks, assignments, full analysis)references/patentsearch_api.md - Complete PatentSearch API referencereferences/peds_api.md - PEDS API and library documentationreferences/trademark_api.md - Trademark APIs (TSDR and Assignment)references/additional_apis.md - Citations, Office Actions, Litigation, PTABscripts/patent_search.py - PatentSearch API clientscripts/peds_client.py - PEDS examination data clientscripts/trademark_client.py - Trademark search client~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.