nexscope-ai/nexscope-ecommerce-skills / ecommerce-patent-claims
ecommerce.patent-claims
VerifiedRetrieves patent claims data from Nexscope (Nexscope). Trigger when the user mentions patent claims, claim text, independent claims, dependent claims, claim count, claims tree, claims analysis, claim scope, claim language, viewing the claims section of a specific patent, patent claims, independent claims, dependent claims, claims text, Nexscope. Also trigger when the user requests patent claims information by patent ID or publication number, even without explicitly mentioning Nexscope or Nexscope.
Nexscope Patent Claims Data
This skill guides you on how to retrieve and present patent claims data from the Nexscope (Nexscope) patent database, helping IP professionals, patent analysts, and R&D teams quickly access the claims section of any patent.
Calling the Tool
- API Endpoint:
/zhihuiya/claimData(full parameters/responses/error codes inreferences/api.md) - Python Script:
python scripts/patent_claims.py '<JSON params>' [--inline] - Cost constraint: This tool consumes credits. Within the same session and same parameter combination, it defaults to a single call with a 24-hour local cache. Do not automatically retry with different keywords, pagination, or parameters on failure/empty results. Inform the user of additional credit consumption before continuing retrieval.
Output strategy (script default behavior):
- Always write the full response to
<cwd>/nexscope/<YYYY-MM-DD>/<session>/data/ecommerce.patent-claims-<timestamp>.json(<cwd>is the working directory when the script executes, which in Claude Code is the current project directory;<session>is taken from theSESSION_IDenvironment variable, automatically grouped by user task; do not write to /tmp; error if the current directory is not writable) - Response body <= 8 KB: write to disk then print full JSON to stdout
- Response body > 8 KB: write to disk then print only a summary to stdout (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)
Reading data: Check the summary first to determine if it is sufficient. When specific fields are needed, use jq or ConvertFrom-Json to extract from the saved JSON file as needed, avoiding loading the entire JSON into context.
Authentication & Credits
If you encounter authentication or credit issues:
Error conditions
- API Key not configured: The
NEXSCOPE_API_KEYenvironment variable is not set. - HTTP 401 or 402 status code
- Insufficient credits/balance: Response message indicates credit balance exhausted, quota exceeded, subscription expired, or recharge required.
Resolution steps
- Set the
NEXSCOPE_API_KEYenvironment variable with a valid API key. - If credits are insufficient, visit https://www.nexscope.ai/pricing?co-from=skillNS to top up your balance.
- For onboarding and setup guidance, refer to https://www.nexscope.ai/help/skills-external-access?co-from=skillNS
Core Concepts
Patent claims define the legal scope of protection granted by a patent. They are the most critical part of a patent document for infringement analysis, freedom-to-operate assessments, and prior art comparisons. This tool retrieves the full set of claims for a single patent by its patent ID or publication number.
Family substitution: When a patent's claims are unavailable in the database, you can optionally request that claims from a related family member patent be returned instead. This is controlled by the replaceByRelated parameter.
Data Fields
| Field | API Name | Description | Example |
|---|---|---|---|
| Patent ID | patentId | Internal Nexscope patent identifier | 98a1b2c3-... |
| Publication Number | pn | Publication or grant number of the patent | CN115000000A |
| Related PN | pnRelated | Publication number of the family member used as substitute (only present when family substitution occurred) | US20230001234A1 |
| Claims | claims | Array of claim objects containing the claim text and metadata | [...] |
| Claim Count | claimCount | Total number of claims in the patent | 15 |
Parameter Guide
Required (at least one)
You must provide at least one of the following two parameters. If both are provided, patentId takes priority.
| Parameter | Description | Format |
|---|---|---|
| patentId | Single patent ID only. Do NOT pass comma-separated multiple IDs | Single string |
| patentNumber | Single publication/announcement number only. Do NOT pass comma-separated multiple numbers | Single string |
Optional
| Parameter | Description | Values |
|---|---|---|
| replaceByRelated | Whether to substitute with a family member's claims when the target patent's claims are unavailable | 1 = yes, 0 = no (default) |
How to Choose Between patentId and patentNumber
- Use patentNumber when the user provides a publication or grant number (e.g.,
CN115000000A,US11234567B2). This is the most common scenario. - Use patentId when the user provides an internal Nexscope identifier, typically obtained from a previous Nexscope search result.
- When the user provides both, pass both and the API will prefer patentId.
Skill single-patent policy: This endpoint consumes credits. To query multiple patents, obtain explicit user consent and make separate calls for each. This Skill sends one patent per call to control credits; the gateway accepts up to 100 English comma-separated identifiers.
Usage Examples
1. Single patent by publication number
{"patentNumber": "CN115000000A"}
3. Single patent by patent ID
{"patentId": "98a1b2c3-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}
4. With family substitution enabled
{"patentNumber": "CN115000000A", "replaceByRelated": "1"}
Display Rules
- Present claims clearly: Display claims in a numbered list preserving the original claim numbering. Use indentation or formatting to distinguish independent claims from dependent claims where possible.
- Highlight claim count: Always state the total number of claims returned for each patent.
- Family substitution notice: If
pnRelatedis present in a result, explicitly inform the user that the claims shown are from a family member patent and provide the family member's publication number. - Single patent results: Results contain a single patent's data; present the output clearly with the publication number as the heading.
- Error handling: When a query fails, explain the reason based on the response and suggest the user verify the patent number format or try enabling family substitution.
- No subjective analysis: Present the raw claim text without legal interpretation unless the user specifically requests analysis.
Important Limitations
- At least one identifier required: Either
patentIdorpatentNumbermust be provided; omitting both will result in an error. - Skill request policy: This Skill uses one patent per call to control credits; the gateway accepts up to 100 English comma-separated identifiers.
- Claims availability: Not all patents have claims data available. Use
replaceByRelated=1to attempt family member substitution when claims are missing. - Claim object structure: The individual claim objects within the
claimsarray may vary in structure depending on the patent office and data source.
User Expression & Scenario Quick Reference
Applicable -- Patent claims retrieval and analysis:
| User Says | Scenario |
|---|---|
| "Show me the claims of patent XX" | Single patent claims lookup |
| "How many claims does patent XX have" | Claim count query |
| "What are the independent claims of XX" | Claims retrieval + display |
| "The claims are not available, try a family member" | Family substitution query |
| "Patent claim scope", "claim language" | Claims retrieval |
Not applicable -- Needs beyond patent claims data:
- Patent search or discovery (finding patents by keyword/topic)
- Patent legal status or prosecution history
- Patent citation or reference analysis
- Patent full-text beyond claims (abstract, description, drawings)
- Freedom-to-operate or infringement opinions (legal advice)
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 |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |