linkfox-amazon-search-by-image

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Amazon Image-Based Search

亚马逊基于图片的搜索

This skill guides you on how to perform visual product searches on Amazon using an image URL, helping Amazon sellers and researchers find visually similar products across multiple marketplaces.

本技能将指导您如何使用图片URL在亚马逊上进行视觉商品搜索，帮助亚马逊卖家和研究者在多个站点中查找视觉相似的商品。

Core Concepts

核心概念

Amazon Image-Based Search (visual search) allows you to submit a product image URL and retrieve Amazon listings that are visually similar. This is invaluable for competitive analysis, sourcing alternatives, identifying counterfeits, and discovering market opportunities based on product appearance.

The tool searches across 8 Amazon marketplaces and returns rich product data including ASIN, title, image, price, rating, review count, brand, and optionally Keepa-enriched data (sales rank, monthly sales, FBA fees, dimensions, etc.).

亚马逊基于图片的搜索（视觉搜索）允许您提交商品图片URL，检索亚马逊平台上视觉相似的商品Listing。这对于竞品分析、货源替代、识别假货以及基于商品外观发现市场机会来说非常重要。

该工具可在8个亚马逊站点内搜索，并返回丰富的商品数据，包括ASIN、标题、图片、价格、评分、评论数、品牌，还可选择添加Keepa增强数据（销售排名、月销量、FBA费用、尺寸等）。

Supported Marketplaces

支持的站点

Marketplace	Domain	Default Zip Code
United States	amazon.com	10001
United Kingdom	amazon.co.uk	EC1A 1BB
Germany	amazon.de	10115
France	amazon.fr	75001
Italy	amazon.it	00100
Spain	amazon.es	28001
Japan	amazon.co.jp	100-0001
India	amazon.in	110034

Default marketplace is amazon.com (US). Use amazon.com when the user does not specify a marketplace.

站点	域名	默认邮编
美国	amazon.com	10001
英国	amazon.co.uk	EC1A 1BB
德国	amazon.de	10115
法国	amazon.fr	75001
意大利	amazon.it	00100
西班牙	amazon.es	28001
日本	amazon.co.jp	100-0001
印度	amazon.in	110034

默认站点为amazon.com（美国）。若用户未指定站点，则使用amazon.com。

Parameter Guide

参数指南

Parameter	Required	Description
imageUrl	Yes	A valid, publicly accessible image URL to search with
amazonDomain	Yes	Amazon marketplace domain (e.g., `amazon.com` , `amazon.de` ). Defaults to `amazon.com`
sort	No	Sort order for results. Supported values: `default` , `price-asc-rank` , `price-desc-rank` , `rating-asc-rank` , `rating-desc-rank` , `ratings-asc-rank` , `ratings-desc-rank`
deliveryZip	No	Delivery address zip code within the marketplace country. Uses the marketplace default if not specified
countryOrAreaCode	No	Country/region code for cross-border delivery (e.g., `CN` , `JP` , `KR` ). Cannot be used together with `deliveryZip` . Note: India marketplace does not support cross-border delivery
aggregateByKeepaData	No	Whether to enrich results with Keepa data (sales rank, monthly sales, FBA fees, dimensions, etc.)

参数	是否必填	描述
imageUrl	是	用于搜索的有效、可公开访问的图片URL
amazonDomain	是	亚马逊站点域名（例如 `amazon.com` 、 `amazon.de` ），默认值为 `amazon.com`
sort	否	结果排序方式，支持的值： `default` 、 `price-asc-rank` 、 `price-desc-rank` 、 `rating-asc-rank` 、 `rating-desc-rank` 、 `ratings-asc-rank` 、 `ratings-desc-rank`
deliveryZip	否	站点所在国家的配送地址邮编，未指定时使用站点默认值
countryOrAreaCode	否	跨境配送的国家/地区代码（例如 `CN` 、 `JP` 、 `KR` ），不可与 `deliveryZip` 同时使用。注意：印度站点不支持跨境配送
aggregateByKeepaData	否	是否用Keepa数据增强结果（销售排名、月销量、FBA费用、尺寸等）

