linkfox-amazon-search
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAmazon Product Search
亚马逊商品搜索
This skill guides you on how to perform Amazon storefront search simulations, helping Amazon sellers retrieve real-time search result data including product rankings, prices, ratings, and more.
本技能将指导您如何进行亚马逊前台搜索模拟，帮助亚马逊卖家获取包含产品排名、价格、评分等在内的实时搜索结果数据。
Core Concepts
核心概念
This tool simulates a real user searching on Amazon's storefront. It returns live search result page (SERP) data: product listings with their positions, prices, ratings, review counts, brands, delivery info, sponsored flags, and more. This is real-time data directly from the Amazon frontend, not historical analytics.
Key distinction from ABA data: ABA data is aggregated historical search term analytics. This tool returns the actual product listings a user would see when searching a keyword on Amazon right now.
Keyword language: Keywords should be in the language of the target marketplace. For example, use English keywords for amazon.com, German keywords for amazon.de, Japanese keywords for amazon.co.jp, etc.
本工具模拟真实用户在亚马逊前台的搜索行为，返回实时搜索结果页（SERP）数据：包含产品列表及其排名位置、价格、评分、评论数、品牌、配送信息、广告标识等内容。这是直接来自亚马逊前台的实时数据，而非历史分析数据。
与ABA数据的关键区别：ABA数据是汇总的历史搜索词分析数据，而本工具返回的是用户当下在亚马逊搜索某一关键词时实际看到的产品列表。
关键词语言要求：关键词需与目标站点的语言一致。例如，amazon.com使用英文关键词，amazon.de使用德文关键词，amazon.co.jp使用日文关键词等。
Parameters
参数
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
| keyword | string | No | Search keyword (translate to the target marketplace's language) | - |
| amazonDomain | string | No | Amazon marketplace domain | amazon.com |
| node | string | No | Amazon category node ID for category-scoped searches | - |
| language | string | No | Language locale code (e.g., en_US, de_DE, ja_JP) | - |
| sort | string | No | Sort order for results | relevanceblender |
| page | integer | No | Page number (starting from 1, ~20 results per page) | 1 |
| deliveryZip | string | No | Postal/zip code for delivery location simulation | - |
| device | string | No | Device type: desktop, mobile, or tablet | desktop |
| 参数 | 类型 | 是否必填 | 描述 | 默认值 |
|---|---|---|---|---|
| keyword | string | 否 | 搜索关键词（需转换为目标站点的语言） | - |
| amazonDomain | string | 否 | 亚马逊站点域名 | amazon.com |
| node | string | 否 | 用于分类范围搜索的亚马逊分类节点ID | - |
| language | string | 否 | 语言区域代码（如：en_US、de_DE、ja_JP） | - |
| sort | string | 否 | 结果排序方式 | relevanceblender |
| page | integer | 否 | 页码（从1开始，每页约20条结果） | 1 |
| deliveryZip | string | 否 | 用于模拟配送位置的邮政编码 | - |
| device | string | 否 | 设备类型：desktop（桌面端）、mobile（移动端）或tablet（平板端） | desktop |
Supported Marketplaces
支持的站点
| Domain | Country |
|---|---|
| amazon.com | United States |
| amazon.co.uk | United Kingdom |
| amazon.de | Germany |
| amazon.fr | France |
| amazon.it | Italy |
| amazon.es | Spain |
| amazon.co.jp | Japan |
| amazon.ca | Canada |
| amazon.com.au | Australia |
| amazon.com.br | Brazil |
| amazon.in | India |
| amazon.nl | Netherlands |
| amazon.se | Sweden |
| amazon.pl | Poland |
| amazon.sg | Singapore |
| amazon.sa | Saudi Arabia |
| amazon.ae | United Arab Emirates |
| amazon.com.mx | Mexico |
| amazon.com.tr | Turkey |
| amazon.com.be | Belgium |
| amazon.cn | China |
| amazon.eg | Egypt |
Default marketplace is amazon.com. Use amazon.com when the user doesn't specify a marketplace.
| 域名 | 国家/地区 |
|---|---|
| amazon.com | 美国 |
| amazon.co.uk | 英国 |
| amazon.de | 德国 |
| amazon.fr | 法国 |
| amazon.it | 意大利 |
| amazon.es | 西班牙 |
| amazon.co.jp | 日本 |
| amazon.ca | 加拿大 |
| amazon.com.au | 澳大利亚 |
| amazon.com.br | 巴西 |
| amazon.in | 印度 |
| amazon.nl | 荷兰 |
| amazon.se | 瑞典 |
| amazon.pl | 波兰 |
| amazon.sg | 新加坡 |
| amazon.sa | 沙特阿拉伯 |
| amazon.ae | 阿联酋 |
| amazon.com.mx | 墨西哥 |
| amazon.com.tr | 土耳其 |
| amazon.com.be | 比利时 |
| amazon.cn | 中国 |
| amazon.eg | 埃及 |
默认站点为amazon.com。当用户未指定站点时，使用amazon.com。
Sort Options
排序选项
| Value | Description |
|---|---|
| relevanceblender | Featured / Relevance (default) |
| price-asc-rank | Price: Low to High |
| price-desc-rank | Price: High to Low |
| review-rank | Average Customer Review |
| date-desc-rank | Newest Arrivals |
| exact-aware-popularity-rank | Best Sellers |
| 值 | 描述 |
|---|---|
| relevanceblender | 精选/相关性（默认） |
| price-asc-rank | 价格：从低到高 |
| price-desc-rank | 价格：从高到低 |
| review-rank | 平均客户评分 |
| date-desc-rank | 最新上架 |
| exact-aware-popularity-rank | 畅销商品 |
API Usage
API 使用方法
This tool calls the LinkFox tool gateway API. See for calling conventions, request parameters, and response structure. You can also execute directly to run queries.
references/api.mdscripts/amazon_search.py本工具调用LinkFox工具网关API。调用规范、请求参数及响应结构可查看。您也可以直接执行来运行查询。
references/api.mdscripts/amazon_search.pyHow to Build Queries
查询构建方法
Construct the request parameters based on the user's intent:
- Determine the marketplace: Map the user's target country to the correct value
amazonDomain - Set the keyword: Translate the search term into the target marketplace's language
- Choose sort order: If the user wants results sorted by price, reviews, or newness, set the parameter
sort - Pagination: Use the parameter to fetch additional result pages if needed
page - Category scope: If the user wants to search within a specific category, provide the parameter
node - Delivery simulation: Use to see location-specific availability and delivery info
deliveryZip
根据用户意图构建请求参数：
- 确定站点：将用户目标国家/地区映射为对应的值
amazonDomain - 设置关键词：将搜索词转换为目标站点的语言
- 选择排序方式：如果用户希望按价格、评分或上架时间排序，设置参数
sort - 分页处理：如需获取更多结果页，使用参数
page - 分类范围：如果用户希望在特定分类内搜索，提供参数
node - 配送模拟：使用查看特定位置的库存及配送信息
deliveryZip
Usage Examples
使用示例
1. Basic keyword search on US marketplace
json
{"keyword": "wireless earbuds", "amazonDomain": "amazon.com"}2. Search on German marketplace with German keyword
json
{"keyword": "kabellose Kopfhoerer", "amazonDomain": "amazon.de", "language": "de_DE"}3. Search sorted by price (low to high)
json
{"keyword": "phone case", "amazonDomain": "amazon.com", "sort": "price-asc-rank"}4. Search for best sellers in a category
json
{"keyword": "yoga mat", "amazonDomain": "amazon.com", "sort": "exact-aware-popularity-rank"}5. Search for newest arrivals on Japan marketplace
json
{"keyword": "USB充電器", "amazonDomain": "amazon.co.jp", "language": "ja_JP", "sort": "date-desc-rank"}6. Multi-page search to analyze deeper results
json
{"keyword": "laptop stand", "amazonDomain": "amazon.com", "page": 2}7. Mobile device search simulation
json
{"keyword": "running shoes", "amazonDomain": "amazon.com", "device": "mobile"}8. Category-scoped search with delivery zip
json
{"keyword": "office chair", "amazonDomain": "amazon.com", "deliveryZip": "10001"}1. 美国站点基础关键词搜索
json
{"keyword": "wireless earbuds", "amazonDomain": "amazon.com"}2. 德国站点德文关键词搜索
json
{"keyword": "kabellose Kopfhoerer", "amazonDomain": "amazon.de", "language": "de_DE"}3. 按价格从低到高排序搜索
json
{"keyword": "phone case", "amazonDomain": "amazon.com", "sort": "price-asc-rank"}4. 分类内畅销商品搜索
json
{"keyword": "yoga mat", "amazonDomain": "amazon.com", "sort": "exact-aware-popularity-rank"}5. 日本站点最新上架商品搜索
json
{"keyword": "USB充電器", "amazonDomain": "amazon.co.jp", "language": "ja_JP", "sort": "date-desc-rank"}6. 多页搜索以分析更深层结果
json
{"keyword": "laptop stand", "amazonDomain": "amazon.com", "page": 2}7. 移动端搜索模拟
json
{"keyword": "running shoes", "amazonDomain": "amazon.com", "device": "mobile"}8. 指定分类及配送邮编的搜索
json
{"keyword": "office chair", "amazonDomain": "amazon.com", "deliveryZip": "10001"}Display Rules
展示规则
- Present data clearly: Show search results in well-structured tables with key fields: position, ASIN, title, price, rating, review count, brand
- Highlight sponsored products: Clearly mark which results are sponsored ads vs organic listings
- Price formatting: Display prices with the correct currency symbol for the marketplace
- Position context: Remind users that position reflects the actual ranking on the search result page
- Pagination notice: When results span multiple pages, inform the user how many total results were found and suggest fetching additional pages if needed
- Error handling: When a query fails, explain the reason based on the error response and suggest adjusting parameters
- Image links: If image URLs are available, mention them but do not attempt to render them inline unless the user requests it
- 清晰呈现数据：将搜索结果整理为结构清晰的表格，包含关键字段：排名位置、ASIN、标题、价格、评分、评论数、品牌
- 突出广告商品：明确标记哪些结果是赞助广告，哪些是自然 listings
- 价格格式：显示对应站点的正确货币符号
- 排名说明：提醒用户排名反映的是搜索结果页的实际位置
- 分页提示：当结果跨多页时，告知用户总结果数，并建议按需获取更多页面
- 错误处理：当查询失败时，根据错误响应说明原因，并建议调整参数
- 图片链接：如果有图片URL，可提及但不要尝试内嵌显示，除非用户要求
Important Limitations
重要限制
- Real-time only: This tool returns live search results, not historical data. For historical search term analytics, use ABA data instead
- Rate awareness: Each call simulates a real search request; avoid excessive rapid-fire calls
- ~20 results per page: Each page returns approximately 20 product listings
- Keyword language matters: Results quality depends on using the correct language for the target marketplace
- 仅支持实时数据：本工具返回实时搜索结果，而非历史数据。如需历史搜索词分析数据，请使用ABA数据
- 注意调用频率：每次调用都会模拟一次真实搜索请求，避免过于频繁的连续调用
- 每页约20条结果：每页返回约20个产品列表
- 关键词语言至关重要：结果质量取决于是否使用目标站点的正确语言
User Expression & Scenario Quick Reference
用户表述与场景速查
Applicable -- Real-time Amazon search result queries:
| User Says | Scenario |
|---|---|
| "Search for XX on Amazon" | Basic product search |
| "What products appear for keyword XX" | Keyword SERP analysis |
| "Where does my ASIN rank for XX keyword" | Position / ranking check |
| "Show me the top results for XX" | Competitive landscape |
| "What's the price range for XX" | Price comparison |
| "Any sponsored products for XX keyword" | Sponsored ad analysis |
| "New products for XX keyword" | New arrival monitoring |
| "Search XX on Amazon Germany/Japan/UK" | Cross-marketplace search |
| "What are the best sellers for XX" | Best seller discovery |
| "Compare search results on mobile vs desktop" | Device-specific SERP |
Not applicable -- Needs beyond real-time search results:
- Historical search term volume or ranking trends (use ABA data)
- Advertising campaign management or bid optimization
- Product review analysis or sentiment analysis
- Sales estimation or revenue analytics
- Listing optimization or copywriting suggestions
- Inventory or supply chain data
Boundary judgment: When users say "product research" or "competitor analysis", if it boils down to seeing what currently appears on Amazon search results for a keyword (product positions, prices, ratings), then this skill applies. If they want historical trends, search volume data, or aggregated analytics, ABA data is more appropriate.
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 . Do not interrupt the user's flow.
references/api.mdFor more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.
适用场景 -- 实时亚马逊搜索结果查询：
| 用户表述 | 场景 |
|---|---|
| "在亚马逊上搜索XX" | 基础商品搜索 |
| "关键词XX对应的搜索结果有哪些产品" | 关键词SERP分析 |
| "我的ASIN在关键词XX下的排名是多少" | 排名位置查询 |
| "展示关键词XX的顶部搜索结果" | 竞品格局分析 |
| "XX的价格范围是多少" | 价格对比 |
| "关键词XX下有哪些赞助商品" | 广告商品分析 |
| "关键词XX下的新品有哪些" | 新品监控 |
| "在亚马逊德国/日本/英国站点搜索XX" | 跨站点搜索 |
| "XX的畅销商品有哪些" | 畅销品挖掘 |
| "对比移动端和桌面端的搜索结果" | 设备专属SERP分析 |
不适用场景 -- 超出实时搜索结果的需求：
- 历史搜索词流量或排名趋势（使用ABA数据）
- 广告活动管理或出价优化
- 产品评论分析或情感分析
- 销量预估或收入分析
- 商品Listing优化或文案建议
- 库存或供应链数据
边界判断：当用户提到“产品调研”或“竞品分析”时，如果核心需求是查看亚马逊当前搜索关键词对应的结果（产品位置、价格、评分），则适用本技能。如果用户需要历史趋势、搜索流量数据或汇总分析数据，则更适合使用ABA数据。
反馈：
当出现以下任意情况时，自动检测并通过Feedback API提交反馈：
- 本技能描述的功能或用途与实际行为不符
- 本技能的结果不符合用户意图
- 用户表达了对本技能的不满或赞扬
- 任何您认为可以改进的内容
按照中的说明调用反馈API，请勿中断用户流程。
references/api.md如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。