SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillslinkfox-zhihuiya-utility-patent-image-search

linkfox-zhihuiya-utility-patent-image-search

Design & creation

View repository

Updated 10-16 06:24

About this skill

Zhihuiya Utility Patent Image Search

This skill guides you on how to perform image-based patent similarity searches using the Zhihuiya patent database, helping users identify potentially similar utility model patents. This skill supports utility model patents only; for design patents use linkfox-zhihuiya-patent-image-search.

Core Concepts

Patent Image Search uses visual AI models to compare a given product or design image against a global patent image database. It returns a ranked list of similar patents, enabling users to evaluate infringement risks or conduct prior-art research.

This skill supports utility model patents only:

Type Code Description
Utility Model Patent U Protects the functional shape/structure of a product

Search models for utility model patents:

Model ID Strategy Recommendation
3 Match Shape Shape-only comparison
4 Match Shape/Pattern/Color Recommended for utility model patents (default)

Design patents (model 1/2) are not supported by this skill. Use linkfox-zhihuiya-patent-image-search instead.

Scoring logic: A higher score value means greater visual similarity. When presenting results, sort by score in descending order (highest similarity first) so users can prioritize the most relevant patents for review.

Parameter Guide

Required Parameters

Parameter Description Example
url The image URL to search against https://example.com/product.jpg
patentType Patent type, fixed to U (utility model) by this skill U
model Search model ID: 3 (shape only) or 4 (recommended) 4

Common Optional Parameters

Parameter Description Default
country Patent authority country codes, comma-separated (e.g., CN,US,JP) All countries
legalStatus Legal status codes, comma-separated None
simpleLegalStatus Simple legal status: 0 (expired), 1 (active), 2 (pending) None
assignees Applicant / patent holder name None
applyStartTime Application start date (yyyyMMdd) None
applyEndTime Application end date (yyyyMMdd) None
publicStartTime Publication start date (yyyyMMdd) None
publicEndTime Publication end date (yyyyMMdd) None
limit Number of results to return (1-100) 10
offset Pagination offset (0-1000) 0
field Sort field: SCORE, APD, PBD, ISD SCORE
order Sort order: desc or asc (for APD/PBD/ISD) desc
lang Title language preference: original, cn, en original
preFilter Enable country pre-filtering: 1 (on) / 0 (off) 1
stemming Enable stemming: 1 (on) / 0 (off) 0
mainField Search within title, abstract, claims, description, publication number, application number, applicant, inventor, IPC/UPC/LOC None
includeMachineTranslation Include machine-translated data in search None
scoreExpansion Enable score expansion None
isHttps Return HTTPS image URLs: 1 (yes) / 0 (no) 0
returnImgId Return image IDs in results false

Note: The loc (Locarno classification) parameter applies to design patents only and is not relevant for utility model searches.

Commonly Used Country Codes

Code Country/Region
CN China
US United States
JP Japan
KR South Korea
EP European Patent Office
WO WIPO
DE Germany
GB United Kingdom
FR France
AU Australia

How to call

  • API endpoint：POST /zhihuiya/patentImageSearch(For full parameters/responses/error codes, see references/api.md）
  • Python script：python scripts/zhihuiya_patent_image_search.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 (script default behavior)：

  • Alwayswrite the full response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-zhihuiya-utility-patent-image-search-<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 writing to disk, print the full JSON to stdout
  • Response body > 8 KB: after writing 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 written 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.

Local Image Upload

This tool requires a publicly accessible image URL. If the user provides a local image file path (e.g., C:\Users\...\photo.png, /home/.../image.jpg), you must upload it first to obtain a public URL.

Run the upload script:

python scripts/upload_image.py /path/to/local/image.png

The script will return a public URL (valid for 24 hours) that can be used as the image URL parameter.

Usage Examples

1. Basic utility model patent search (recommended starting point) Search for utility model patents similar to a product image, matching shape/pattern/color across all countries:

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "U",
  "model": 4,
  "limit": 20
}

2. Utility model patent search limited to specific countries Search only in China and the United States:

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "U",
  "model": 4,
  "country": "CN,US",
  "limit": 20
}

3. Shape-only utility model patent search Compare by shape only (ignore pattern/color):

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "U",
  "model": 3,
  "country": "CN",
  "limit": 20
}

4. Search only active patents within a date range Find active utility model patents filed after 2020:

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "U",
  "model": 4,
  "simpleLegalStatus": "1",
  "applyStartTime": "20200101",
  "limit": 30
}

5. Search by specific assignee Find patents held by a particular company:

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "U",
  "model": 4,
  "assignees": "Apple Inc.",
  "limit": 20
}

6. Get results with Chinese-translated titles

{
  "url": "https://example.com/my-product.jpg",
  "patentType": "U",
  "model": 4,
  "lang": "cn",
  "limit": 20
}

Display Rules

  1. Sort by score: Always sort results by score in descending order (highest similarity first) to help users quickly identify the most relevant infringement risks.

  2. Show complete details: When summarizing results or generating reports, include ALL of the following for each patent -- do NOT omit or abbreviate:

    • Application number (apno)
    • Patent title in Chinese (use lang: cn or provide translation)
    • Inventor (inventor)
    • Patent drawing (the matched url image)
    • Every patent image in the image list
    • Patent abstract
    • Patent description
    • IPC/UPC classification information
    • Radar result (radarResult) if available
    • Patent specification

  3. Legal disclaimer: Always append a friendly reminder at the end of results:

    This search result was generated by LinkfoxAgent. It is recommended to consult a professional patent attorney for legal advice.

  4. Score explanation: Remind users that the score represents visual similarity -- a higher score indicates a closer match, but does not constitute a legal determination of infringement.

  5. Pagination guidance: When the total count exceeds the returned results, inform users about the total number of matching patents and guide them to use offset and limit for additional pages.

  6. Error handling: When a query fails, explain the reason and suggest adjustments (e.g., verify the image URL is publicly accessible, check country codes, adjust date formats).

User Expression & Scenario Quick Reference

Applicable -- Image-based utility model patent similarity searches:

User Says Scenario
"Check if my product structure infringes any utility model patents" Utility model patent infringement check
"Search for similar utility model patents" Utility model patent similarity search
"Find utility model patents that look like this image" Visual utility model patent lookup
"Are there any utility model patents similar to my product structure" Utility model risk assessment
"Utility model patent search by image" Utility model search
"Check utility model patent risks for this product in China and US" Multi-country utility model patent check
"Find active utility model patents in this category" Filtered utility model patent search
"Who holds utility model patents similar to this design" Competitor patent discovery

Not applicable -- Needs beyond utility model patent image search:

  • Text-based patent search (keyword/abstract/claim search)
  • Design patent image search (use linkfox-zhihuiya-patent-image-search instead)
  • Patent legal status monitoring or annuity management
  • Patent valuation or licensing negotiation
  • Freedom-to-operate (FTO) legal opinions
  • Patent family or citation analysis

Compute consumption rules

Consumes 81 compute.

Users will pay fees due to compute consumption. Please fully assess: when this skill needs to be called frequently, or when the user's expectation of compute consumption is insufficient, be sure to remind the user and let the user decide 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.