Sort Options

排序选项

Value	Description
`default`	Default relevance sorting
`price-asc-rank`	Price: low to high
`price-desc-rank`	Price: high to low
`rating-asc-rank`	Rating: low to high
`rating-desc-rank`	Rating: high to low
`ratings-asc-rank`	Review count: low to high
`ratings-desc-rank`	Review count: high to low

Important: If the requested sort order is not in the supported list above, do NOT attempt to use any other tool or workaround to compensate. Inform the user of the supported sort options.

值	描述
`default`	默认相关性排序
`price-asc-rank`	价格：从低到高
`price-desc-rank`	价格：从高到低
`rating-asc-rank`	评分：从低到高
`rating-desc-rank`	评分：从高到低
`ratings-asc-rank`	评论数：从少到多
`ratings-desc-rank`	评论数：从多到少

重要提示：如果用户请求的排序方式不在上述支持列表中，请勿尝试使用任何其他工具或变通方法来弥补，需告知用户支持的排序选项。

API Usage

API 使用

This tool calls the LinkFox tool gateway API. See

references/api.md

for calling conventions, request parameters, and response structure. You can also execute

scripts/amazon_search_by_image.py

directly to run queries.

本工具调用LinkFox工具网关API。调用规范、请求参数和响应结构请参见

references/api.md

。您也可以直接执行

scripts/amazon_search_by_image.py

来运行查询。

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:

bash

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.

本工具需要可公开访问的图片URL。如果用户提供本地图片文件路径（例如

C:\Users\...\photo.png

、

/home/.../image.jpg

），您必须先上传图片以获取公开URL。

运行上传脚本：

bash

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

脚本将返回一个公开URL（24小时内有效），可作为imageUrl参数使用。

Usage Examples

使用示例

1. Basic image search on the US marketplace

Search Amazon US for products that look similar to this image:
https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg

2. Find similar products on a specific marketplace

Search Amazon Germany (amazon.de) for products visually similar to this image:
https://example.com/product-photo.jpg

3. Image search sorted by price (low to high)

Find similar products on Amazon US for this image, sorted by price from low to high:
https://example.com/my-product.jpg

4. Image search with Keepa data enrichment

Search Amazon US for products matching this image and include Keepa sales data:
https://example.com/competitor-product.jpg

5. Cross-border delivery search

Search Amazon Japan for similar products to this image, with delivery to China:
https://example.com/item.jpg

6. Competitor lookalike discovery

I found this product image on a competitor's listing. Find me all similar-looking products on Amazon UK:
https://example.com/competitor.jpg

1. 美国站点基础图片搜索

在亚马逊美国站搜索与以下图片相似的商品：
https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg

2. 指定站点查找相似商品

在亚马逊德国站（amazon.de）搜索与以下图片视觉相似的商品：
https://example.com/product-photo.jpg

3. 按价格（从低到高）排序的图片搜索

在亚马逊美国站查找与以下图片相似的商品，按价格从低到高排序：
https://example.com/my-product.jpg

4. 包含Keepa数据增强的图片搜索

在亚马逊美国站搜索与以下图片匹配的商品，并包含Keepa销售数据：
https://example.com/competitor-product.jpg

5. 跨境配送搜索

在亚马逊日本站搜索与以下图片相似的商品，配送至中国：
https://example.com/item.jpg

6. 竞品相似款发现

我在竞品Listing上找到了这张商品图片，请帮我查找亚马逊英国站所有外观相似的商品：
https://example.com/competitor.jpg

Display Rules

展示规则

Present data clearly: Show search results in a well-structured table. Key columns to prioritize: product image, title, ASIN, price, rating, review count, and brand
Image display: When the response includes
```
imageUrl
```
for products, display them inline so users can visually compare results
Price and currency: Always show price alongside the currency code (e.g., $29.99 USD, 24.99 EUR)
Keepa data: When
```
aggregateByKeepaData
```
is enabled and Keepa fields are present, show supplementary data (monthly sales, sales rank, FBA fees) in an expanded section or additional columns
Result count: Always inform the user of the total number of results found (
```
total
```
/
```
totalCount
```
)
Error handling: When a query fails, explain the issue and suggest checking that the image URL is valid and publicly accessible
Sort limitation: If the user requests a sort order not in the supported list, clearly explain which sort options are available rather than attempting unsupported workarounds
No secondary processing: Results from this tool are not stored in a database, so secondary SQL processing is not available

