linkfox-eureka-patent-image-search

name	linkfox-eureka-patent-image-search
description	通过Eureka专利平台进行专利图像检索（以图搜图），上传一张图片URL即可检索外观设计或实用新型的相似专利。当用户提到专利图像检索、以图搜专利、外观设计搜索、图片相似专利、设计专利检索、图像搜索专利、专利视觉搜索、patent image search, search patent by image, design patent search, visual patent search, similar design patent, image similarity search, patent image matching, utility patent shape match, Eureka image search时触发此技能。即使用户未明确提及"Eureka"或"图像检索"，只要其需求涉及通过图片查找相似的外观设计专利或实用新型专利，也应触发此技能。

Eureka Patent Image Search (Single Image)

This skill guides you on how to perform patent image search (search-by-image) via the Eureka patent platform. Given a single image URL, it finds visually similar patents in the design or utility patent databases, supporting multiple search models and extensive filtering options.

Core Concepts

The Eureka Patent Image Search tool enables visual similarity search across patent databases:

1. Search Models — Four models are available depending on the patent type and search intent:

   • Model 1: Design smart association — finds design patents with intelligent visual association
   • Model 2: Design search this image — exact visual match for design patents
   • Model 3: Utility match shape — matches utility patents by shape/contour
   • Model 4: Utility match shape + pattern + color — matches utility patents by shape, pattern, and color combined

2. Patent Types — Two patent types are supported:

   • D (Design) — search within design/industrial design patents (use models 1 or 2)
   • U (Utility) — search within utility model patents (use models 3 or 4)

3. Filtering — Extensive optional filters for country/authority, Locarno classification, date ranges, legal status, assignees, and keyword fields.

4. Scoring — Results include a similarity score and can be sorted by score, application date, publication date, or issue date.

Parameter Guide

Required Parameters

Parameter	Type	Description
url	string	The URL of the image to search with. Must be a publicly accessible image URL.
model	integer	Search model: 1 = design smart association, 2 = design search this image, 3 = utility match shape, 4 = utility match shape + pattern + color
patentType	string	Patent type to search: "D" = design patent, "U" = utility patent

Optional Parameters

Parameter	Type	Default	Description
country	string	—	Patent authority codes, comma-separated (e.g., CN,US,JP,EP,WO)
loc	string	—	Locarno classification code. Supports AND/OR/NOT boolean operators.
applyStartTime	string	—	Application date range start (format: yyyyMMdd)
applyEndTime	string	—	Application date range end (format: yyyyMMdd)
publicStartTime	string	—	Publication date range start (format: yyyyMMdd)
publicEndTime	string	—	Publication date range end (format: yyyyMMdd)
mainField	string	—	Search keyword within specific fields: title, abstract, claims, description, pn, applicant, inventor, IPC, UPC, LOC
assignees	string	—	Filter by assignee/rights holder name
legalStatus	string	—	Legal status codes, comma-separated. Values: 1=Published, 2=Examining, 3=Granted, 11=Withdrawn, 13=Rejected, 14=Revoked, 15=Expired, etc.
simpleLegalStatus	string	—	Simplified legal status: 0=Invalid, 1=Valid, 2=Pending, 220=PCT expired, 221=PCT in period, 999=Undetermined
preFilter	integer	1	Enable (1) or disable (0) pre-filtering by country and LOC classification
scoreExpansion	boolean	—	Enable score expansion for broader results
stemming	integer	0	Enable (1) or disable (0) word stemming in keyword search
includeMachineTranslation	boolean	—	Include machine-translated content in search
field	string	SCORE	Sort field: SCORE (similarity), APD (application date), PBD (publication date), ISD (issue date)
order	string	desc	Sort order: desc or asc
limit	integer	10	Results per page, range 1–100

Model & Patent Type Combinations

Patent Type	Recommended Models	Description
D (Design)	1, 2	Model 1 for smart association, Model 2 for exact visual match
U (Utility)	3, 4	Model 3 for shape match, Model 4 for shape + pattern + color

