Back to Details

linkfox-amazon-product-selection

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Linkfox 亚马逊选品（Amazon Product Selection）

Linkfox 亚马逊选品（Amazon Product Selection）

亚马逊选品一站式 AI 工具集，整合 12 类底层工具、33 项子能力，覆盖前台实时、历史时序、关键词与流量、利基市场、商业洞察与评论挖掘。各子能力完整参数、响应字段与错误码见 
references/
下对应文件，可执行脚本见 
scripts/
。
亚马逊选品一站式 AI 工具集，整合 12 类底层工具、33 项子能力，覆盖前台实时、历史时序、关键词与流量、利基市场、商业洞察与评论挖掘。各子能力完整参数、响应字段与错误码见 
references/
下对应文件，可执行脚本见 
scripts/
。

能力边界

能力边界

✅ 能力范围

✅ 能力范围

  • 前台实时数据：关键词搜索排名与 SERP、以图搜图（
    amazon_search
    ）、商品详情/五点/A+/变体（
    amazon_product_detail
    ）、按星级筛选评论（
    amazon_reviews
    ）、Alexa 自然语言导购（
    amazon_alexa_assistant
    ）。
  • 竞品搜索：卖家精灵竞品查询（按关键词/ASIN/卖家/品牌/类目反查竞品，含销量、BSR、定价、评分与增长趋势，
    sellersprite
    竞品查询）、极目按 ASIN 挖同细分市场竞品并按转化率/销量/价格/利润多维筛选（
    jiimore
    page-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）。
  • 前台实时数据：关键词搜索排名与 SERP、以图搜图（
    amazon_search
    ）、商品详情/五点/A+/变体（
    amazon_product_detail
    ）、按星级筛选评论（
    amazon_reviews
    ）、Alexa 自然语言导购（
    amazon_alexa_assistant
    ）。
  • 竞品搜索：卖家精灵竞品查询（按关键词/ASIN/卖家/品牌/类目反查竞品，含销量、BSR、定价、评分与增长趋势，
    sellersprite
    竞品查询）、极目按 ASIN 挖同细分市场竞品并按转化率/销量/价格/利润多维筛选（
    jiimore
    page-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
    等字段标识刷新与消耗。
  • 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 取参执行。
需求 / 用户说默认推荐（子能力）何时换用其他
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 文件取参执行：

子能力 ↔ references 文件 ↔ 端点 ↔ 脚本（33 项）

子能力 ↔ references 文件 ↔ 端点 ↔ 脚本（33 项）

