linkfox-amazon-search-by-image

name	linkfox-amazon-search-by-image
description	基于图片的亚马逊跨站点视觉商品搜索，支持8个站点的以图搜图和视觉相似商品发现。当用户提到以图搜图、图片搜索、视觉搜索、找同款、外观相似商品、图片找货、竞品图片搜索、相似商品发现、image search, Amazon visual search, find similar products, reverse image lookup, visual search, similar items, competitor image search, product image match时触发此技能。即使用户未明确提及"图片搜索"，只要用户提供了图片URL并希望在亚马逊上查找匹配或相似的商品，也应触发此技能。

亚马逊前端-以图搜图

基本信息

• 业务工具名：/amazon/searchByImage
• 所属分组：Amazon · 搜索、评论与商业洞察
• 功能说明：支持对亚马逊多站点进行视觉搜索。通过图片链接检索外观相似的商品，返回结果包含商品的ASIN, 图片，评论数，评分，价格，品牌等。支持不同站点、不同配送地址（邮编）的检索，仅支持按默认排序、价格正序与倒序、评分正序与倒序、评论数正序与倒序方式排序。
• 关键词：亚马逊以图搜图，图片找竞品、亚马逊找同款

何时使用

当用户意图与“亚马逊前端-以图搜图”匹配，或需要以下能力时使用本工具：支持对亚马逊多站点进行视觉搜索。通过图片链接检索外观相似的商品，返回结果包含商品的ASIN, 图片，评论数，评分，价格，品牌等。支持不同站点、不同配送地址（邮编）的检索，仅支持按默认排序、价格正序与倒序、评分正序与倒序、评论数正序与倒序方式排序。

调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时，应使用用户提供的信息，不要擅自虚构真实业务标识。

输入参数

字段	类型	必填	约束/默认值	说明
sort	string	否	格式 default|price-asc-rank|price-desc-rank|rating-asc-rank|rating-desc-rank|ratings-asc-rank|ratings-desc-rank；示例：default, price-asc-rank, price-desc-rank, rating-asc-rank, rating-desc-rank, ratings-asc-rank, ratings-desc-rank	排序, 支持价格，评分，评论数排序
imageUrl	string	是	最长 1000；示例：https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg	图片URL地址,请确保图片URL地址有效
deliveryZip	string	否	最长 1000；示例：10001, EC1A 1BB, 10115, 75001, 00100, 28001, 100-0001, 110034	站内收货地址邮编或城市，如果用户未指定，则取站点（国家）的默认邮编。例如：亚马逊美国站取邮编10001。
amazonDomain	string	是	格式 amazon.com|amazon.co.uk|amazon.de|amazon.fr|amazon.it|amazon.es|amazon.co.jp|amazon.in；示例：amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.co.jp, amazon.in	亚马逊站点，仅支持以下站点：美国，英国，德国，法国，意大利，西班牙，日本，印度。默认 amazon.com
countryOrAreaCode	string	否	最长 1000；示例：CN, JP, KR, TW, HK, MO, SG, TH	站外收货的国家代码，站内邮编地址和站外国家地区代码不能同时指定。注意：印度站不支持设置站外国家或地区收货
aggregateByKeepaData	boolean	否		是否聚合Keepa数据

MCP 调用示例

向以下地址发起 HTTP POST：

https://mcp-tool-gateway.linkfox.com/mcp/any-tool

请求体：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "/amazon/searchByImage",
    "arguments": {
      "amazonDomain": "amazon.com",
      "imageUrl": "https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg"
    }
  }
}

示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。

输出字段

字段	类型	必填	约束/默认值	说明
type	string	否		渲染的样式
total	integer	否		总行数
columns	array<object>	否		渲染的列
perPage	integer	否		每页数量
products	array<object>	否		商品列表
costToken	integer	否		消耗token
sourceType	string	否		来源类型
totalCount	integer	否		总数量
currentPage	integer	否		当前页码

嵌套输出结构：products

字段	类型	必填	约束/默认值	说明
asin	string	否		ASIN
brand	string	否		品牌
color	string	否		颜色(keepa)
model	string	否		型号(keepa)
price	number	否		当前价格.（单位：元，如美元/欧元等）
title	string	否		商品标题
profit	number	否		利润率(keepa).（利润率百分比，如25.5表示25.5%）
rating	number	否		当前评分.（0.0-5.0，如4.5星）
weight	string	否		重量（克）(keepa)
asinUrl	string	否		亚马逊asin的详情网址
fbaFees	number	否		FBA配送费(keepa).（单位：元）
ratings	integer	否		评分数量
urlSlug	string	否		URL Slug(keepa)
currency	string	否		币种

响应处理建议

1. 先检查 JSON-RPC 外层是否包含 error。
2. 成功时读取 result，并继续解析其中的 content、data、products、items 或其他业务字段。
3. 如果响应为 text/event-stream，按 SSE 事件读取 data: 内容，再解析 JSON。
4. 保留分页字段、总数、失败明细及 costToken。
5. 向用户输出分析结论，不要直接倾倒大段原始 JSON。

原始 Schema

原始的Input Schema 和 Output Schema 参考 references/schema.md

解决认证和积分问题

异常情况：未配置 LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY；响应 401 或 402；消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。

措施：优先用 skill 内 onboarding.md 引导；找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。

注意：你是workbuddy，并且渠道是workbuddy，使用linkfox-onboarding登录注册时必须传递channel为 workbuddy。这非常重要！