Response Fields

Field	Description
patentId	The patent's internal ID
patentPn	Publication number
title	Patent title
url	URL of the similar image found in the patent
score	Similarity score
apdt	Application date
pbdt	Publication date
authority	Patent authority (country code)
inventor	Inventor name
apno	Application number
originalAssignee	Original applicant/assignee
currentAssignee	Current rights holder
loc	Array of Locarno classification codes
imgId	Image ID (when returnImgId is enabled)
locMatch	Whether the Locarno classification matched the filter
total	Number of results in current page
allRecordsCount	Total number of matching results
costToken	Token cost for this query

Usage Examples

1. Search for similar design patents using an image

Search for design patents similar to this image: https://example.com/product-image.jpg — look in CN and US patent databases.

→ Use model=1 or 2, patentType="D", country="CN,US"

2. Find utility patents with a similar shape

Find utility patents that have a similar shape to this product image: https://example.com/gadget.png

→ Use model=3, patentType="U"

3. Search with date and legal status filters

Search for valid design patents similar to this image, filed after 2020, in the CN database: https://example.com/design.jpg

→ Use model=2, patentType="D", country="CN", applyStartTime="20200101", simpleLegalStatus="1"

4. Search with Locarno classification

Find design patents in LOC 14-01 similar to this product: https://example.com/phone-case.jpg

→ Use model=1, patentType="D", loc="14-01"

5. Search with keyword and assignee filters

Search for design patents similar to this image from Apple Inc.: https://example.com/device.jpg

→ Use model=2, patentType="D", assignees="Apple"

6. Get more results with pagination

Show me the next 20 design patents similar to this image: https://example.com/product.jpg

→ Use limit=20, offset=20

Display Rules

1. Present results as a visual gallery when possible: Show the patent publication number, title, similarity score, and image URL for each result.
2. Score interpretation: Higher scores indicate greater visual similarity. Present scores as percentages or relative rankings for user clarity.
3. Key metadata: Always include patent number, title, authority, application date, and assignee for each result.
4. Total count: Mention allRecordsCount to indicate how many total matches were found, and how many are displayed.
5. Model explanation: When presenting results, briefly note which search model was used so the user understands the matching approach.
6. Error handling: If the query fails, check common issues: invalid image URL, unsupported image format, invalid model/patentType combination.
7. Pagination guidance: If there are more results than displayed, inform the user they can request more.

Important Limitations

• Single image only: This endpoint accepts one image URL per request.
• Image URL must be publicly accessible: Private or authentication-required image URLs will fail.
• Model & patent type pairing: Models 1–2 are for design patents (D), models 3–4 are for utility patents (U). Mismatched combinations may produce poor results.
• Offset limit: Maximum offset is 1000, meaning at most 1000 + limit results can be accessed via pagination.
• Locarno classification: The loc parameter uses Locarno codes; users may need help identifying the correct code for their product category.

User Expression & Scenario Quick Reference

Applicable — Visual patent search queries:

User Says	Scenario
"Search for patents similar to this image"	Basic image search
"Find design patents that look like this"	Design patent visual search
"Are there utility patents with this shape"	Utility patent shape match
"Search CN and US design patents for this product image"	Filtered image search
"Find valid patents similar to this design"	Legal status-filtered search
"Show me more results"	Pagination request
"Search in Locarno class 14-01"	Classification-filtered search

Not applicable — Needs beyond image search:

• Patent text-based search (keyword, classification, applicant)
• Patent bibliography or metadata retrieval
• Patent legal status queries
• Patent claims or description retrieval
• Patent family analysis
• Multi-image or batch image search

解决认证和积分问题

发生以下异常情况时，采用以下措施来处理：

异常情况

• 未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应401或402状态码
• 响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

措施

• 优先采用skill内的 onboarding.md 引导解决问题。
• 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：
  • 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。如需用户授权才可下载，要询问用户获得授权，你不能自己放弃下载。
• 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。

积分消耗规则

消耗 81 积分。

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

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, visit LinkFox Skills.