SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillslinkfox-zhihuiya-description-data-translated

linkfox-zhihuiya-description-data-translated

Writing & research

View repository

Updated 10-15 18:03

About this skill

Zhihuiya Patent Description (Translated)

This skill guides you on how to retrieve translated patent description (specification) text via the Zhihuiya data service. It supports translation into Chinese, English, or Japanese, and can look up patents by patent ID or publication number.

Core Concepts

A patent description (also called "specification") is the full technical text of a patent document. This tool fetches the translated version of that text from the Zhihuiya patent database, supporting three target languages: Chinese (cn), English (en), and Japanese (jp).

When a patent's description is unavailable, the tool can optionally substitute it with a description from a patent family member (a related patent filed in another jurisdiction covering the same invention).

Parameters

Parameter Type Required Description
patentId string Conditionally Patent ID. At least one of patentId or patentNumber must be provided. If both are given, patentId takes priority. Multiple values separated by commas; max 100.
patentNumber string Conditionally Publication (announcement) number. At least one of patentId or patentNumber must be provided. Multiple values separated by commas; max 100.
lang string No Target translation language. Supported values: en (English, default), cn (Chinese), jp (Japanese).
replaceByRelated integer No Whether to substitute with a patent family member's description when the original is unavailable. 1 = yes, 0 = no (default).

Key Rules

  1. At least one identifier required: Either patentId or patentNumber must be provided. If the user gives a publication number like "US10123456B2", use patentNumber. If they give a numeric patent ID, use patentId.
  2. Priority: When both identifiers are supplied, patentId takes precedence.
  3. Batch queries: Up to 100 patents can be queried at once by passing comma-separated values.
  4. Default language: If the user does not specify a language, default to en (English).

How to call

  • API endpoint：POST /zhihuiya/descriptionDataTranslated(for full parameters/responses/error codes, see references/api.md）
  • Python script：python scripts/zhihuiya_description_translated.py '<JSON 参数>' [--inline]
  • Cost constraints: This tool consumes compute; 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 full response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-description-data-translated-<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 an error is reported if the current directory is not writable)
  • Response body ≤ 8 KB: after saving to disk, print the full 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 the context.

Resolve authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide 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 compute or balance: The message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or content with a similar meaning.

Usage Examples

1. Get English translation of a patent description by publication number

patentNumber: "US10123456B2"
lang: "en"

2. Get Chinese translation of a patent description by patent ID

patentId: "abc123def"
lang: "cn"

3. Batch query with family member fallback

patentNumber: "US10123456B2,EP3456789A1,CN112345678A"
lang: "en"
replaceByRelated: 1

4. Japanese translation of a specific patent

patentNumber: "JP2021012345A"
lang: "jp"

Display Rules

  1. Present the translated text clearly: Show the patent description text directly. For long descriptions, present a summary or the first section and inform the user the full text is available.
  2. Identify substitutions: When pnRelated is present in the response, clearly inform the user that the description was sourced from a family member patent and show the related publication number.
  3. Batch results: When multiple patents are returned, present them in a structured list with clear separation between each patent's description.
  4. Error handling: Report the actual error. An empty translation result does not establish that the patent is absent or that all same-language requests are unsupported. For an original specification, use /zhihuiya/descriptionData and verify the returned patent and text language. Keep the requested target language; do not silently switch it or substitute a family patent.
  5. No fabrication: Never invent or paraphrase patent text. Only display what the API returns.

User Expression & Scenario Quick Reference

Applicable -- Patent description/specification translation queries:

User Says Scenario
"Translate this patent description to English" Single patent translation
"I need the Chinese version of patent US10123456" Specific language translation
"Get me the specification text for these patents" Batch patent description retrieval
"What does patent CN112345678A describe?" Patent description lookup
"Show me the Japanese translation of this patent's full text" Japanese translation
"The description is missing, can you try a family member?" Family member fallback

Not applicable -- Needs beyond patent description translation:

  • Patent search or discovery (finding patents by keyword/topic)
  • Patent claim analysis or claim chart generation
  • Patent legal status or prosecution history
  • Patent citation or reference analysis
  • Patent portfolio analytics or statistics

Compute consumption rules

Billed according to dynamic rules: compute consumed = 81 × number of returned data entries. Each entry is 1 patent specification translation result

Important: The service of this skill is calculated dynamically by a multiplier and may consume a large amount of compute 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.