amazon_aba_search_term
子能力references 文件端点脚本
linkfox-aba-intelligent-queryreferences/linkfox-aba-intelligent-query.mdPOST /aba/intelligentQueryaba_query.py
amazon_alexa_assistant
子能力references 文件端点脚本
linkfox-amazon-alexa-searchreferences/linkfox-amazon-alexa-search.mdPOST /amazon/alexaSearchamazon_alexa_search.py
amazon_business_insight
子能力references 文件端点脚本
linkfox-amazon-opportunity-report-by-keywordreferences/linkfox-amazon-opportunity-report-by-keyword.mdPOST /amazon/opportunity/reportByKeywordamazon_opportunity_report.py
linkfox-amazon-opportunity-search-by-metricsreferences/linkfox-amazon-opportunity-search-by-metrics.mdPOST /amazon/opportunity/searchByMetricsamazon_opportunity_screener.py
amazon_search
子能力references 文件端点脚本
linkfox-amazon-searchreferences/linkfox-amazon-search.mdPOST /amazon/searchamazon_search.py
linkfox-amazon-search-by-imagereferences/linkfox-amazon-search-by-image.mdPOST /amazon/searchByImageamazon_search_by_image.py、upload_image.py
amazon_product_detail
子能力references 文件端点脚本
linkfox-amazon-product-detailreferences/linkfox-amazon-product-detail.mdPOST /amazon/product/detailamazon_product_detail.py
amazon_reviews
子能力references 文件端点脚本
linkfox-amazon-reviews-listreferences/linkfox-amazon-reviews-list.mdPOST /amazon/reviews/listamazon_reviews.py
jiimore
子能力references 文件端点脚本
linkfox-jiimore-get-niche-info-by-keywordreferences/linkfox-jiimore-get-niche-info-by-keyword.mdPOST /jiimore/getNicheInfoByKeywordjiimore_get_niche_info_by_keyword.py
linkfox-jiimore-get-niche-inforeferences/linkfox-jiimore-get-niche-info.mdPOST /jiimore/getNicheInfojiimore_get_niche_info.py
linkfox-jiimore-get-niche-review-from-keywordreferences/linkfox-jiimore-get-niche-review-from-keyword.mdPOST /jiimore/getNicheReviewFromKeywordjiimore_get_niche_review.py
linkfox-jiimore-product-discoveryreferences/linkfox-jiimore-product-discovery.mdPOST /jiimore/productDiscoveryjiimore_product_discovery.py
linkfox-jiimore-page-asins-by-asinreferences/linkfox-jiimore-page-asins-by-asin.mdPOST /jiimore/pageAsinsByAsinjiimore_page_asins_by_asin.py
jungle_scout
子能力references 文件端点脚本
linkfox-junglescout-keyword-by-asinreferences/linkfox-junglescout-keyword-by-asin.mdPOST /tool-jungle-scout/keywords/by-asinjunglescout_keyword_by_asin.py
linkfox-junglescout-keyword-by-keywordreferences/linkfox-junglescout-keyword-by-keyword.mdPOST /tool-jungle-scout/keywords/by-keywordjunglescout_keyword_by_keyword.py
linkfox-junglescout-keyword-historyreferences/linkfox-junglescout-keyword-history.mdPOST /tool-jungle-scout/keywords/historical-search-volumejunglescout_keyword_history.py
linkfox-junglescout-keyword-share-of-voicereferences/linkfox-junglescout-keyword-share-of-voice.mdPOST /tool-jungle-scout/keywords/share-of-voicejunglescout_keyword_sov.py
linkfox-junglescout-product-databasereferences/linkfox-junglescout-product-database.mdPOST /tool-jungle-scout/product-database/queryjunglescout_product_database.py
linkfox-junglescout-sales-estimatesreferences/linkfox-junglescout-sales-estimates.mdPOST /tool-jungle-scout/sales-estimates/queryjunglescout_sales_estimates.py
keepa
子能力references 文件端点脚本
linkfox-keepa-product-requestreferences/linkfox-keepa-product-request.mdPOST /keepa/productRequestkeepa_product_detail.py
linkfox-keepa-product-searchreferences/linkfox-keepa-product-search.mdPOST /keepa/productSearchkeepa_product_search.py
linkfox-keepa-product-seriesreferences/linkfox-keepa-product-series.mdPOST /keepa/productSerieskeepa_product_history.py
sellersprite
子能力references 文件端点脚本
linkfox-sellersprite-competitor-lookupreferences/linkfox-sellersprite-competitor-lookup.mdPOST /sellersprite/competitor-lookupsellersprite_competitor_lookup.py
linkfox-sellersprite-product-searchreferences/linkfox-sellersprite-product-search.mdPOST /sellersprite/productSearchsellersprite_product_search.py
linkfox-sellersprite-market-researchreferences/linkfox-sellersprite-market-research.mdPOST /sellersprite/market/researchsellersprite_market_research.py
linkfox-sellersprite-market-statisticsreferences/linkfox-sellersprite-market-statistics.mdPOST /sellersprite/market/statisticssellersprite_market_statistics.py
linkfox-sellersprite-traffic-keywordreferences/linkfox-sellersprite-traffic-keyword.mdPOST /sellersprite/traffic/keywordsellersprite_traffic_keyword.py
sif_search_intelligence
子能力references 文件端点脚本
linkfox-sif-asin-keywordsreferences/linkfox-sif-asin-keywords.mdPOST /sif/asinKeywordssif_asin_keywords.py
linkfox-sif-asin-summaryreferences/linkfox-sif-asin-summary.mdPOST /sif/asinSummarysif_asin_summary.py
linkfox-sif-keyword-overviewreferences/linkfox-sif-keyword-overview.mdPOST /sif/keywordOverviewsif_keyword_overview.py
linkfox-sif-keyword-summaryreferences/linkfox-sif-keyword-summary.mdPOST /sif/keywordSummarysif_keyword_traffic.py
sorftime
子能力references 文件端点脚本
linkfox-sorftime-amazon-product-detailreferences/linkfox-sorftime-amazon-product-detail.mdPOST /sorftime/amazon/productDetailsorftime_product_detail.py
linkfox-sorftime-amazon-product-queryreferences/linkfox-sorftime-amazon-product-query.mdPOST /sorftime/amazon/productQuerysorftime_product_search.py
amazon_aba_search_term
子能力references 文件端点脚本
linkfox-aba-intelligent-queryreferences/linkfox-aba-intelligent-query.mdPOST /aba/intelligentQueryaba_query.py
amazon_alexa_assistant
子能力references 文件端点脚本
linkfox-amazon-alexa-searchreferences/linkfox-amazon-alexa-search.mdPOST /amazon/alexaSearchamazon_alexa_search.py
amazon_business_insight
子能力references 文件端点脚本
linkfox-amazon-opportunity-report-by-keywordreferences/linkfox-amazon-opportunity-report-by-keyword.mdPOST /amazon/opportunity/reportByKeywordamazon_opportunity_report.py
linkfox-amazon-opportunity-search-by-metricsreferences/linkfox-amazon-opportunity-search-by-metrics.mdPOST /amazon/opportunity/searchByMetricsamazon_opportunity_screener.py
amazon_search
子能力references 文件端点脚本
linkfox-amazon-searchreferences/linkfox-amazon-search.mdPOST /amazon/searchamazon_search.py
linkfox-amazon-search-by-imagereferences/linkfox-amazon-search-by-image.mdPOST /amazon/searchByImageamazon_search_by_image.py、upload_image.py
amazon_product_detail
子能力references 文件端点脚本
linkfox-amazon-product-detailreferences/linkfox-amazon-product-detail.mdPOST /amazon/product/detailamazon_product_detail.py
amazon_reviews
子能力references 文件端点脚本
linkfox-amazon-reviews-listreferences/linkfox-amazon-reviews-list.mdPOST /amazon/reviews/listamazon_reviews.py
jiimore
子能力references 文件端点脚本
linkfox-jiimore-get-niche-info-by-keywordreferences/linkfox-jiimore-get-niche-info-by-keyword.mdPOST /jiimore/getNicheInfoByKeywordjiimore_get_niche_info_by_keyword.py
linkfox-jiimore-get-niche-inforeferences/linkfox-jiimore-get-niche-info.mdPOST /jiimore/getNicheInfojiimore_get_niche_info.py
linkfox-jiimore-get-niche-review-from-keywordreferences/linkfox-jiimore-get-niche-review-from-keyword.mdPOST /jiimore/getNicheReviewFromKeywordjiimore_get_niche_review.py
linkfox-jiimore-product-discoveryreferences/linkfox-jiimore-product-discovery.mdPOST /jiimore/productDiscoveryjiimore_product_discovery.py
linkfox-jiimore-page-asins-by-asinreferences/linkfox-jiimore-page-asins-by-asin.mdPOST /jiimore/pageAsinsByAsinjiimore_page_asins_by_asin.py
jungle_scout
子能力references 文件端点脚本
linkfox-junglescout-keyword-by-asinreferences/linkfox-junglescout-keyword-by-asin.mdPOST /tool-jungle-scout/keywords/by-asinjunglescout_keyword_by_asin.py
linkfox-junglescout-keyword-by-keywordreferences/linkfox-junglescout-keyword-by-keyword.mdPOST /tool-jungle-scout/keywords/by-keywordjunglescout_keyword_by_keyword.py
linkfox-junglescout-keyword-historyreferences/linkfox-junglescout-keyword-history.mdPOST /tool-jungle-scout/keywords/historical-search-volumejunglescout_keyword_history.py
linkfox-junglescout-keyword-share-of-voicereferences/linkfox-junglescout-keyword-share-of-voice.mdPOST /tool-jungle-scout/keywords/share-of-voicejunglescout_keyword_sov.py
linkfox-junglescout-product-databasereferences/linkfox-junglescout-product-database.mdPOST /tool-jungle-scout/product-database/queryjunglescout_product_database.py
linkfox-junglescout-sales-estimatesreferences/linkfox-junglescout-sales-estimates.mdPOST /tool-jungle-scout/sales-estimates/queryjunglescout_sales_estimates.py
keepa
子能力references 文件端点脚本
linkfox-keepa-product-requestreferences/linkfox-keepa-product-request.mdPOST /keepa/productRequestkeepa_product_detail.py
linkfox-keepa-product-searchreferences/linkfox-keepa-product-search.mdPOST /keepa/productSearchkeepa_product_search.py
linkfox-keepa-product-seriesreferences/linkfox-keepa-product-series.mdPOST /keepa/productSerieskeepa_product_history.py
sellersprite
子能力references 文件端点脚本
linkfox-sellersprite-competitor-lookupreferences/linkfox-sellersprite-competitor-lookup.mdPOST /sellersprite/competitor-lookupsellersprite_competitor_lookup.py
linkfox-sellersprite-product-searchreferences/linkfox-sellersprite-product-search.mdPOST /sellersprite/productSearchsellersprite_product_search.py
linkfox-sellersprite-market-researchreferences/linkfox-sellersprite-market-research.mdPOST /sellersprite/market/researchsellersprite_market_research.py
linkfox-sellersprite-market-statisticsreferences/linkfox-sellersprite-market-statistics.mdPOST /sellersprite/market/statisticssellersprite_market_statistics.py
linkfox-sellersprite-traffic-keywordreferences/linkfox-sellersprite-traffic-keyword.mdPOST /sellersprite/traffic/keywordsellersprite_traffic_keyword.py
sif_search_intelligence
子能力references 文件端点脚本
linkfox-sif-asin-keywordsreferences/linkfox-sif-asin-keywords.mdPOST /sif/asinKeywordssif_asin_keywords.py
linkfox-sif-asin-summaryreferences/linkfox-sif-asin-summary.mdPOST /sif/asinSummarysif_asin_summary.py
linkfox-sif-keyword-overviewreferences/linkfox-sif-keyword-overview.mdPOST /sif/keywordOverviewsif_keyword_overview.py
linkfox-sif-keyword-summaryreferences/linkfox-sif-keyword-summary.mdPOST /sif/keywordSummarysif_keyword_traffic.py
sorftime
子能力references 文件端点脚本
linkfox-sorftime-amazon-product-detailreferences/linkfox-sorftime-amazon-product-detail.mdPOST /sorftime/amazon/productDetailsorftime_product_detail.py
linkfox-sorftime-amazon-product-queryreferences/linkfox-sorftime-amazon-product-query.mdPOST /sorftime/amazon/productQuerysorftime_product_search.py