清晰呈现数据：用结构清晰的表格展示搜索结果，优先显示关键列：商品图片、标题、ASIN、价格、评分、评论数和品牌
图片展示：当响应包含商品的
```
imageUrl
```
时，应内嵌展示图片，方便用户直观对比结果
价格与货币：始终显示价格及对应的货币代码（例如$29.99 USD、24.99 EUR）
Keepa数据：当
```
aggregateByKeepaData
```
启用且存在Keepa字段时，在扩展区域或附加列中展示补充数据（月销量、销售排名、FBA费用等）
结果数量：始终告知用户找到的结果总数（
```
total
```
/
```
totalCount
```
）
错误处理：当查询失败时，说明问题并建议检查图片URL是否有效且可公开访问
排序限制：如果用户请求的排序方式不在支持列表中，需明确说明可用的排序选项，而非尝试不支持的变通方法
无二次处理：本工具的结果不会存储在数据库中，因此无法进行二次SQL处理

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable -- Visual product search scenarios on Amazon:

User Says	Scenario
"Find similar products to this image"	Basic image search
"Search by image", "reverse image search on Amazon"	Visual search
"Find competitor lookalikes", "find same-style products"	Competitor analysis by appearance
"What products on Amazon look like this"	Product discovery
"Find cheaper alternatives that look the same"	Price-based visual comparison
"Search Amazon JP/DE/UK for this product image"	Cross-marketplace visual search
"Show me Keepa data for similar products"	Enriched visual search
"Find products similar to this photo, sorted by rating"	Sorted visual search

Not applicable -- Needs beyond image-based product search:

Text-based keyword search on Amazon (use keyword search tools instead)
ABA search term data analysis
Product review analysis or listing optimization
Sales estimation without a source image
Image editing or image generation
Searching with a local image file (the tool requires a publicly accessible URL)

Boundary judgment: When users say "find similar products" or "competitor analysis", if they provide an image URL and the intent is to find visually similar Amazon listings, this skill applies. If they are asking for keyword-based search, sales data analysis, or product research without an image, it does not apply.

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.

适用场景 -- 亚马逊视觉商品搜索相关场景：

用户表述	场景
"查找与这张图片相似的商品"	基础图片搜索
"按图片搜索"、"在亚马逊上反向图片搜索"	视觉搜索
"查找竞品相似款"、"查找同款商品"	基于外观的竞品分析
"亚马逊上有哪些和这个外观相似的商品"	商品发现
"查找外观相同的更便宜替代品"	基于价格的视觉对比
"在亚马逊日/德/英站搜索这张商品图片"	跨站点视觉搜索
"展示相似商品的Keepa数据"	增强型视觉搜索
"查找与这张照片相似的商品，按评分排序"	排序后的视觉搜索

不适用场景 -- 超出基于图片的商品搜索需求：

亚马逊基于文字关键词的搜索（请使用关键词搜索工具）
ABA搜索词数据分析
商品评论分析或Listing优化
无源图片的销量估算
图片编辑或图片生成
使用本地图片文件搜索（本工具需要可公开访问的URL）

边界判断：当用户说“查找相似商品”或“竞品分析”时，若提供了图片URL且意图是查找亚马逊平台上视觉相似的Listing，则适用本技能。若用户要求的是基于关键词的搜索、销售数据分析或无图片的商品调研，则不适用。

反馈：

当出现以下任意情况时，自动检测并通过反馈API提交反馈：

本技能描述的功能或用途与实际行为不符
技能结果与用户意图不匹配
用户表达了对本技能的不满或赞赏
任何您认为可以改进的内容

请按照

references/api.md

中的说明调用反馈API，请勿打断用户的操作流程。

如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。