This skill guides you on how to perform image-based patent similarity searches using the Zhihuiya patent database, helping users identify potentially similar design patents. This skill supports design patents only; for utility model patents use linkfox-zhihuiya-utility-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 design patents only:
| Type | Code | Description |
|---|---|---|
| Design Patent | D |
Protects the ornamental appearance of a product |
Search models for design patents:
| Model ID | Strategy | Recommendation |
|---|---|---|
| 1 | Intelligent Association | Recommended for design patents (default) |
| 2 | Search This Image | Exact visual match |
Utility model patents (model 3/4) are not supported by this skill. Use
linkfox-zhihuiya-utility-patent-image-searchinstead.
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 D (design) by this skill |
D |
| model | Search model ID: 1 (recommended) or 2 |
1 |
Common Optional Parameters
| Parameter | Description | Default |
|---|---|---|
| country | Patent authority country codes, comma-separated (e.g., CN,US,JP) |
All countries |
| loc | Locarno classification codes, connectable with AND/OR/NOT | None |
| 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/LOC 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 |
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, seereferences/api.md) - Python Script:
python scripts/zhihuiya_patent_image_search.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 zip 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-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 variableSESSION_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 writing to disk, print the complete 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
--inlineto 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 using jqorConvertFrom-Json to extract on demand from the saved json file, avoiding bringing the entire JSON into context.
Resolving Authentication and Computing Power Issues
When the following abnormal situations occur, use references/onboarding.md to guide resolution of the issues:
Abnormal Situations
- API Key not configured: The environment variable is not configured
LINKFOX_AGENT_API_KEY, andLINKFOXAGENT_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.
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 design patent search (recommended starting point) Search for design patents similar to a product image across all countries:
{
"url": "https://example.com/my-product.jpg",
"patentType": "D",
"model": 1,
"limit": 20
}
2. Design patent search limited to specific countries Search only in China and the United States:
{
"url": "https://example.com/my-product.jpg",
"patentType": "D",
"model": 1,
"country": "CN,US",
"limit": 20
}
3. Search with Locarno classification filter Narrow results to a specific product category (e.g., LOC 07-01 for tableware):
{
"url": "https://example.com/my-product.jpg",
"patentType": "D",
"model": 1,
"loc": "07-01",
"preFilter": 1,
"limit": 20
}
4. Search only active patents within a date range Find active design patents filed after 2020:
{
"url": "https://example.com/my-product.jpg",
"patentType": "D",
"model": 1,
"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": "D",
"model": 1,
"assignees": "Apple Inc.",
"limit": 20
}
6. Get results with Chinese-translated titles
{
"url": "https://example.com/my-product.jpg",
"patentType": "D",
"model": 1,
"lang": "cn",
"limit": 20
}
Display Rules
-
Sort by score: Always sort results by
scorein descending order (highest similarity first) to help users quickly identify the most relevant infringement risks. -
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: cnor provide translation) - Inventor (
inventor) - Patent drawing (the matched
urlimage) - Every patent image in the image list
- Patent abstract
- Patent description
- LOC classification information (
loc) - Radar result (
radarResult) if available - Patent specification
- Application number (
-
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.
-
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.
-
Pagination guidance: When the total count exceeds the returned results, inform users about the total number of matching patents and guide them to use
offsetandlimitfor additional pages. -
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 patent similarity searches:
| User Says | Scenario |
|---|---|
| "Check if my product design infringes any patents" | Design patent infringement check |
| "Search for similar design patents" | Design patent similarity search |
| "Find patents that look like this image" | Visual patent lookup |
| "Are there any patents similar to my product appearance" | Appearance risk assessment |
| "Utility model patent search by image" | Utility model search |
| "Check patent risks for this product in China and US" | Multi-country patent check |
| "Find active design patents in this category" | Filtered patent search |
| "Who holds patents similar to this design" | Competitor patent discovery |
Not applicable -- Needs beyond patent image search:
- Text-based patent search (keyword/abstract/claim search)
- Patent legal status monitoring or annuity management
- Patent valuation or licensing negotiation
- Freedom-to-operate (FTO) legal opinions
- Patent family or citation analysis
Computing Power Consumption Rules
Consumes 81 computing power.
Users will pay fees due to computing power consumption. Please fully assess: when this skill needs to be called frequently, or when the user's expectation of computing power 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:
- The functionality or purpose described in this skill does not match actual behavior
- The skill's results do not match the user's intent
- The user expresses dissatisfaction or praise about this skill
- 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.