调用方式

调用方式

  • 网关：
    ${LINKFOX_TOOL_GATEWAY}/<端点>
    ，请求方式 POST、Content-Type 
    application/json
    ，认证 Header 
    Authorization: <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
    或 PowerShell 
    ConvertFrom-Json
    从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
  • 完整参数：每个子能力的请求参数、响应字段、错误码、curl 示例见 
    references/<源skill>.md
    （文件内含该子能力 SKILL.md 正文与 api.md 全文）。
  • 网关：
    ${LINKFOX_TOOL_GATEWAY}/<端点>
    ，请求方式 POST、Content-Type 
    application/json
    ，认证 Header 
    Authorization: <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
    或 PowerShell 
    ConvertFrom-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。
以下按数据层给出代表性子能力的出入参示例；其余子能力参数见对应 references 文件。
domain
为 Keepa 站点数字 ID（
1
=美/
2
=英/
3
=德/
5
=日…），
marketplace
/
amazonDomain
/
country
/
countryCode
/
region
为各工具的站点代码，含义见 references。

前台实时层

前台实时层

1. 关键词搜索排名（amazon_search → amazon_search.py）
json
{"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 上传）
json
{"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）
json
{"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）
json
{"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）
json
{"prompts": ["best wireless earbuds for running"], "format": "json"}
出参：
data
（导购回答/推荐商品分组/ASIN 列表/可追问问题）、
resultsNum
、
costToken
。仅支持单条 prompt，追问需 agent 拼接上下文后发起新请求。
1. 关键词搜索排名（amazon_search → amazon_search.py）
json
{"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 上传）
json
{"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）
json
{"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）
json
{"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）
json
{"prompts": ["best wireless earbuds for running"], "format": "json"}
出参：
data
（导购回答/推荐商品分组/ASIN 列表/可追问问题）、
resultsNum
、
costToken
。仅支持单条 prompt，追问需 agent 拼接上下文后发起新请求。

历史时序层

历史时序层

6. Keepa 商品详情（keepa → keepa_product_detail.py）
json
{"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）
json
{"asin": "B00FLYWNYQ", "marketplace": "us"}
出参：
products[]
（asin/title/price/profitRate/profitAmount/salesRank/monthlySalesUnits/rating/fbaFees/bsrRankTrend/priceTrend/rankTrend/dealTrend）、
costToken
。
6. Keepa 商品详情（keepa → keepa_product_detail.py）
json
{"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）
json
{"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）
json
{"analysisDescription": "筛选美国站关键词gift在过去12周的搜索热度排名", "region": "US"}
出参：
tables
（搜索词/周开始日期/站点/搜索排名/点击ASIN/商品名/点击占比/转化占比）、
total
、
downloadUrl
（
createDownloadUrl:true
时生成 CSV）、
costToken
。
9. Jungle Scout 关键词拓展（jungle_scout → junglescout_keyword_by_keyword.py）
json
{"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）
json
{"keyword": "wireless charger", "country": "US"}
出参：
keyword
/keywordPopularityRank/estimatedWeeklySearchVolume/supplyDemandRatio/totalSearchResultProductCount/sponsoredProductsCount/paidAdvertisingProductCount/trackedAsinTotalCount。
8. ABA 搜索词分析（amazon_aba_search_term → aba_query.py）
json
{"analysisDescription": "筛选美国站关键词gift在过去12周的搜索热度排名", "region": "US"}
出参：
tables
（搜索词/周开始日期/站点/搜索排名/点击ASIN/商品名/点击占比/转化占比）、
total
、
downloadUrl
（
createDownloadUrl:true
时生成 CSV）、
costToken
。
9. Jungle Scout 关键词拓展（jungle_scout → junglescout_keyword_by_keyword.py）
json
{"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）
json
{"keyword": "wireless charger", "country": "US"}
出参：
keyword
/keywordPopularityRank/estimatedWeeklySearchVolume/supplyDemandRatio/totalSearchResultProductCount/sponsoredProductsCount/paidAdvertisingProductCount/trackedAsinTotalCount。

利基与市场层

利基与市场层

11. 极目利基市场分析（jiimore → jiimore_get_niche_info_by_keyword.py）
json
{"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）
json
{"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
。
11. 极目利基市场分析（jiimore → jiimore_get_niche_info_by_keyword.py）
json
{"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）
json
{"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）
json
{"site": "US", "keyword": "ice bricks"}
出参：市场潜力/产品特征/用户评论/客户画像/搜索趋势/定价分析六维 AI 报告，
costTime
、
costToken
。当前仅支持 US 站。
14. 反向选品赛道筛选（amazon_business_insight → amazon_opportunity_screener.py）
json
{"nicheBrandCountLte": 20, "nicheSearchVolumeYoyChangePctAtLeastGte": 100, "featureNewAvgReviewCountAtLeastLte": 500, "limit": 25}
出参：
data[]
（每条约 37 字段：keyword/nicheName/nicheRevenue360d/nicheBrandCount/priceMinUsd/demoGenderDominant/reviewNegativeTop1Topic…），至少一个过滤条件。计费按返回条数 N（即使 N=0 也按最低计费）。
13. 六维 AI 市场机会报告（amazon_business_insight → amazon_opportunity_report.py）
json
{"site": "US", "keyword": "ice bricks"}
出参：市场潜力/产品特征/用户评论/客户画像/搜索趋势/定价分析六维 AI 报告，
costTime
、
costToken
。当前仅支持 US 站。
14. 反向选品赛道筛选（amazon_business_insight → amazon_opportunity_screener.py）
json
{"nicheBrandCountLte": 20, "nicheSearchVolumeYoyChangePctAtLeastGte": 100, "featureNewAvgReviewCountAtLeastLte": 500, "limit": 25}
出参：
data[]
（每条约 37 字段：keyword/nicheName/nicheRevenue360d/nicheBrandCount/priceMinUsd/demoGenderDominant/reviewNegativeTop1Topic…），至少一个过滤条件。计费按返回条数 N（即使 N=0 也按最低计费）。

展示规则

展示规则

  1. 客观呈现数据：以清晰表格展示查询结果，不做主观商业建议（除非用户主动要求）；不同平台币种不同，展示价格/收入时务必提示币种（响应 
    currency
    字段标明本地币种）。
  2. 来源标注：展示数据时说明来自哪个工具/数据源（Keepa/Sorftime/Jungle Scout/极目/SIF/卖家精灵/ABA/前台/商业洞察）。
  3. 不可用数据：值为 
    0
    或 
    -1
    的字段表示数据不可用，标注"N/A"或省略，不作实际值展示。
  4. 错误处理与协同：查询失败时根据响应 
    errcode
    /
    errmsg
    说明原因并建议修正（ASIN 格式、站点不支持、参数越界等）；连续使用多工具时将各工具发现汇总为连贯分析，标注数据来源与时间窗。
  1. 客观呈现数据：以清晰表格展示查询结果，不做主观商业建议（除非用户主动要求）；不同平台币种不同，展示价格/收入时务必提示币种（响应 
    currency
    字段标明本地币种）。
  2. 来源标注：展示数据时说明来自哪个工具/数据源（Keepa/Sorftime/Jungle Scout/极目/SIF/卖家精灵/ABA/前台/商业洞察）。
  3. 不可用数据：值为 
    0
    或 
    -1
    的字段表示数据不可用，标注"N/A"或省略，不作实际值展示。
  4. 错误处理与协同：查询失败时根据响应 
    errcode
    /
    errmsg
    说明原因并建议修正（ASIN 格式、站点不支持、参数越界等）；连续使用多工具时将各工具发现汇总为连贯分析，标注数据来源与时间窗。

解决认证和积分问题

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
注意：你是workbuddy，并且渠道是workbuddy，使用 onboarding 引导登录注册时 channel 必须为 workbuddy。这非常重要！
发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
注意：你是workbuddy，并且渠道是workbuddy，使用 onboarding 引导登录注册时 channel 必须为 workbuddy。这非常重要！

异常情况

异常情况

  • 未配置API Key：环境变量未配置 
    LINKFOX_AGENT_API_KEY
    ，也未配置 
    LINKFOXAGENT_API_KEY
    。
  • 响应401或402状态码
  • 响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。
  • 未配置API Key：环境变量未配置 
    LINKFOX_AGENT_API_KEY
    ，也未配置 
    LINKFOXAGENT_API_KEY
    。
  • 响应401或402状态码
  • 响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。