Install
openclaw skills install @linkfox-ai/linkfox-amazon-product-selectionLinkfox 亚马逊选品
亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。
Linkfox 亚马逊选品（Amazon Product Selection）
亚马逊选品一站式 AI 工具集，整合 12 类底层工具、33 项子能力，覆盖前台实时、历史时序、关键词与流量、利基市场、商业洞察与评论挖掘。各子能力完整参数、响应字段与错误码见 references/ 下对应文件，可执行脚本见 scripts/。
能力边界
✅ 能力范围
- 前台实时数据：关键词搜索排名与 SERP、以图搜图（
amazon_search）、商品详情/五点/A+/变体（amazon_product_detail）、按星级筛选评论（amazon_reviews）、Alexa 自然语言导购（amazon_alexa_assistant）。 - 竞品搜索：卖家精灵竞品查询（按关键词/ASIN/卖家/品牌/类目反查竞品，含销量、BSR、定价、评分与增长趋势，
sellersprite竞品查询）、极目按 ASIN 挖同细分市场竞品并按转化率/销量/价格/利润多维筛选（jiimorepage-asins-by-asin）。 - 历史时序与趋势：Keepa 商品详情/搜索/历史曲线（
keepa，价格/BSR/月销/卖家数）、Sorftime 详情/搜索与趋势回看（sorftime，含 FBA 利润、Deal 历史、历史快照）。 - 关键词与流量分析：ABA 搜索词挖掘（
amazon_aba_search_term）、Jungle Scout 反查/拓展/历史/声量份额（jungle_scout）、SIF ASIN 关键词反查/ASIN 流量结构/关键词竞争概览/关键词下竞品流量来源拆解（sif_search_intelligence）、卖家精灵流量词反查（sellersprite流量关键词）。 - 利基与市场分析：极目细分市场指标/评论/竞品/潜力爆品（
jiimore）、卖家精灵商品搜索选品、选市场列表与统计看板（sellersprite）、Jungle Scout 商品库与销量预估（jungle_scout）。 - 商业洞察与反向选品：按关键词生成市场潜力/产品特征/评论/客户画像/搜索趋势/定价六维 AI 报告，按 30+ 商业维度反向筛选蓝海赛道（
amazon_business_insight）。 - 覆盖美国、英国、德国、法国、日本、加拿大、意大利、西班牙、印度、墨西哥、巴西等 15+ 站点（站点集合随工具略有差异，详见各 references）。
❌ 边界与限制
- API Key 必需：所有工具均需环境变量
LINKFOX_AGENT_API_KEY（或LINKFOXAGENT_API_KEY）；各工具独立计费、独立限频，数据时效与站点覆盖随数据源而异。 - 计费约束：同一会话同一参数组合默认只调用一次（脚本带 24h 本地缓存）；失败或空结果不得自动换关键词、翻页或改邮编连续试探；需继续检索时先向用户说明会产生额外消耗（各工具计费规则见
skills-version.json对应条目与 references 内 api.md 的costToken字段）。 - 不在范围内：店铺运营（Listing 刊登/订单/库存，用 SP-API 系列）、广告投放与管理（用 Amazon Ads 系列）、物流与供应链规划、1688 找货源、TikTok/沃尔玛等其他平台选品、非电商任务、与平台或卖家的直接沟通、实时库存与订单处理。
- 数据时效：前台类工具为实时抓取（含 SERP 排名、评论、Alexa）；历史类（Keepa/Sorftime/ABA）为各自数据源的更新周期，
lastUpdate/costToken等字段标识刷新与消耗。
工具选择指南
按需求在下表定到子能力，再跳到【业务需求路由速查】查端点/脚本/references 取参执行。
| 需求 / 用户说 | 默认推荐（子能力） | 何时换用其他 |
|---|---|---|
| ASIN 商品数据 / 价格销量趋势（"这个 ASIN 卖得怎么样"） | linkfox-keepa-product-request（字段最全） | 要 FBA 利润+趋势回看用 linkfox-sorftime-amazon-product-detail；要 A+/变体/实时价用 linkfox-amazon-product-detail |
| ASIN 流量词反查（"ASIN 的流量词有哪些"） | linkfox-sif-asin-keywords（流量词+排名+搜索量） | 要 PPC 竞价+排名难度用 linkfox-junglescout-keyword-by-asin；要转化类型+历史月份用 linkfox-sellersprite-traffic-keyword |
| 关键词拓展 / 相关流量词（"这个词有哪些相关词/长尾词"） | linkfox-junglescout-keyword-by-keyword（种子词拓展，含搜索量/趋势/PPC 竞价） | 要按 ASIN 反查其流量词用 linkfox-sif-asin-keywords；要官方搜索词排名（非拓展）用 linkfox-aba-intelligent-query |
| 关键词搜索量趋势（"这个词的搜索量/排名"） | linkfox-junglescout-keyword-history（精确搜索量） | 要官方搜索排名（非搜索量）用 linkfox-aba-intelligent-query |
| 商品搜索 / 选品筛选（"帮我选品 / 什么好卖"） | linkfox-keepa-product-search（多维+历史） | 要历史快照回看用 linkfox-sorftime-amazon-product-query；要毛利筛选用 linkfox-sellersprite-product-search；要实时 SERP 用 linkfox-amazon-search |
| 关键词竞争度（"这个词竞争大不大"） | linkfox-sif-keyword-overview（供需比+搜索量） | 要品牌声量份额用 linkfox-junglescout-keyword-share-of-voice |
| 利基 / 细分市场评估（"细分市场能不能进"） | linkfox-jiimore-get-niche-info-by-keyword（垄断/品牌/新品成功率） | 要类目维度看板用 linkfox-sellersprite-market-research / -market-statistics；要多条件筛选商品库用 linkfox-junglescout-product-database |
| ASIN 销量预估 | linkfox-junglescout-sales-estimates（日维度） | 要 12 月月销趋势用 linkfox-keepa-product-request |
| 利基评论 / 痛点（"评论痛点 / 差评"） | linkfox-jiimore-get-niche-review-from-keyword（细分市场级） | 要单 ASIN 评论用 linkfox-amazon-reviews-list |
| ASIN 流量结构 / 竞品分析 | linkfox-sif-asin-summary（ASIN 流量构成） | 要关键词下竞品流量拆解用 linkfox-sif-keyword-summary |
| 竞品反查（关键词/ASIN/卖家/品牌） | linkfox-sellersprite-competitor-lookup | 要按 ASIN 挖同细分竞品用 linkfox-jiimore-page-asins-by-asin |
| 六维 AI 市场报告（"AI 市场报告"） | linkfox-amazon-opportunity-report-by-keyword | — |
| 反向按指标找赛道（"按条件反找赛道"） | linkfox-amazon-opportunity-search-by-metrics | — |
| 前台实时搜索 / 以图搜图（"前台搜一下这个词"） | linkfox-amazon-search / linkfox-amazon-search-by-image | — |
| 自然语言导购（"用自然语言问亚马逊推荐"） | linkfox-amazon-alexa-search | — |
工具选择思路
- 重要：多个子能力满足需求时，要依据需求深入分析子能力的功能、用途、出入参、从中调研出最合适的子能力，并推荐用户，让用户自己决定。
- 满足程度同等的前提下，向用户推荐“默认推荐子能力”。
业务需求路由速查
按【工具选择指南】定到子能力 后，下表查端点、脚本与 references 文件取参执行：
子能力 ↔ references 文件 ↔ 端点 ↔ 脚本（33 项）
amazon_aba_search_term
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-aba-intelligent-query | references/linkfox-aba-intelligent-query.md | POST /aba/intelligentQuery | aba_query.py |
amazon_alexa_assistant
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-amazon-alexa-search | references/linkfox-amazon-alexa-search.md | POST /amazon/alexaSearch | amazon_alexa_search.py |
amazon_business_insight
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-amazon-opportunity-report-by-keyword | references/linkfox-amazon-opportunity-report-by-keyword.md | POST /amazon/opportunity/reportByKeyword | amazon_opportunity_report.py |
| linkfox-amazon-opportunity-search-by-metrics | references/linkfox-amazon-opportunity-search-by-metrics.md | POST /amazon/opportunity/searchByMetrics | amazon_opportunity_screener.py |
amazon_search
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-amazon-search | references/linkfox-amazon-search.md | POST /amazon/search | amazon_search.py |
| linkfox-amazon-search-by-image | references/linkfox-amazon-search-by-image.md | POST /amazon/searchByImage | amazon_search_by_image.py、upload_image.py |
amazon_product_detail
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-amazon-product-detail | references/linkfox-amazon-product-detail.md | POST /amazon/product/detail | amazon_product_detail.py |
amazon_reviews
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-amazon-reviews-list | references/linkfox-amazon-reviews-list.md | POST /amazon/reviews/list | amazon_reviews.py |
jiimore
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-jiimore-get-niche-info-by-keyword | references/linkfox-jiimore-get-niche-info-by-keyword.md | POST /jiimore/getNicheInfoByKeyword | jiimore_get_niche_info_by_keyword.py |
| linkfox-jiimore-get-niche-info | references/linkfox-jiimore-get-niche-info.md | POST /jiimore/getNicheInfo | jiimore_get_niche_info.py |
| linkfox-jiimore-get-niche-review-from-keyword | references/linkfox-jiimore-get-niche-review-from-keyword.md | POST /jiimore/getNicheReviewFromKeyword | jiimore_get_niche_review.py |
| linkfox-jiimore-product-discovery | references/linkfox-jiimore-product-discovery.md | POST /jiimore/productDiscovery | jiimore_product_discovery.py |
| linkfox-jiimore-page-asins-by-asin | references/linkfox-jiimore-page-asins-by-asin.md | POST /jiimore/pageAsinsByAsin | jiimore_page_asins_by_asin.py |
jungle_scout
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-junglescout-keyword-by-asin | references/linkfox-junglescout-keyword-by-asin.md | POST /tool-jungle-scout/keywords/by-asin | junglescout_keyword_by_asin.py |
| linkfox-junglescout-keyword-by-keyword | references/linkfox-junglescout-keyword-by-keyword.md | POST /tool-jungle-scout/keywords/by-keyword | junglescout_keyword_by_keyword.py |
| linkfox-junglescout-keyword-history | references/linkfox-junglescout-keyword-history.md | POST /tool-jungle-scout/keywords/historical-search-volume | junglescout_keyword_history.py |
| linkfox-junglescout-keyword-share-of-voice | references/linkfox-junglescout-keyword-share-of-voice.md | POST /tool-jungle-scout/keywords/share-of-voice | junglescout_keyword_sov.py |
| linkfox-junglescout-product-database | references/linkfox-junglescout-product-database.md | POST /tool-jungle-scout/product-database/query | junglescout_product_database.py |
| linkfox-junglescout-sales-estimates | references/linkfox-junglescout-sales-estimates.md | POST /tool-jungle-scout/sales-estimates/query | junglescout_sales_estimates.py |
keepa
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-keepa-product-request | references/linkfox-keepa-product-request.md | POST /keepa/productRequest | keepa_product_detail.py |
| linkfox-keepa-product-search | references/linkfox-keepa-product-search.md | POST /keepa/productSearch | keepa_product_search.py |
| linkfox-keepa-product-series | references/linkfox-keepa-product-series.md | POST /keepa/productSeries | keepa_product_history.py |
sellersprite
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-sellersprite-competitor-lookup | references/linkfox-sellersprite-competitor-lookup.md | POST /sellersprite/competitor-lookup | sellersprite_competitor_lookup.py |
| linkfox-sellersprite-product-search | references/linkfox-sellersprite-product-search.md | POST /sellersprite/productSearch | sellersprite_product_search.py |
| linkfox-sellersprite-market-research | references/linkfox-sellersprite-market-research.md | POST /sellersprite/market/research | sellersprite_market_research.py |
| linkfox-sellersprite-market-statistics | references/linkfox-sellersprite-market-statistics.md | POST /sellersprite/market/statistics | sellersprite_market_statistics.py |
| linkfox-sellersprite-traffic-keyword | references/linkfox-sellersprite-traffic-keyword.md | POST /sellersprite/traffic/keyword | sellersprite_traffic_keyword.py |
sif_search_intelligence
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-sif-asin-keywords | references/linkfox-sif-asin-keywords.md | POST /sif/asinKeywords | sif_asin_keywords.py |
| linkfox-sif-asin-summary | references/linkfox-sif-asin-summary.md | POST /sif/asinSummary | sif_asin_summary.py |
| linkfox-sif-keyword-overview | references/linkfox-sif-keyword-overview.md | POST /sif/keywordOverview | sif_keyword_overview.py |
| linkfox-sif-keyword-summary | references/linkfox-sif-keyword-summary.md | POST /sif/keywordSummary | sif_keyword_traffic.py |
sorftime
| 子能力 | references 文件 | 端点 | 脚本 |
|---|---|---|---|
| linkfox-sorftime-amazon-product-detail | references/linkfox-sorftime-amazon-product-detail.md | POST /sorftime/amazon/productDetail | sorftime_product_detail.py |
| linkfox-sorftime-amazon-product-query | references/linkfox-sorftime-amazon-product-query.md | POST /sorftime/amazon/productQuery | sorftime_product_search.py |
调用方式
- 网关：
${LINKFOX_TOOL_GATEWAY}/<端点>，请求方式 POST、Content-Typeapplication/json，认证 HeaderAuthorization: <api_key>（api_key 从环境变量LINKFOX_AGENT_API_KEY或LINKFOXAGENT_API_KEY读取；未配置按下方【解决认证和积分问题】处理）。各端点路径见下方【业务需求路由速查】与对应 references 文件。 - Python 脚本：每项子能力对应
scripts/<脚本名>.py '<JSON 参数>' [--inline]（脚本名与端点见路由速查表）。脚本内部完成网关调用、鉴权与落盘。 - 输出策略（脚本默认行为）：始终将完整响应写入
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill>-<timestamp>.json（<cwd>为脚本执行时工作目录；<session>取自环境变量SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）；响应体 ≤ 8 KB 落盘后完整打印到 stdout，> 8 KB 仅打印摘要（顶层字段、常见计数、最大列表长度 + 前 3 条样本）；加--inline强制全量打印（同样落盘）。 - 读数据建议：先看摘要判断是否足够；需要具体字段时优先用
jq或 PowerShellConvertFrom-Json从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。 - 完整参数：每个子能力的请求参数、响应字段、错误码、curl 示例见
references/<源skill>.md（文件内含该子能力 SKILL.md 正文与 api.md 全文）。
使用示例
以下按数据层给出代表性子能力的出入参示例；其余子能力参数见对应 references 文件。domain 为 Keepa 站点数字 ID（1=美/2=英/3=德/5=日…），marketplace/amazonDomain/country/countryCode/region 为各工具的站点代码，含义见 references。
前台实时层
1. 关键词搜索排名（amazon_search → amazon_search.py）
{"keyword": "wireless earbuds", "amazonDomain": "amazon.com", "page": 1}
出参：products[]（asin/title/brand/price/rating/ratings/position/sponsored/imageUrl/asinUrl/delivery）、total、costToken。
2. 以图搜图（amazon_search_by_image → amazon_search_by_image.py，需先 upload_image.py 上传）
{"imageUrl": "https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg", "amazonDomain": "amazon.com", "sort": "default"}
出参：products[]（asin/title/price/oldPrice/rating/ratings/brand）；设 aggregateByKeepaData:true 可聚合 salesRank/monthlySalesUnits/fbaFees/profit。
3. 商品详情（amazon_product_detail → amazon_product_detail.py）
{"asins": "B072MQ5BRX,B08N5WRWNW", "amazonDomain": "amazon.com"}
出参：products[]（asin/title/brand/price/oldPrice/rating/ratings/aboutItem/variants/customerReviews/productImageUrls）、total、costToken。
4. 商品评论（amazon_reviews → amazon_reviews.py）
{"asin": "B08N5WRWNW", "domainCode": "com", "star1Num": 10, "star2Num": 10, "star3Num": 10, "star4Num": 10, "star5Num": 10, "sortBy": "recent"}
出参：data[]（reviewId/title/text/rating/date/userName/verified/vine/numberOfHelpful/imageUrlList/videoUrlList）、total、costToken。
5. Alexa 导购问答（amazon_alexa_assistant → amazon_alexa_search.py）
{"prompts": ["best wireless earbuds for running"], "format": "json"}
出参：data（导购回答/推荐商品分组/ASIN 列表/可追问问题）、resultsNum、costToken。仅支持单条 prompt，追问需 agent 拼接上下文后发起新请求。
历史时序层
6. Keepa 商品详情（keepa → keepa_product_detail.py）
{"asin": "B0088PUEPK", "domain": "1", "history": 1}
出参：products[]（asin/title/price/salesRank/salesRank30/90/180/monthlySalesUnits(含近12月)/monthlySalesRevenue/fbaFees/profit/rating/reviewCount/categoryTree/lastUpdate）、costToken。批量最多 5 个 ASIN。
7. Sorftime 商品详情与趋势（sorftime → sorftime_product_detail.py）
{"asin": "B00FLYWNYQ", "marketplace": "us"}
出参：products[]（asin/title/price/profitRate/profitAmount/salesRank/monthlySalesUnits/rating/fbaFees/bsrRankTrend/priceTrend/rankTrend/dealTrend）、costToken。
关键词与流量层
8. ABA 搜索词分析（amazon_aba_search_term → aba_query.py）
{"analysisDescription": "筛选美国站关键词gift在过去12周的搜索热度排名", "region": "US"}
出参：tables（搜索词/周开始日期/站点/搜索排名/点击ASIN/商品名/点击占比/转化占比）、total、downloadUrl（createDownloadUrl:true 时生成 CSV）、costToken。
9. Jungle Scout 关键词拓展（jungle_scout → junglescout_keyword_by_keyword.py）
{"marketplace": "us", "searchTerms": "yoga mat", "needCount": 20}
出参：keywordInfoList[]（name/monthlySearchVolumeExact/monthlySearchVolumeBroad/monthlyTrend/dominantCategory/organicProductCount/ppcBidExact/ppcBidBroad/easeOfRankingScore）、costToken。
10. SIF 关键词竞争概览（sif_search_intelligence → sif_keyword_overview.py）
{"keyword": "wireless charger", "country": "US"}
出参：keyword/keywordPopularityRank/estimatedWeeklySearchVolume/supplyDemandRatio/totalSearchResultProductCount/sponsoredProductsCount/paidAdvertisingProductCount/trackedAsinTotalCount。
利基与市场层
11. 极目利基市场分析（jiimore → jiimore_get_niche_info_by_keyword.py）
{"keyword": "wireless earbuds", "countryCode": "US", "sortField": "demand", "sortType": "desc", "pageSize": 20}
出参：data（nicheId/nicheTitle/translationZh/demand/productCount/avgPrice/searchVolumeWeekly/unitsSoldWeekly/brandCount/top5BrandsClickShare/launchRateSemiannual/cpc）、costToken。
12. 卖家精灵商品搜索选品（sellersprite → sellersprite_product_search.py）
{"keyword": "yoga mat", "marketplace": "US", "minUnits": 300, "minPrice": 10, "maxPrice": 50, "order": {"field": "total_units", "desc": "true"}, "page": 1, "size": 20}
出参：products[]（asin/title/price/月销量/月销售额/BSR/评分/毛利率/配送方式）、total、costToken。
商业洞察层
13. 六维 AI 市场机会报告（amazon_business_insight → amazon_opportunity_report.py）
{"site": "US", "keyword": "ice bricks"}
出参：市场潜力/产品特征/用户评论/客户画像/搜索趋势/定价分析六维 AI 报告，costTime、costToken。当前仅支持 US 站。
14. 反向选品赛道筛选（amazon_business_insight → amazon_opportunity_screener.py）
{"nicheBrandCountLte": 20, "nicheSearchVolumeYoyChangePctAtLeastGte": 100, "featureNewAvgReviewCountAtLeastLte": 500, "limit": 25}
出参：data[]（每条约 37 字段：keyword/nicheName/nicheRevenue360d/nicheBrandCount/priceMinUsd/demoGenderDominant/reviewNegativeTop1Topic…），至少一个过滤条件。计费按返回条数 N（即使 N=0 也按最低计费）。
展示规则
- 客观呈现数据：以清晰表格展示查询结果，不做主观商业建议（除非用户主动要求）；不同平台币种不同，展示价格/收入时务必提示币种（响应
currency字段标明本地币种）。 - 来源标注：展示数据时说明来自哪个工具/数据源（Keepa/Sorftime/Jungle Scout/极目/SIF/卖家精灵/ABA/前台/商业洞察）。
- 不可用数据：值为
0或-1的字段表示数据不可用，标注"N/A"或省略，不作实际值展示。 - 错误处理与协同：查询失败时根据响应
errcode/errmsg说明原因并建议修正（ASIN 格式、站点不支持、参数越界等）；连续使用多工具时将各工具发现汇总为连贯分析，标注数据来源与时间窗。
解决认证和积分问题
异常情况：未配置 LINKFOX_AGENT_API_KEY/LINKFOXAGENT_API_KEY；响应 401 或 402；消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
措施：优先用 skill 内 onboarding.md 引导；找不到则加载 /linkfox-onboarding skill（未安装先下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip 解压安装）。
注意：你是workbuddy，并且渠道是workbuddy，使用linkfox-onboarding登录注册时必须传递channel为 workbuddy。这非常重要！
- Downloads
- Security audit
- Review
- Last updated
- 4h ago
- Current version
- v1.2.0
- License
- MIT-0