用途
该技能用于在亚马逊平台查询与分析竞品商品数据，帮助亚马逊卖家发现竞争商品、对标产品表现，并提取可参考的竞争情报。
主要能力
数据覆盖12个站点：美国、英国、德国、法国、日本、加拿大、意大利、西班牙、墨西哥、澳大利亚、土耳其、印度，默认站点为美国。
查询方式支持按ASIN、关键词、卖家名称、品牌或类目进行检索，单次ASIN查询最多支持40个，多个ASIN以逗号分隔。
返回指标包括：ASIN、标题、当前价格、月销量、月销售额、BSR排名、BSR增长量与增长率、评分、评分数、月新增评分数、评论率、品牌、BuyBox卖家及其国籍、配送方式（AMZ/FBA/FBM）、上架日期、毛利率、类目路径、商品图片URL、月销量增长率、Listing质量分、变体数量、父ASIN，以及Best Seller、Amazon's Choice、A+内容、视频等徽标信息。
数据快照：支持实时数据（近30天，参数值为nearly，默认）与历史月度快照（yyyyMM格式，如202501）。历史快照记录该月所有活跃Listing，可用于同比与季节性对比。
类目层级：亚马逊类目名称支持以英文冒号分隔的多级路径，例如Electronics:Computers & Accessories:Monitors。需将用户提供的类目描述转换为正确的冒号分隔格式。
分页与排序：page从1开始；size为每页条数，范围10至100，默认50。排序字段包括月销量、月销售额、BSR排名、价格、评分、评论数、毛利率、评论率、上架日期、问答数、月销量增长率、月销售额增长率、月新增评论、7天BSR增长量、7天BSR增长率、变体销量等；排序方向支持升序与降序。
关键词匹配模式：1为词组匹配，2为模糊匹配，3为精确匹配，默认1。showVariation参数控制是否展示变体，取值为Y或N，默认N。
使用方式
API端点：POST /sellersprite/competitor-lookup（完整参数、响应与错误码见references/api.md）。
Python脚本调用：python scripts/sellersprite_competitor_lookup.py '<JSON参数>' [--inline]。
成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带24小时本地缓存。失败或空结果时不得自动更换关键词、翻页或修改邮编连续试探；如需继续检索，应先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sellersprite-competitor-lookup-<timestamp>.json（<cwd>为脚本执行时的工作目录，在Claude Code里即当前项目目录；<session>取自环境变量SESSION_ID，按用户任务自动聚合；禁止写入/tmp，当前目录不可写则报错）。响应体≤8KB时，落盘后将完整JSON打印到stdout；响应体>8KB时，落盘后stdout只输出摘要（顶层字段、常见计数如total/costToken、最大列表字段的长度及前3条样本）。加--inline可强制全量打印到stdout（同样落盘）。读取数据时建议先看摘要判断是否足够，需要具体字段时优先用jq或ConvertFrom-Json从保存的json文件按需抽取，避免整份JSON进入上下文。
认证与算力问题：未配置API Key（环境变量LINKFOX_AGENT_API_KEY或LINKFOXAGENT_API_KEY均未配置）、响应401或402状态码、响应提示算力或余额不足（如"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"等）时，采用references/onboarding.md引导解决。
调用示例： 按ASIN查询竞品：{"marketplace": "US", "asinList": "B072MQ5BRX,B08N5WRWNW"} 按关键词搜索竞品：{"marketplace": "US", "keyword": "wireless earbuds", "matchType": 1, "order": {"field": "total_units", "desc": "true"}, "size": 20} 按品牌与类目筛选：{"marketplace": "US", "brand": "Anker", "nodeLabel": "Electronics:Headphones", "order": {"field": "total_amount", "desc": "true"}} 按卖家名称查找：{"marketplace": "DE", "sellerName": "Anker Direct", "order": {"field": "bsr_rank", "desc": "false"}} 历史快照对比：{"marketplace": "US", "keyword": "space heater", "dataSnapshotMonth": "202412", "order": {"field": "total_units", "desc": "true"}, "size": 20} 展示变体：{"marketplace": "JP", "asinList": "B0XXXXXXXXX", "showVariation": "Y"}
展示规则：以清晰表格展示查询结果，包含ASIN、标题、价格、月销量、BSR、评分、品牌等关键指标，除非用户要求，不提供主观商业建议。按关键词搜索时，需将关键词翻译为目标站点语言（如美国/英国用英语、德国用德语、日本用日语），若用户提供的关键词语言不符需提醒。展示BSR数据时提醒用户BSR数值越低表示销售表现越强。展示增长率时说明正负值含义（BSR增长量为正表示BSR数值上升，即排名变差）。当结果总数超过返回页数时，告知总数并询问是否获取更多页。当商品带有Best Seller、Amazon's Choice、A+内容、视频等徽标时，在结果中突出显示，因其是重要竞争信号。查询失败时根据message字段说明原因并建议调整参数。用户需要季节性或多趋势分析时，主动建议使用历史快照（如去年同期）进行对比。
适用场景
适用于亚马逊竞品商品数据查询，包括：查找某ASIN的竞品、按关键词发现热销商品、分析某卖家的商品组合、浏览某类目下的商品、估算特定ASIN的月销量、发现增长势头良好的新品、跨品牌产品对比、分析某细分市场在某历史月份的表现、按多指标筛选高分热销商品、分析类目中的FBA与FBM分布。
不适用场景：ABA搜索词数据或关键词排名（应使用ABA Data Explorer）；广告/PPC活动管理；商品评论内容或情感分析；Listing文案撰写或优化建议；供应商采购或制造成本；账号健康状况或政策合规。
限制
结果上限：每页返回10至100条记录（由size控制），更大结果集需分页。 ASIN限制：通过asinList单次最多查询40个ASIN。 历史快照：仅支持查询已存在的月度快照，不支持未来日期。 关键词语言：关键词需匹配站点语言以获得最佳结果。
算力消耗
消耗15算力。用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。