nexscope-ai/nexscope-ecommerce-skills / ecommerce-patent-description-data
ecommerce.patent-description-data
VerifiedRetrieve patent description (specification) data from the Nexscope patent database by patent ID or publication number. Triggered when users mention patent specification, patent full text, patent technical description, patent embodiment details, Nexscope specification data, patent specification, patent full text, technical description, embodiment details, Nexscope, or patent detailed description. Even if the user does not explicitly say "Nexscope," this skill should be triggered whenever they need to view the complete specification/description content of one or more patents.
Nexscope Patent Description Data
This skill guides you on how to query patent description (specification) data from the Nexscope patent database, helping users retrieve the full-text description content of specific patents.
Core Concepts
A patent description (also called the specification) is the detailed technical document that accompanies a patent filing. It discloses how the invention works, preferred embodiments, and other technical details required by patent law. This tool queries the Nexscope database to return description data for a single patent per request, identified by its internal patent ID or public publication number.
Identifier priority: When both a patent ID and a publication number are provided for the same query, the patent ID takes precedence.
Family substitution: If the description for a given patent is unavailable, the tool can optionally return the description from a related family member patent instead.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| patentId | string | Conditionally | Internal patent ID. At least one of patentId or patentNumber must be provided. This Skill sends one patent ID per call; the gateway accepts up to 100 comma-separated IDs. |
| patentNumber | string | Conditionally | Publication / announcement number. At least one of patentId or patentNumber must be provided. This Skill sends one publication number per call; the gateway accepts up to 100 comma-separated numbers. |
| replaceByRelated | string | No | Whether to substitute a family patent's description when the target patent's description is unavailable. 1 = yes, 0 = no. |
Skill single-patent policy: This endpoint consumes credits. If you need to check multiple patents, you must obtain explicit user consent and make separate requests. This Skill uses one patent per call; the gateway supports up to 100 English comma-separated identifiers.
Response Fields
| Field | Type | Description |
|---|---|---|
| total | integer | Number of patent records returned |
| data | array | List of patent description objects |
| data[].patentId | string | Patent ID |
| data[].pn | string | Publication number |
| data[].pnRelated | string | Publication number of the substitute family patent (only present when family substitution is used) |
| data[].description | array | Description / specification content sections |
| columns | array | Column definitions for rendering |
| costToken | integer | Tokens consumed by the query |
| type | string | Rendering style hint |
Invocation
- API Endpoint:
POST /zhihuiya/descriptionData(full parameters/response/error codes inreferences/api.md) - Python Script:
python scripts/patent_description_data.py '<JSON params>' [--inline] - Cost Constraints: This tool consumes credits. The same parameter combination defaults to a single call per session. The script includes a 24-hour local cache. Do not automatically retry with different keywords, pagination, or modified parameters on failure or empty results; inform the user that additional costs will be incurred before continuing to search. Skill single-patent policy: This endpoint consumes credits. This Skill uses one patent per call to control credits. For multiple patents, obtain explicit user consent before separate calls; the gateway supports up to 100 per request.
Output Strategy (default script behavior):
- Always write the full response to
<cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-zhihuiya-description-data-<timestamp>.json(<cwd>is the working directory at script execution time, which in Claude Code is the current project directory;<session>is taken from theSESSION_IDenvironment variable, auto-grouped by user task; writing to /tmp is forbidden -- error if the current directory is not writable) - Response body <= 8 KB: print the full JSON to stdout after writing to disk
- Response body > 8 KB: print only a summary to stdout after writing to disk (top-level fields, common counts like
total/costToken, length of the largest list field + first 3 samples) - Add
--inlineto force full output to stdout (still writes to disk)
Data Reading Tip: Check the summary first to determine if it is sufficient; when specific fields are needed, prefer using jq or ConvertFrom-Json to extract from the saved JSON file on demand to avoid loading the entire JSON into context.
Authentication
Set NEXSCOPE_API_KEY. Visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to manage credits.
How to Build Queries
Querying by Publication Number
When users provide a patent publication number (e.g., CN115099012A, US20230012345A1), pass it via the patentNumber parameter:
patentNumber: "CN115099012A"
Querying by Patent ID
When users provide internal Nexscope patent IDs, pass them via the patentId parameter:
patentId: "abc123def456"
Single-Patent Queries
This Skill sends one patent per call to control credits. For multiple patents, obtain explicit consent before separate calls; the gateway accepts up to 100 per request. Do NOT pass comma-separated values to patentId or patentNumber.
patentNumber: "CN115099012A"
Family Substitution
When a patent's description is not available in the database and the user still wants content, enable family substitution:
patentNumber: "CN115099012A"
replaceByRelated: "1"
Usage Examples
1. Look up a single patent description by publication number
patentNumber: "CN115099012A"
2. Look up with family substitution enabled
patentNumber: "CN115099012A"
replaceByRelated: "1"
3. Look up by patent ID
patentId: "some-patent-id"
Display Rules
- Present data faithfully: Show the returned description content clearly without altering technical details or adding subjective interpretation.
- Structured output: When the description contains multiple sections (background, summary, detailed description, claims, etc.), present them with clear headings for readability.
- Family substitution notice: If the response includes a
pnRelatedfield, explicitly inform the user that the description was sourced from a related family patent and state the substitute publication number. - Single-patent results: Results contain a single patent's data per call. If the user needs multiple patents, make separate single-patent calls (with explicit consent).
- Error handling: When a query fails or returns no data, explain the reason and suggest the user verify the patent ID or publication number.
- Large content warning: Patent descriptions can be very long. Summarize key sections first and offer to show the full text if the user wants it.
Important Limitations
- Identifier requirement: At least one of
patentIdorpatentNumbermust be provided; the tool cannot search by keyword or applicant name. - Skill request policy: This Skill uses one patent per call to control credits; the gateway accepts up to 100 English comma-separated identifiers.
- Availability: Not all patents have descriptions available in the database. Use
replaceByRelated: "1"to attempt family substitution when needed. - Priority rule: If both
patentIdandpatentNumberare supplied,patentIdtakes precedence.
User Expression & Scenario Quick Reference
Applicable -- Queries about patent description / specification content:
| User Says | Scenario |
|---|---|
| "Show me the description of patent XX" | Single patent description lookup |
| "I need the detailed text of CN115099012A" | Lookup by publication number |
| "Can you find a family patent's description instead" | Family substitution query |
| "What does this patent describe technically" | Description content review |
Not applicable -- Needs beyond patent description data:
- Patent search by keyword, applicant, or classification
- Patent claim analysis or claim chart generation
- Patent legal status or prosecution history
- Patent landscape or statistical analysis
- Freedom-to-operate or infringement opinions
API Key request rate
All Nexscope API Keys belonging to the same user share one request-rate allowance for public API execution. The allowance is measured over any rolling 1-second window. Your RPS depends on your account entitlements; do not assume every user has a fixed 1 RPS. A single Skill operation may make multiple public API requests, and each request uses this allowance.
If an execution request returns HTTP 429 with outer code 13012, the request-rate allowance was exceeded. Honor the returned Retry-After before considering another request. Outer code 13013 means the concurrent-request limit was exceeded, not the rate limit; honor its Retry-After when supplied. Inspect the response and reconcile state before retrying. Never automatically replay a write operation or a request whose outcome is unclear.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |