Zhihuiya Patent Citations Explorer

This skill guides you on how to query patent citation data from Zhihuiya (PatSnap), helping users understand the citation landscape of specific patents.

Core Concepts

Patent citation analysis reveals how influential a patent is within its technology domain. When Patent B references Patent A in its prior art section, Patent A is said to be "cited by" Patent B. A higher citation count generally indicates greater technological significance and broader industry influence.

Key metrics:

• 3-year citations (citedBy3y): Number of times the patent was cited within 3 years of publication. Indicates early-stage impact.
• 5-year citations (citedBy5y): Number of times the patent was cited within 5 years. Indicates medium-term influence.
• Simple family citations (citedBySimpleFamily): Count of simple patent family members that cite the patent.
• INPADOC family citations (citedByInpadocFamily): Count of INPADOC patent family members that cite the patent.
• PatSnap family citations (citedByPatsnapFamily): Count of PatSnap-defined patent family members that cite the patent.

Parameter Guide

You must provide at least one of the following identifiers. If both are supplied, patent ID takes priority.

Parameter	Description	Example
patentId	Zhihuiya internal patent IDs; up to 100 comma-separated values.	abc123def456
patentNumber	Publication / announcement number. Single publication/announcement number only. Do NOT pass comma-separated multiple numbers.	US10123456B2

Important: At least one of patentId or patentNumber is required. When the user provides a publication number (e.g., "US10123456B2"), use patentNumber. When they provide internal IDs, use patentId.

Batch limit: patentId or patentNumber may contain up to 100 comma-separated values. Because the endpoint consumes significant credits, confirm the intended batch before submitting a multi-patent request.

Usage Examples

1. Single patent citation lookup by publication number Query: "How many citations does patent US10123456B2 have?"

{
  "patentNumber": "US10123456B2"
}

3. Lookup by patent ID Query: "Get citation data for patent ID abc123def456"

{
  "patentId": "abc123def456"
}

Display Rules

1. Present data in tables: Show citation results in clear, structured tables. Include the publication number, 3-year citations, 5-year citations, and family citation counts.
2. Highlight key metrics: For each returned patent, highlight citation counts across the 3-year, 5-year, and family metrics.
3. Explain family types: If the user is unfamiliar with patent families, briefly explain the difference between Simple, INPADOC, and PatSnap family definitions.
4. Citing patent details: If the response includes a citedByPatents array with details of citing patents, present them in a sub-table or expandable list.
5. Error handling: When a query fails, explain the reason based on the response and suggest checking whether the patent number or ID is correct.
6. No subjective advice: Present factual citation data without making judgments about patent value or investment decisions.

Calling the Tool

• API Endpoint: /zhihuiya/patentCited (full parameters/responses/error codes in references/api.md)
• Python Script: python scripts/patent_cited_by.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-cited-by-<timestamp>.json (<cwd> is the working directory when the script executes, which in Claude Code is the current project directory; <session> is taken from the SESSION_ID environment 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 --inline to 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_KEY environment 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_KEY environment variable. If credentials are missing or expire, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to top up credits. For onboarding and setup guidance, refer to https://skill.nexscope.com/nexscopeskills/guide.htm

User Expression & Scenario Quick Reference

Applicable -- Patent citation analysis scenarios:

User Says	Scenario
"How many times has this patent been cited"	Basic citation count
"Which patents cite this one"	Citing patent list
"Patent influence analysis"	Citation-based impact
"3-year / 5-year citation count"	Time-windowed citation metrics
"Patent family citation data"	Family-level citation analysis
"Forward citations for patent X"	Synonym for cited-by lookup

Not applicable -- Needs beyond patent citation data:

• Patent full-text search or semantic search
• Patent legal status or prosecution history
• Patent valuation or licensing recommendations
• Backward citations (references made by a patent)