SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillslinkfox-zhihuiya-patent-forward-citation

linkfox-zhihuiya-patent-forward-citation

Data & analytics

View repository

Updated 10-15 09:05

About this skill

Zhihuiya Patent Forward Citation

This skill guides you on how to query patent forward citation data from the Zhihuiya patent database, helping users discover the patents and non-patent literature cited by specific patents during their application process.

Core Concepts

Forward citation refers to the patents and non-patent literature that a given patent has cited in its application documents. This is a fundamental aspect of patent analysis — understanding what prior art a patent references helps assess its novelty, scope, and technological lineage.

  • Patent citations (citedPatents): Other patents referenced by the queried patent.
  • Non-patent literature citations (citedOthers): Academic papers, technical reports, and other non-patent documents referenced by the queried patent.

Parameter Guide

You must provide at least one of the following two parameters. If both are provided, patentId takes priority.

Parameter Type Required Description
patentId string Conditionally Patent ID(s). Multiple values separated by commas. Maximum 100 entries.
patentNumber string Conditionally Publication/announcement number(s). Multiple values separated by commas. Maximum 100 entries.

Rules:

  1. At least one of patentId or patentNumber must be provided.
  2. If both are present, patentId is used preferentially.
  3. Multiple values are separated by commas (English commas).
  4. Each parameter supports up to 100 entries per request.

Response Fields

Field Type Description
total integer Total number of records returned
data array List of patent citation results
data[].patentId string Patent ID of the queried patent
data[].pn string Publication/announcement number
data[].citedPatents array List of cited patent documents
data[].citedOthers array List of cited non-patent literature
columns array Column definitions for rendering
costToken integer Tokens consumed by the query
type string Rendering style hint

How to call

  • API endpoint：POST /zhihuiya/patentForwardCitation(for complete parameters/responses/error codes, see references/api.md）
  • Python script：python scripts/zhihuiya_cited_references.py '<JSON 参数>' [--inline]
  • Cost constraints: This tool consumes computing power; by default, the same parameter combination in the same session is called only once, and the script has a 24h local cache. On failure/empty results, do not automatically try different keywords, paginate, or change the postal code to probe continuously; if you need to continue searching, first explain to the user that additional consumption will be incurred.

Output strategy (default script behavior)：

  • Alwayswrite the complete response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-patent-forward-citation-<timestamp>.json（<cwd> is the working directory when the script is executed, which in Claude Code is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated according to the user's task;writing to /tmp is prohibited, and if the current directory is not writable, report an error)
  • Response body ≤ 8 KB: after saving to disk, print the complete JSON to stdout
  • Response body > 8 KB: after saving to disk, stdout outputs only a summary (top-level fields, common counts such as total/costToken, the length of the largest list field + the first 3 samples)
  • Add --inline to force full printing to stdout (also saved to disk)

Data reading suggestions: first look at the summary to determine whether it is sufficient; when specific fields are needed, prefer to use jqorConvertFrom-Json to extract on demand from the saved json file, avoiding bringing the entire JSON into context.

Resolve authentication and computing power issues

When the following abnormal situations occur, use references/onboarding.md to guide problem resolution:

Abnormal situations

  • API Key not configured: the environment variable is not configured LINKFOX_AGENT_API_KEY, and LINKFOXAGENT_API_KEY。
  • Response 401 or 402 status code
  • Response indicates insufficient computing power or balance: the message contains "insufficient computing power balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with a similar meaning.

Usage Examples

1. Query forward citations by publication number

Look up the forward citations for patent US10000000B2.

Parameters: {"patentNumber": "US10000000B2"}

2. Query forward citations for multiple patents

Find all citations for patents US10000000B2, US9876543B1, and EP3456789A1.

Parameters: {"patentNumber": "US10000000B2,US9876543B1,EP3456789A1"}

3. Query forward citations by patent ID

Retrieve the cited references for patent ID 12345678.

Parameters: {"patentId": "12345678"}

4. Query forward citations using both identifiers

Look up citations for patent ID 12345678 (publication number US10000000B2).

Parameters: {"patentId": "12345678", "patentNumber": "US10000000B2"} (patentId takes priority)

Display Rules

  1. Present data clearly: Show citation results in well-structured tables, separating patent citations from non-patent literature citations.
  2. Summarize counts: Always state the total number of cited patents and cited non-patent literature items.
  3. No fabrication: Only display data returned by the API. Do not infer or fabricate citation details.
  4. Error handling: When a query fails, explain the reason based on the error response and suggest the user verify their patent ID or publication number.
  5. Batch results: When querying multiple patents, organize results by patent so each patent's citations are clearly grouped.
  6. Empty results: If a patent has no citations, explicitly inform the user rather than showing an empty table.

User Expression & Scenario Quick Reference

Applicable -- Patent citation queries:

User Says Scenario
"What patents does XX cite" Forward citation lookup
"Show me the references for patent XX" Citation detail retrieval
"What prior art is cited by XX" Prior art reference query
"List the cited literature for XX" Non-patent literature lookup
"Citation analysis for patent XX" Combined patent + literature citation
"What documents does patent XX reference" General citation query

Not applicable -- Needs beyond forward citation data:

  • Backward/reverse citations (who cites this patent)
  • Patent validity or legal status
  • Patent family analysis
  • Patent full-text search
  • Patent classification or landscape analysis

Computing power consumption rules

Billing follows dynamic rules: computing power consumed = 81 × number of returned data entries. Each entry is 1 patent citation result

Important: the service of this skill is dynamically calculated by a multiplier and may consume a large amount of computing power at once. The user must be reminded, and the user decides whether to continue.

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved

Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.