{"id":"2ddf196e-72f1-41fe-8ef2-938a83d5364f","entityType":"agent","slug":"clawhub-linkfox-ai-linkfox-amazon-product-selection","name":"Linkfox 亚马逊选品","canonicalUrl":"https://www.xpersona.co/agent/clawhub-linkfox-ai-linkfox-amazon-product-selection","canonicalPath":"/agent/clawhub-linkfox-ai-linkfox-amazon-product-selection","generatedAt":"2026-10-12T12:05:15.956Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T22:53:05.635Z","emptyReason":null},"description":"亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。 Skill: Linkfox 亚马逊选品 Owner: linkfox-ai Summary: 亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。 Tags: latest:1.2.3 Version history: v1.2.3 | 2026-08-14T14:43:39.724Z | user Update from 1.2.2 to 1.2.3 v1.2.2 | 2026-08-07T10:40:30.197Z | user Update from 1.2.1 to 1.2.2 v1.2.1 | 2026-08-05T08:58:14.340Z | user Update from 1.2.0 to 1.2.1 v1.2.0 | 2026-07-1","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 981 downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-amazon-product-selection","sourceUrl":"https://clawhub.ai/linkfox-ai/linkfox-amazon-product-selection","homepage":"https://clawhub.ai/linkfox-ai/skills/linkfox-amazon-product-selection","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/linkfox-ai/linkfox-amazon-product-selection","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/linkfox-ai/skills/linkfox-amazon-product-selection","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":60,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。 Skill: Linkfox 亚马逊选品 Owner: linkfox-ai Summary"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T22:53:05.635Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T22:53:05.635Z","emptyReason":null},"stars":null,"forks":null,"downloads":981,"likes":null,"task":null,"library":null,"packageName":null,"latestVersion":"1.2.3","tractionLabel":"981 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T22:53:05.517Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T22:53:05.635Z","lastCrawledAt":"2026-10-11T22:53:05.517Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T22:53:05.517Z","lastVerifiedAt":null,"highlights":[{"version":"1.2.3","createdAt":"2026-08-14T14:43:39.724Z","changelog":"Update from 1.2.2 to 1.2.3","fileCount":72,"zipByteSize":392807},{"version":"1.2.2","createdAt":"2026-08-07T10:40:30.197Z","changelog":"Update from 1.2.1 to 1.2.2","fileCount":72,"zipByteSize":392508},{"version":"1.2.1","createdAt":"2026-08-05T08:58:14.340Z","changelog":"Update from 1.2.0 to 1.2.1","fileCount":72,"zipByteSize":392800},{"version":"1.2.0","createdAt":"2026-07-16T03:58:38.238Z","changelog":"Update from 1.0.1 to 1.2.0","fileCount":70,"zipByteSize":383086},{"version":"1.0.1","createdAt":"2026-07-16T03:28:33.581Z","changelog":"Update from 1.0.0 to 1.0.1","fileCount":70,"zipByteSize":383783},{"version":"1.0.0","createdAt":"2026-07-15T01:35:02.375Z","changelog":"Initial release","fileCount":70,"zipByteSize":383216}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-amazon-product-selection","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-12T12:05:15.951Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-amazon-product-selection/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T22:53:05.635Z","emptyReason":null},"readme":"Skill: Linkfox 亚马逊选品\n\nOwner: linkfox-ai\n\nSummary: 亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。\n\nTags: latest:1.2.3\n\nVersion history:\n\nv1.2.3 | 2026-08-14T14:43:39.724Z | user\n\nUpdate from 1.2.2 to 1.2.3\n\nv1.2.2 | 2026-08-07T10:40:30.197Z | user\n\nUpdate from 1.2.1 to 1.2.2\n\nv1.2.1 | 2026-08-05T08:58:14.340Z | user\n\nUpdate from 1.2.0 to 1.2.1\n\nv1.2.0 | 2026-07-16T03:58:38.238Z | user\n\nUpdate from 1.0.1 to 1.2.0\n\nv1.0.1 | 2026-07-16T03:28:33.581Z | user\n\nUpdate from 1.0.0 to 1.0.1\n\nv1.0.0 | 2026-07-15T01:35:02.375Z | user\n\nInitial release\n\nArchive index:\n\nArchive v1.2.3: 72 files, 392807 bytes\n\nFiles: references/linkfox-aba-intelligent-query.md (12111b), references/linkfox-amazon-alexa-search.md (13115b), references/linkfox-amazon-opportunity-report-by-keyword.md (8429b), references/linkfox-amazon-opportunity-search-by-metrics.md (21329b), references/linkfox-amazon-product-detail.md (15679b), references/linkfox-amazon-reviews-list.md (11589b), references/linkfox-amazon-search-by-image.md (15714b), references/linkfox-amazon-search.md (14314b), references/linkfox-jiimore-get-niche-info-by-keyword.md (18462b), references/linkfox-jiimore-get-niche-info.md (20485b), references/linkfox-jiimore-get-niche-review-from-keyword.md (16190b), references/linkfox-jiimore-page-asins-by-asin.md (16981b), references/linkfox-jiimore-product-discovery.md (14022b), references/linkfox-junglescout-keyword-by-asin.md (16210b), references/linkfox-junglescout-keyword-by-keyword.md (14274b), references/linkfox-junglescout-keyword-history.md (10589b), references/linkfox-junglescout-keyword-share-of-voice.md (13612b), references/linkfox-junglescout-product-database.md (16844b), references/linkfox-junglescout-sales-estimates.md (11831b), references/linkfox-keepa-product-request.md (14068b), references/linkfox-keepa-product-search.md (18601b), references/linkfox-keepa-product-series.md (12490b), references/linkfox-sellersprite-competitor-lookup.md (16713b), references/linkfox-sellersprite-market-research.md (16064b), references/linkfox-sellersprite-market-statistics.md (10076b), references/linkfox-sellersprite-product-search.md (23376b), references/linkfox-sellersprite-traffic-keyword.md (12288b), references/linkfox-sif-asin-keywords.md (17315b), references/linkfox-sif-asin-summary.md (18718b), references/linkfox-sif-keyword-overview.md (13932b), references/linkfox-sif-keyword-summary.md (19104b), references/linkfox-sorftime-amazon-product-detail.md (16840b), references/linkfox-sorftime-amazon-product-query.md (17923b), references/onboarding.md (2068b), scripts/aba_query.py (12662b), scripts/amazon_alexa_search.py (12686b), scripts/amazon_opportunity_report.py (12771b), scripts/amazon_opportunity_screener.py (12783b), scripts/amazon_product_detail.py (12699b), scripts/amazon_reviews.py (12664b), scripts/amazon_search_by_image.py (12699b), scripts/amazon_search.py (12636b), scripts/jiimore_get_niche_info_by_keyword.py (13133b), scripts/jiimore_get_niche_info.py (13056b), scripts/jiimore_get_niche_review.py (13126b), scripts/jiimore_page_asins_by_asin.py (13101b), scripts/jiimore_product_discovery.py (13091b), scripts/junglescout_keyword_by_asin.py (13140b), scripts/junglescout_keyword_by_keyword.py (13191b), scripts/junglescout_keyword_history.py (13171b), scripts/junglescout_keyword_sov.py (13165b), scripts/junglescout_product_database.py (13151b), scripts/junglescout_sales_estimates.py (13140b), scripts/keepa_product_detail.py (13061b), scripts/keepa_product_history.py (13061b), scripts/keepa_product_search.py (12682b), scripts/onboarding.py (24089b), scripts/sellersprite_competitor_lookup.py (13133b), scripts/sellersprite_market_research.py (13117b), scripts/sellersprite_market_statistics.py (13133b), scripts/sellersprite_product_search.py (12750b), scripts/sellersprite_traffic_keyword.py (13117b), scripts/sif_asin_keywords.py (13035b), scripts/sif_asin_summary.py (13019b), scripts/sif_keyword_overview.py (13051b), scripts/sif_keyword_traffic.py (13058b), scripts/sorftime_product_detail.py (13103b), scripts/sorftime_product_search.py (13099b), scripts/upload_image.py (4670b), skill-card.md (5574b), SKILL.md (23723b), _meta.json (151b)\n\nFile v1.2.3:SKILL.md\n\n---\nname: linkfox-amazon-product-selection\ndisplay_name: Linkfox 亚马逊选品\ndisplay_name_en: LinkFox Amazon Product Selection\ndescription: 亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。\ndescription_zh: 亚马逊选品一站式 AI 工具集，整合 竞品查询、ABA 搜索词分析、亚马逊前台搜索/以图搜图/商品详情/评论/Alexa 导购、商业洞察六维报告、Keepa/Sorftime 历史时序、Jungle Scout/卖家精灵/SIF/极目关键词与利基市场等 12 类底层工具、33 项子能力。覆盖美国、英国、德国、日本等 15+ 站点，支持关键词挖掘、流量反查、竞品深挖、销量与价格趋势、利基竞争格局、评论痛点、AI 市场机会报告与反向赛道筛选。当用户需要亚马逊选品、市场调研、竞品分析、关键词分析、评论挖掘、历史趋势追踪或反向找赛道时触发。各子能力完整参数见 references/ 对应文件，脚本见 scripts/。\ndescription_en: One-stop Amazon product-selection AI toolkit integrating 33 sub-capabilities across 12 tool families — competitor lookup, ABA search-term analysis, Amazon frontend search/image-search/product-detail/reviews/Alexa, business-insight six-dimension reports and reverse selection, Keepa/Sorftime historical time series, and Jungle Scout/SellerSprite/SIF/Jiimore keyword and niche analysis. Covers 15+ marketplaces (US/UK/DE/JP…) for keyword mining, traffic reverse lookup, competitor deep-dive, sales/price trends, niche competition, review pain points, AI opportunity reports and reverse niche screening. Triggered when the user needs Amazon product selection, market research, competitor analysis, keyword analysis, review mining, historical trend tracking or reverse niche discovery. Full params per sub-capability are in references/, executable scripts in scripts/.\ncategory: e-commerce\nversion: 1.0.0\nauthor: LinkFox\n---\n\n# Linkfox 亚马逊选品（Amazon Product Selection）\n\n亚马逊选品一站式 AI 工具集，整合 **12 类底层工具、33 项子能力**，覆盖前台实时、历史时序、关键词与流量、利基市场、商业洞察与评论挖掘。各子能力完整参数、响应字段与错误码见 `references/` 下对应文件，可执行脚本见 `scripts/`。\n\n## 能力边界\n\n### ✅ 能力范围\n- **前台实时数据**：关键词搜索排名与 SERP、以图搜图（`amazon_search`）、商品详情/五点/A+/变体（`amazon_product_detail`）、按星级筛选评论（`amazon_reviews`）、Alexa 自然语言导购（`amazon_alexa_assistant`）。\n- **竞品搜索**：卖家精灵竞品查询（按关键词/ASIN/卖家/品牌/类目反查竞品，含销量、BSR、定价、评分与增长趋势，`sellersprite` 竞品查询）、极目按 ASIN 挖同细分市场竞品并按转化率/销量/价格/利润多维筛选（`jiimore` page-asins-by-asin）。\n- **历史时序与趋势**：Keepa 商品详情/搜索/历史曲线（`keepa`，价格/BSR/月销/卖家数）、Sorftime 详情/搜索与趋势回看（`sorftime`，含 FBA 利润、Deal 历史、历史快照）。\n- **关键词与流量分析**：ABA 搜索词挖掘（`amazon_aba_search_term`）、Jungle Scout 反查/拓展/历史/声量份额（`jungle_scout`）、SIF ASIN 关键词反查/ASIN 流量结构/关键词竞争概览/关键词下竞品流量来源拆解（`sif_search_intelligence`）、卖家精灵流量词反查（`sellersprite` 流量关键词）。\n- **利基与市场分析**：极目细分市场指标/评论/竞品/潜力爆品（`jiimore`）、卖家精灵商品搜索选品、选市场列表与统计看板（`sellersprite`）、Jungle Scout 商品库与销量预估（`jungle_scout`）。\n- **商业洞察与反向选品**：按关键词生成市场潜力/产品特征/评论/客户画像/搜索趋势/定价六维 AI 报告，按 30+ 商业维度反向筛选蓝海赛道（`amazon_business_insight`）。\n- 覆盖美国、英国、德国、法国、日本、加拿大、意大利、西班牙、印度、墨西哥、巴西等 15+ 站点（站点集合随工具略有差异，详见各 references）。\n\n### ❌ 边界与限制\n- **API Key 必需**：所有工具均需环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）；各工具独立计费、独立限频，数据时效与站点覆盖随数据源而异。\n- **计费约束**：同一会话同一参数组合默认只调用一次（脚本带 24h 本地缓存）；失败或空结果不得自动换关键词、翻页或改邮编连续试探；需继续检索时先向用户说明会产生额外消耗（各工具计费规则见 `skills-version.json` 对应条目与 references 内 api.md 的 `costToken` 字段）。\n- **不在范围内**：店铺运营（Listing 刊登/订单/库存，用 SP-API 系列）、广告投放与管理（用 Amazon Ads 系列）、物流与供应链规划、1688 找货源、TikTok/沃尔玛等其他平台选品、非电商任务、与平台或卖家的直接沟通、实时库存与订单处理。\n- **数据时效**：前台类工具为实时抓取（含 SERP 排名、评论、Alexa）；历史类（Keepa/Sorftime/ABA）为各自数据源的更新周期，`lastUpdate`/`costToken` 等字段标识刷新与消耗。\n\n## 工具选择指南\n\n按需求在下表定到子能力，再跳到【业务需求路由速查】查端点/脚本/references 取参执行。\n\n| 需求 / 用户说 | 默认推荐（子能力） | 何时换用其他 |\n|---|---|---|\n| ASIN 商品数据 / 价格销量趋势（\"这个 ASIN 卖得怎么样\"） | `linkfox-keepa-product-request`（字段最全） | 要 FBA 利润+趋势回看用 `linkfox-sorftime-amazon-product-detail`；要 A+/变体/实时价用 `linkfox-amazon-product-detail` |\n| ASIN 流量词反查（\"ASIN 的流量词有哪些\"） | `linkfox-sif-asin-keywords`（流量词+排名+搜索量） | 要 PPC 竞价+排名难度用 `linkfox-junglescout-keyword-by-asin`；要转化类型+历史月份用 `linkfox-sellersprite-traffic-keyword` |\n| 关键词拓展 / 相关流量词（\"这个词有哪些相关词/长尾词\"） | `linkfox-junglescout-keyword-by-keyword`（种子词拓展，含搜索量/趋势/PPC 竞价） | 要按 ASIN 反查其流量词用 `linkfox-sif-asin-keywords`；要官方搜索词排名（非拓展）用 `linkfox-aba-intelligent-query` |\n| 关键词搜索量趋势（\"这个词的搜索量/排名\"） | `linkfox-junglescout-keyword-history`（精确搜索量） | 要官方搜索排名（非搜索量）用 `linkfox-aba-intelligent-query` |\n| 商品搜索 / 选品筛选（\"帮我选品 / 什么好卖\"） | `linkfox-keepa-product-search`（多维+历史） | 要历史快照回看用 `linkfox-sorftime-amazon-product-query`；要毛利筛选用 `linkfox-sellersprite-product-search`；要实时 SERP 用 `linkfox-amazon-search` |\n| 关键词竞争度（\"这个词竞争大不大\"） | `linkfox-sif-keyword-overview`（供需比+搜索量） | 要品牌声量份额用 `linkfox-junglescout-keyword-share-of-voice` |\n| 利基 / 细分市场评估（\"细分市场能不能进\"） | `linkfox-jiimore-get-niche-info-by-keyword`（垄断/品牌/新品成功率） | 要类目维度看板用 `linkfox-sellersprite-market-research` / `-market-statistics`；要多条件筛选商品库用 `linkfox-junglescout-product-database` |\n| ASIN 销量预估 | `linkfox-junglescout-sales-estimates`（日维度） | 要 12 月月销趋势用 `linkfox-keepa-product-request` |\n| 利基评论 / 痛点（\"评论痛点 / 差评\"） | `linkfox-jiimore-get-niche-review-from-keyword`（细分市场级） | 要单 ASIN 评论用 `linkfox-amazon-reviews-list` |\n| ASIN 流量结构 / 竞品分析 | `linkfox-sif-asin-summary`（ASIN 流量构成） | 要关键词下竞品流量拆解用 `linkfox-sif-keyword-summary` |\n| 竞品反查（关键词/ASIN/卖家/品牌） | `linkfox-sellersprite-competitor-lookup` | 要按 ASIN 挖同细分竞品用 `linkfox-jiimore-page-asins-by-asin` |\n| 六维 AI 市场报告（\"AI 市场报告\"） | `linkfox-amazon-opportunity-report-by-keyword` | — |\n| 反向按指标找赛道（\"按条件反找赛道\"） | `linkfox-amazon-opportunity-search-by-metrics` | — |\n| 前台实时搜索 / 以图搜图（\"前台搜一下这个词\"） | `linkfox-amazon-search` / `linkfox-amazon-search-by-image` | — |\n| 自然语言导购（\"用自然语言问亚马逊推荐\"） | `linkfox-amazon-alexa-search` | — |\n\n### 工具选择思路\n- **重要**：多个子能力满足需求时，要依据需求深入分析子能力的功能、用途、出入参、从中调研出最合适的子能力，并推荐用户，让用户自己决定。\n- 满足程度同等的前提下，向用户推荐“默认推荐子能力”。\n\n## 业务需求路由速查\n\n按【工具选择指南】定到子能力 后，下表查端点、脚本与 references 文件取参执行：\n\n### 子能力 ↔ references 文件 ↔ 端点 ↔ 脚本（33 项）\n\n**amazon_aba_search_term**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-aba-intelligent-query | references/linkfox-aba-intelligent-query.md | POST /aba/intelligentQuery | aba_query.py |\n\n**amazon_alexa_assistant**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-alexa-search | references/linkfox-amazon-alexa-search.md | POST /amazon/alexaSearch | amazon_alexa_search.py |\n\n**amazon_business_insight**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-opportunity-report-by-keyword | references/linkfox-amazon-opportunity-report-by-keyword.md | POST /amazon/opportunity/reportByKeyword | amazon_opportunity_report.py |\n| linkfox-amazon-opportunity-search-by-metrics | references/linkfox-amazon-opportunity-search-by-metrics.md | POST /amazon/opportunity/searchByMetrics | amazon_opportunity_screener.py |\n\n**amazon_search**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-search | references/linkfox-amazon-search.md | POST /amazon/search | amazon_search.py |\n| linkfox-amazon-search-by-image | references/linkfox-amazon-search-by-image.md | POST /amazon/searchByImage | amazon_search_by_image.py、upload_image.py |\n\n**amazon_product_detail**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-product-detail | references/linkfox-amazon-product-detail.md | POST /amazon/product/detail | amazon_product_detail.py |\n\n**amazon_reviews**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-reviews-list | references/linkfox-amazon-reviews-list.md | POST /amazon/reviews/list | amazon_reviews.py |\n\n**jiimore**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| 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 |\n| linkfox-jiimore-get-niche-info | references/linkfox-jiimore-get-niche-info.md | POST /jiimore/getNicheInfo | jiimore_get_niche_info.py |\n| linkfox-jiimore-get-niche-review-from-keyword | references/linkfox-jiimore-get-niche-review-from-keyword.md | POST /jiimore/getNicheReviewFromKeyword | jiimore_get_niche_review.py |\n| linkfox-jiimore-product-discovery | references/linkfox-jiimore-product-discovery.md | POST /jiimore/productDiscovery | jiimore_product_discovery.py |\n| linkfox-jiimore-page-asins-by-asin | references/linkfox-jiimore-page-asins-by-asin.md | POST /jiimore/pageAsinsByAsin | jiimore_page_asins_by_asin.py |\n\n**jungle_scout**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-junglescout-keyword-by-asin | references/linkfox-junglescout-keyword-by-asin.md | POST /tool-jungle-scout/keywords/by-asin | junglescout_keyword_by_asin.py |\n| linkfox-junglescout-keyword-by-keyword | references/linkfox-junglescout-keyword-by-keyword.md | POST /tool-jungle-scout/keywords/by-keyword | junglescout_keyword_by_keyword.py |\n| linkfox-junglescout-keyword-history | references/linkfox-junglescout-keyword-history.md | POST /tool-jungle-scout/keywords/historical-search-volume | junglescout_keyword_history.py |\n| 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 |\n| linkfox-junglescout-product-database | references/linkfox-junglescout-product-database.md | POST /tool-jungle-scout/product-database/query | junglescout_product_database.py |\n| linkfox-junglescout-sales-estimates | references/linkfox-junglescout-sales-estimates.md | POST /tool-jungle-scout/sales-estimates/query | junglescout_sales_estimates.py |\n\n**keepa**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-keepa-product-request | references/linkfox-keepa-product-request.md | POST /keepa/productRequest | keepa_product_detail.py |\n| linkfox-keepa-product-search | references/linkfox-keepa-product-search.md | POST /keepa/productSearch | keepa_product_search.py |\n| linkfox-keepa-product-series | references/linkfox-keepa-product-series.md | POST /keepa/productSeries | keepa_product_history.py |\n\n**sellersprite**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-sellersprite-competitor-lookup | references/linkfox-sellersprite-competitor-lookup.md | POST /sellersprite/competitor-lookup | sellersprite_competitor_lookup.py |\n| linkfox-sellersprite-product-search | references/linkfox-sellersprite-product-search.md | POST /sellersprite/productSearch | sellersprite_product_search.py |\n| linkfox-sellersprite-market-research | references/linkfox-sellersprite-market-research.md | POST /sellersprite/market/research | sellersprite_market_research.py |\n| linkfox-sellersprite-market-statistics | references/linkfox-sellersprite-market-statistics.md | POST /sellersprite/market/statistics | sellersprite_market_statistics.py |\n| linkfox-sellersprite-traffic-keyword | references/linkfox-sellersprite-traffic-keyword.md | POST /sellersprite/traffic/keyword | sellersprite_traffic_keyword.py |\n\n**sif_search_intelligence**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-sif-asin-keywords | references/linkfox-sif-asin-keywords.md | POST /sif/asinKeywords | sif_asin_keywords.py |\n| linkfox-sif-asin-summary | references/linkfox-sif-asin-summary.md | POST /sif/asinSummary | sif_asin_summary.py |\n| linkfox-sif-keyword-overview | references/linkfox-sif-keyword-overview.md | POST /sif/keywordOverview | sif_keyword_overview.py |\n| linkfox-sif-keyword-summary | references/linkfox-sif-keyword-summary.md | POST /sif/keywordSummary | sif_keyword_traffic.py |\n\n**sorftime**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-sorftime-amazon-product-detail | references/linkfox-sorftime-amazon-product-detail.md | POST /sorftime/amazon/productDetail | sorftime_product_detail.py |\n| linkfox-sorftime-amazon-product-query | references/linkfox-sorftime-amazon-product-query.md | POST /sorftime/amazon/productQuery | sorftime_product_search.py |\n\n## 调用方式\n\n- **网关**：`${LINKFOX_TOOL_GATEWAY}/<端点>`，请求方式 POST、Content-Type `application/json`，认证 Header `Authorization: `（api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取；未配置按下方【解决认证和积分问题】处理）。各端点路径见下方【业务需求路由速查】与对应 references 文件。\n- **Python 脚本**：每项子能力对应 `scripts/<脚本名>.py '' [--inline]`（脚本名与端点见路由速查表）。脚本内部完成网关调用、鉴权与落盘。\n- **输出策略（脚本默认行为）**：始终将完整响应写入 `/linkfox///data/-.json`（`` 为脚本执行时工作目录；`` 取自环境变量 `SESSION_ID`；禁止写入 /tmp，当前目录不可写则报错）；响应体 ≤ 8 KB 落盘后完整打印到 stdout，> 8 KB 仅打印摘要（顶层字段、常见计数、最大列表长度 + 前 3 条样本）；加 `--inline` 强制全量打印（同样落盘）。\n- **读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 PowerShell `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n- **完整参数**：每个子能力的请求参数、响应字段、错误码、curl 示例见 `references/<源skill>.md`（文件内含该子能力 SKILL.md 正文与 api.md 全文）。\n\n## 使用示例\n\n以下按数据层给出代表性子能力的出入参示例；其余子能力参数见对应 references 文件。`domain` 为 Keepa 站点数字 ID（`1`=美/`2`=英/`3`=德/`5`=日…），`marketplace`/`amazonDomain`/`country`/`countryCode`/`region` 为各工具的站点代码，含义见 references。\n\n### 前台实时层\n\n**1. 关键词搜索排名（amazon_search → amazon_search.py）**\n```json\n{\"keyword\": \"wireless earbuds\", \"amazonDomain\": \"amazon.com\", \"page\": 1}\n```\n出参：`products[]`（asin/title/brand/price/rating/ratings/position/sponsored/imageUrl/asinUrl/delivery）、`total`、`costToken`。\n\n**2. 以图搜图（amazon_search_by_image → amazon_search_by_image.py，需先 upload_image.py 上传）**\n```json\n{\"imageUrl\": \"https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg\", \"amazonDomain\": \"amazon.com\", \"sort\": \"default\"}\n```\n出参：`products[]`（asin/title/price/oldPrice/rating/ratings/brand）；设 `aggregateByKeepaData:true` 可聚合 salesRank/monthlySalesUnits/fbaFees/profit。\n\n**3. 商品详情（amazon_product_detail → amazon_product_detail.py）**\n```json\n{\"asins\": \"B072MQ5BRX,B08N5WRWNW\", \"amazonDomain\": \"amazon.com\"}\n```\n出参：`products[]`（asin/title/brand/price/oldPrice/rating/ratings/aboutItem/variants/customerReviews/productImageUrls）、`total`、`costToken`。\n\n**4. 商品评论（amazon_reviews → amazon_reviews.py）**\n```json\n{\"asin\": \"B08N5WRWNW\", \"domainCode\": \"com\", \"star1Num\": 10, \"star2Num\": 10, \"star3Num\": 10, \"star4Num\": 10, \"star5Num\": 10, \"sortBy\": \"recent\"}\n```\n出参：`data[]`（reviewId/title/text/rating/date/userName/verified/vine/numberOfHelpful/imageUrlList/videoUrlList）、`total`、`costToken`。\n\n**5. Alexa 导购问答（amazon_alexa_assistant → amazon_alexa_search.py）**\n```json\n{\"prompts\": [\"best wireless earbuds for running\"], \"format\": \"json\"}\n```\n出参：`data`（导购回答/推荐商品分组/ASIN 列表/可追问问题）、`resultsNum`、`costToken`。仅支持单条 prompt，追问需 agent 拼接上下文后发起新请求。\n\n### 历史时序层\n\n**6. Keepa 商品详情（keepa → keepa_product_detail.py）**\n```json\n{\"asin\": \"B0088PUEPK\", \"domain\": \"1\", \"history\": 1}\n```\n出参：`products[]`（asin/title/price/salesRank/salesRank30/90/180/monthlySalesUnits(含近12月)/monthlySalesRevenue/fbaFees/profit/rating/reviewCount/categoryTree/lastUpdate）、`costToken`。批量最多 5 个 ASIN。\n\n**7. Sorftime 商品详情与趋势（sorftime → sorftime_product_detail.py）**\n```json\n{\"asin\": \"B00FLYWNYQ\", \"marketplace\": \"us\"}\n```\n出参：`products[]`（asin/title/price/profitRate/profitAmount/salesRank/monthlySalesUnits/rating/fbaFees/bsrRankTrend/priceTrend/rankTrend/dealTrend）、`costToken`。\n\n### 关键词与流量层\n\n**8. ABA 搜索词分析（amazon_aba_search_term → aba_query.py）**\n```json\n{\"analysisDescription\": \"筛选美国站关键词gift在过去12周的搜索热度排名\", \"region\": \"US\"}\n```\n出参：`tables`（搜索词/周开始日期/站点/搜索排名/点击ASIN/商品名/点击占比/转化占比）、`total`、`downloadUrl`（`createDownloadUrl:true` 时生成 CSV）、`costToken`。\n\n**9. Jungle Scout 关键词拓展（jungle_scout → junglescout_keyword_by_keyword.py）**\n```json\n{\"marketplace\": \"us\", \"searchTerms\": \"yoga mat\", \"needCount\": 20}\n```\n出参：`keywordInfoList[]`（name/monthlySearchVolumeExact/monthlySearchVolumeBroad/monthlyTrend/dominantCategory/organicProductCount/ppcBidExact/ppcBidBroad/easeOfRankingScore）、`costToken`。\n\n**10. SIF 关键词竞争概览（sif_search_intelligence → sif_keyword_overview.py）**\n```json\n{\"keyword\": \"wireless charger\", \"country\": \"US\"}\n```\n出参：`keyword`/keywordPopularityRank/estimatedWeeklySearchVolume/supplyDemandRatio/totalSearchResultProductCount/sponsoredProductsCount/paidAdvertisingProductCount/trackedAsinTotalCount。\n\n### 利基与市场层\n\n**11. 极目利基市场分析（jiimore → jiimore_get_niche_info_by_keyword.py）**\n```json\n{\"keyword\": \"wireless earbuds\", \"countryCode\": \"US\", \"sortField\": \"demand\", \"sortType\": \"desc\", \"pageSize\": 20}\n```\n出参：`data`（nicheId/nicheTitle/translationZh/demand/productCount/avgPrice/searchVolumeWeekly/unitsSoldWeekly/brandCount/top5BrandsClickShare/launchRateSemiannual/cpc）、`costToken`。\n\n**12. 卖家精灵商品搜索选品（sellersprite → sellersprite_product_search.py）**\n```json\n{\"keyword\": \"yoga mat\", \"marketplace\": \"US\", \"minUnits\": 300, \"minPrice\": 10, \"maxPrice\": 50, \"order\": {\"field\": \"total_units\", \"desc\": \"true\"}, \"page\": 1, \"size\": 20}\n```\n出参：`products[]`（asin/title/price/月销量/月销售额/BSR/评分/毛利率/配送方式）、`total`、`costToken`。\n\n### 商业洞察层\n\n**13. 六维 AI 市场机会报告（amazon_business_insight → amazon_opportunity_report.py）**\n```json\n{\"site\": \"US\", \"keyword\": \"ice bricks\"}\n```\n出参：市场潜力/产品特征/用户评论/客户画像/搜索趋势/定价分析六维 AI 报告，`costTime`、`costToken`。当前仅支持 US 站。\n\n**14. 反向选品赛道筛选（amazon_business_insight → amazon_opportunity_screener.py）**\n```json\n{\"nicheBrandCountLte\": 20, \"nicheSearchVolumeYoyChangePctAtLeastGte\": 100, \"featureNewAvgReviewCountAtLeastLte\": 500, \"limit\": 25}\n```\n出参：`data[]`（每条约 37 字段：keyword/nicheName/nicheRevenue360d/nicheBrandCount/priceMinUsd/demoGenderDominant/reviewNegativeTop1Topic…），至少一个过滤条件。计费按返回条数 N（即使 N=0 也按最低计费）。\n\n## 展示规则\n\n1. **客观呈现数据**：以清晰表格展示查询结果，不做主观商业建议（除非用户主动要求）；不同平台币种不同，展示价格/收入时务必提示币种（响应 `currency` 字段标明本地币种）。\n2. **来源标注**：展示数据时说明来自哪个工具/数据源（Keepa/Sorftime/Jungle Scout/极目/SIF/卖家精灵/ABA/前台/商业洞察）。\n3. **不可用数据**：值为 `0` 或 `-1` 的字段表示数据不可用，标注\"N/A\"或省略，不作实际值展示。\n4. **错误处理与协同**：查询失败时根据响应 `errcode`/`errmsg` 说明原因并建议修正（ASIN 格式、站点不支持、参数越界等）；连续使用多工具时将各工具发现汇总为连贯分析，标注数据来源与时间窗。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n**注意**：你是workbuddy，并且渠道是workbuddy，使用 onboarding 引导登录注册时 channel **必须**为 workbuddy。这非常重要！\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\nFile v1.2.3:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-amazon-product-selection\",\n \"version\": \"1.2.3\",\n \"publishedAt\": 1786718619724\n}\n\nFile v1.2.3:references/linkfox-aba-intelligent-query.md\n\n---\nname: linkfox-aba-intelligent-query\ndescription: 提供亚马逊ABA（品牌分析）搜索词数据的查询与分析，涵盖15个站点近3年的周维度数据，用于关键词挖掘与市场趋势分析。\n---\n\n# 亚马逊 ABA 数据挖掘（ABA Intelligent Query）\n\n本技能用于查询和分析亚马逊 ABA（Amazon Brand Analytics）搜索词数据，帮助卖家从搜索词报告中挖掘关键词机会、排名趋势与市场洞察。完整请求参数、响应字段与错误码见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 查询亚马逊 ABA 搜索词数据，覆盖 15 个站点、近 3 年的**周维度**历史数据。\n- 通过自然语言 `analysisDescription` 精确描述查询意图，后端转化为结构化查询。\n- 支持关键词热度排名趋势、黑马词发现、蓝海词挖掘、季节性关键词、高点击低转化 ASIN 诊断、竞品流量分布等场景。\n- 可按需生成 CSV 下载链接（最多 10,000 条）。\n\n### ❌ 边界与限制\n\n- **数据粒度**：仅周维度，无日维度数据；历史范围约 3 年。\n- **结果上限**：下载链接单次最多 10,000 条记录。\n- **站点范围**：仅支持 15 个亚马逊站点（US、DE、BR、CA、AU、JP、AE、ES、FR、IT、SA、TR、MX、SE、NL），不含其他电商平台。\n- **默认站点**：用户未指定站点时默认 US。\n- **不在范围内**：广告/PPC 出价与投放策略；商品评论、Listing 文案撰写；ASIN 销量估算；用户已有本地 ABA 文件处理；利润测算、定价策略与综合市场报告。\n- **成本约束**：本工具消耗积分，同一会话同一参数组合默认只调用一次；失败/空结果不得自动换关键词、翻页或改邮编连续试探。\n\n## 核心概念\n\nABA（Amazon Brand Analytics）搜索词报告是亚马逊官方搜索行为数据，反映消费者真实搜索活动。本工具持有近 3 年的**周维度**数据，覆盖 15 个亚马逊站点。\n\n**排名逻辑**：`searchFrequencyRank` 数值越小代表搜索热度越高，排名 1 为最热门搜索词。此处易混淆——用户说\"排名提升\"指数值变小；\"排名下降\"指数值变大。\n\n### 数据字段\n\n| 字段 | API 名称 | 说明 | 示例 |\n|------|----------|------|------|\n| 搜索词 | searchTerm | 消费者搜索关键词 | rimel loreal |\n| 报告起始日期 | reportStartDate | 数据采集周起始日 | 2025-10-26 |\n| 站点 | region | 亚马逊站点代码 | US |\n| 搜索频率排名 | searchFrequencyRank | 搜索热度排名（越小越优） | 82135 |\n| 被点击 ASIN | clickedAsin | 被点击商品的 ASIN | B0XXXXXXXX |\n| 被点击商品名 | clickedItemName | 被点击商品名称 | xxx |\n| 点击占比排名 | clickShareRank | 该 ASIN 在该搜索词下的点击占比排名 | 1 |\n| 点击占比 | clickShare | 该 ASIN 占据的点击份额（0~1） | 0.28 |\n| 转化占比 | conversionShare | 该 ASIN 占据的转化份额（0~1） | 0.3333 |\n\n### 支持站点\n\nUS（美国）、DE（德国）、BR（巴西）、CA（加拿大）、AU（澳大利亚）、JP（日本）、AE（阿联酋）、ES（西班牙）、FR（法国）、IT（意大利）、SA（沙特）、TR（土耳其）、MX（墨西哥）、SE（瑞典）、NL（荷兰）。\n\n用户未指定站点时默认 **US**。\n\n## 调用方式\n\n- **API 端点**：`POST /aba/intelligentQuery`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/aba_query.py '' [--inline]`\n- **成本约束**：同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-aba-intelligent-query-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 查询构建\n\n调用本工具的关键参数是 `analysisDescription`——用自然语言描述要查询的数据。该描述会在后端转化为结构化查询，因此需要**精确、具体**。\n\n### analysisDescription 编写原则\n\n1. **明确站点**：在开头说明站点，如\"筛选美国站\"。\n2. **用精确筛选条件**：用具体数值区间而非模糊描述，\"排名在5万以内\"远优于\"排名较好\"。\n3. **明确时间范围**：用具体时间描述，如\"过去12周\"、\"2024年1-9月\"、\"近3个月\"。\n4. **明确对比基线**：做趋势分析时清楚说明对比的时间点，如\"4周前的排名比8周前提升30%\"。\n5. **处理去重逻辑**：同一搜索词 + ASIN 组合有多条记录时，说明保留哪条，如\"相同搜索词相同ASIN值保留最新的一个\"。\n6. **忠实用户意图**：不要曲解或过度扩展用户需求，准确反映其本意。\n\n### 常见场景示例\n\n**1. 搜索词热度趋势**\n```\n筛选美国站，关键词\"gift\"在过去12周的搜索热度排名。\n```\n\n**2. 上升黑马关键词**\n```\n筛选美国站，关键词包含\"gift\"，2025年Q1和全年的平均搜索排名都大于50万，但最新排名冲进5万-10万的搜索词。\n```\n\n**3. 持续增长趋势发现**\n```\n筛选美国站，最新排名在20万以内，且4周前的排名比8周前提升30%，本周的排名比4周前提升30%的搜索词。\n```\n\n**4. 市场机会发现（高搜索量、低垄断）**\n```\n筛选美国站，筛选当前搜索排名在20000以内，近三个月点击占比Top 1的Asin的转化率占比低于5%的搜索词。相同搜索词相同Asin值保留最新的一个。\n```\n\n**5. 季节性/节日关键词定位**\n```\n筛选美国站，包含\"cup\"的关键词中，去年（2024年）1-9月份排名未进入50万，10-11月份连续进入20万的词。\n```\n\n**6. 高点击低转化 ASIN 挖掘**\n```\n筛选美国站关键词包含\"hat\"的，最新搜索排名在5万-20万之间，且近3个月来点击占比大于20%，转化占比小于10%的ASIN。相同搜索词和ASIN仅保留点击占比和转化占比的比例最小数据。\n```\n\n**7. 高 ROAS 长尾蓝海词**\n```\n筛选美国站，关键词包含\"charger\"的，当前排名在20万开外的，近2个月的平均转化占比大于平均转化占比1.5倍的关键词，以及相应的ASIN。\n```\n\n**8. 新市场词与新兴需求探测**\n```\n找到美国站\"charger\"的长尾词中，近一个月才进入排名榜单，且当前排名在50万以内的所有词。\n```\n\n**9. 利基趋势/变体增长捕捉**\n```\n筛选美国站中\"table\"的长尾词中，排名在10万-30万之间，且近4周的搜索排名增长50%以上的搜索词。\n```\n\n## 展示规则\n\n1. **只呈现数据**：以清晰表格展示查询结果，不做主观商业建议。\n2. **排名澄清**：展示排名数据时提醒用户数值越小排名越优。\n3. **体量提示**：结果较大时展示核心数据并提醒用户可通过下载链接获取完整数据。\n4. **下载引导**：响应含 `downloadUrl` 时明确告知下载地址；用户需要全量数据但未请求下载时，主动建议生成下载链接。\n5. **错误处理**：查询失败时依据 `msg` 字段说明原因，并建议调整查询条件。\n\n## 用户表达与场景速查\n\n**适用** —— 围绕亚马逊搜索词的数据查询：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"XX 关键词搜索量/热度怎么样\" | 排名趋势 |\n| \"最近火的词\"、\"新冒出来的词\" | 黑马/新词探测 |\n| \"蓝海词\"、\"低竞争词\" | 市场机会发现 |\n| \"哪些词转化好\"、\"高转化长尾\" | 高 ROAS 关键词库 |\n| \"季节性词\"、\"旺季爆发的词\" | 季节性关键词 |\n| \"流量被谁占了\"、\"有没有垄断\" | 点击占比/垄断分析 |\n| \"高点击低转化的 ASIN\" | 高点击低转化诊断 |\n\n不适用场景见上方【能力边界】。\n\n**边界判断**：用户说\"选品\"、\"竞品分析\"、\"有没有市场机会\"时，若本质是搜索词级数据查询（找蓝海词、分析关键词下竞品流量分布），则适用本技能；若问利润空间、定价策略或综合市场报告，则不适用。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# ABA 智能查询 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/aba/intelligentQuery`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| analysisDescription | string | 是 | 精确描述查询意图的自然语言 |\n| region | string | 否 | 站点代码，默认 `US`。可选值：US、DE、BR、CA、AU、JP、AE、ES、FR、IT、SA、TR、MX、SE、NL |\n| createDownloadUrl | boolean | 否 | 是否生成CSV下载链接，默认 `false` |\n\n- 当用户明确要求\"下载\"、\"导出\"、\"生成文件\"时，将 `createDownloadUrl` 设为 `true`\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| success | boolean | 是否查询成功 |\n| tables | array | 结果数据数组，每个元素包含 `data`（数据行）、`columns`（列定义）、`name`（Sheet名称） |\n| total | integer | 结果总数 |\n| downloadUrl | string | 当 `createDownloadUrl` 为 true 时返回CSV文件地址 |\n| msg | string | 附加消息 |\n| downloadNote | string | 下载相关提示 |\n| code | string | 返回码 |\n| costTime | integer | 耗时（ms） |\n| costToken | integer | 消耗token |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析 `tables` / `data` 等业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n \"errcode\": 401,\n \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/aba/intelligentQuery \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"analysisDescription\": \"筛选美国站，关键词gift在过去12周的搜索热度排名\", \"region\": \"US\"}'\n```\n\nFile v1.2.3:references/linkfox-amazon-alexa-search.md\n\n---\nname: linkfox-amazon-alexa-search\ndescription: 模拟亚马逊前台 Alexa 购物助手，通过自然语言多轮问答获取导购建议、推荐商品分组及相关 ASIN 列表。\n---\n\n# 亚马逊 Alexa 购物助手（Amazon Alexa Shopping Assistant）\n\n本技能驱动亚马逊前台 Alexa 购物助手：用自然语言提问，获取导购回答、推荐商品分组（含 ASIN 与链接）以及可继续追问的问题。每次调用仅支持 1 条 prompt；多轮对话需由 agent 总结上文并拼接新问题发起新请求。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 通过亚马逊前台 Alexa 购物助手发起自然语言问答，获取导购回答与推荐商品分组（含 ASIN、标题、价格、评分、链接）。\n- 返回可继续追问的问题列表，支持 agent 总结上文后拼接新问题进行多轮对话。\n- 可用 `url` 锚定具体亚马逊页面（分类页 / 搜索结果页 / 商品详情页）作为对话上下文。\n- 支持 `markdown`（可读报告）与 `json`（结构化数据）两种输出格式。\n\n### ❌ 边界与限制\n\n- **每次仅 1 条 prompt**：`prompts` 数组只接受 1 个元素，不可一次传入多个问题。\n- **无跨调用记忆**：每次调用是全新的 Alexa 会话，追问须由 agent 总结上文 + 新问题作为 `prompts[0]` 重新发起。\n- **Alexa 驱动、非确定性**：相同 prompt 在不同时间/流量下可能返回不同答案。\n- **站点覆盖**：主要锚定 amazon.com 前台 Alexa 体验；非美国站点的可用性取决于 Alexa 上线情况。\n- **不传首页 URL**：`url` 仅在用户提供具体页面时传入；`https://www.amazon.com/` 这类首页 URL 不要传。\n- **不在范围内**：关键词 SERP 全量结果与排名（用前台搜索模拟技能）；历史搜索词分析或搜索量趋势（用 ABA 数据浏览器）；已知 ASIN 的商品详情/A+/五点（用亚马逊商品详情技能）；评论情感分析（用亚马逊评论技能）；以图搜款（用图片搜索技能）；对扁平商品列表的聚合统计。\n\n## 核心概念\n\n1. **单轮单问题**：`prompts` 是数组但只支持 **1 个元素**，每次调用发送 1 个问题并返回 1 个回答，不要传入多个元素。\n2. **跨调用无上下文**：每次调用都是全新 Alexa 会话。追问时 agent 须总结上一轮回答（关键推荐、ASIN、相关上下文），与新问题拼接后作为 `prompts[0]` 发起新请求。\n3. **可选页面上下文 `url`**：仅在需要把对话锚定到**具体**亚马逊页面（分类页、搜索结果页、商品详情页）时传入。不要传 `https://www.amazon.com/` 这类首页 URL——它不提供有用上下文。无具体页面时省略 `url`。\n4. **两种输出格式**：\n - `markdown`（默认）：一份可读 Markdown 报告，包含问题、Alexa 回答、推荐商品分组、可继续追问的问题。\n - `json`：`data` 下的结构化数组，每项含 `prompt`、`content`、`products`（分组推荐）、`followUpQuestions`、`screenshot`。\n\n`resultsNum` 为 Alexa 实际答复的对话轮次；为 `0` 表示 Alexa 未对该输入产生可用回答。\n\n## 调用方式\n\n- **API 端点**：`POST /amazon/alexaSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/amazon_alexa_search.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-alexa-search-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 单轮购物提问**\n```json\n{\n \"prompts\": [\"best wireless earbuds for running on Amazon US under $100\"]\n}\n```\n\n**2. 追问（agent 总结上文后重新提问）**\n\n首次调用：\n```json\n{\n \"prompts\": [\"best electric kettle on Amazon US\"]\n}\n```\n\n第二次调用（agent 总结上一轮回答并拼接追问）：\n```json\n{\n \"prompts\": [\"Previously Alexa recommended: 1) Cosori Electric Kettle (B07T1KY5TZ, $35.99, 4.7★), 2) Mueller Ultra Kettle (B09KC7D3HR, $29.97, 4.5★). Now compare these two on noise level and boil time.\"]\n}\n```\n\n**3. 锚定到分类页的问题**\n```json\n{\n \"prompts\": [\"What are the most popular picks on this page?\"],\n \"url\": \"https://www.amazon.com/s?k=electric+kettle\"\n}\n```\n\n**4. 结构化输出便于下游提取**\n```json\n{\n \"prompts\": [\"best gift ideas for a 10-year-old who likes science\"],\n \"format\": \"json\"\n}\n```\n\n## 展示规则\n\n1. **直接渲染 Markdown**：`format=markdown` 时 `stdout` 已按轮次标题、商品卡片、追问问题结构化，保留该结构呈现。\n2. **突出推荐 ASIN**：展示 `title`、`price`、`score`/`ratingsCount` 与商品 URL，便于用户点击直达。\n3. **展示追问问题**：Alexa 返回的 `followUpQuestions` 是可用的继续提问选项；用户选中其一后，总结当前回答并以该问题作为 `prompts[0]` 发起新调用。\n4. **不要重定向到数据分析沙箱**：回答正文是对话式的，推荐商品是嵌套分组而非适合 SQL 聚合的扁平表。\n5. **标注空结果**：`resultsNum` 为 `0` 或 `data` 为空时，告知用户 Alexa 未产生可用回答，建议改写问题或用 `url` 锚定页面。\n6. **说明时效**：结果反映调用时 Alexa 的实时回答；用户问及时效时说明这一点。\n7. **处理业务错误**：`code`/`errcode` 非 `200` 时，呈现 `msg`/`errmsg` 并建议用更简单的问题重试。\n\n## 用户表达与场景速查\n\n**适用** —— 亚马逊自然语言对话式购物：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"用 Alexa 帮我推荐...\", \"亚马逊 Alexa 问下...\" | 直接 Alexa 问答 |\n| \"在亚马逊上聊聊给我推荐 ...\", \"对话式选品\" | 对话式发现 |\n| \"顺便再追问一下 / 接着问 ...\" | 追问（agent 总结上文后在新调用中重新提问） |\n| \"在这个页面 / 这个分类下推荐...\", \"基于这个页面再问一下\" | 页面锚定对话（用 `url`） |\n| \"best XX for YY under $Z on Amazon\" | 目标 + 约束 + 预算问答 |\n| \"对比 Alexa 给的前两个推荐\" | 在 Alexa 回答内对比 |\n| \"Alexa 还能继续问什么 / 给我一些追问思路\" | 呈现追问问题 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 亚马逊 Alexa 购物助手 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/amazon/alexaSearch`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| prompts | string[] | 是 | 对话提示词数组，仅支持 **1 条**。每次调用只能传入 1 个问题。如需追问，agent 须自行总结上一轮回答的关键信息（推荐商品、ASIN、关键结论等），拼接新问题后作为新的 `prompts[0]` 发起新请求。每次调用是独立的新会话，不保留跨次调用的历史上下文 |\n| format | string | 否 | 响应格式，`markdown`（默认）返回可读报告；`json` 返回结构化数据数组 |\n| url | string | 否 | 联动页面 URL，用于补充 Alexa 当前答复的页面上下文。仅在用户提供了**具体页面**（分类页 / 搜索结果页 / 商品详情页等）时才传入；亚马逊首页（如 `https://www.amazon.com/`）**无需传**该参数 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| stdout | string | Markdown 格式问答报告，包含每一轮的用户问题、Alexa 回答、推荐商品、可继续追问的问题；仅 `format=markdown` 时返回 |\n| data | array | 结构化对话结果数组；仅 `format=json` 时返回 |\n| resultsNum | integer | Alexa 实际答复的对话轮次数量；为 0 表示未产生有效回答 |\n| code | string | 业务状态码，成功为 `\"200\"`（同 `errcode` 数值版） |\n| errcode | integer | 业务状态码（HTTP 层一般为 200，业务成功与否以此字段为准） |\n| msg / errmsg | string | 响应消息，成功为 `ok` |\n| costTime | integer | 接口耗时，单位毫秒 |\n| costToken | integer | 本次调用消耗 Token 数；上游成功才计费 |\n| taskId | string | 上游返回的本次任务标识 |\n| type | string | 渲染样式：`stdoutWorkbenches`（markdown）或 `json` |\n\n### `data[*]` 结构（`format=json`）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| prompt | string | 当前轮次发送给 Alexa 的提示词 |\n| content | string | Alexa 本轮回答的文本内容 |\n| screenshot | string | 本轮对话截图链接 |\n| followUpQuestions | string[] | Alexa 推荐继续追问的问题列表 |\n| products | array | 推荐商品分组列表，每个分组包含 `title` 和 `items` |\n| products[].title | string | 推荐分组标题 |\n| products[].items[].asin | string | 商品 ASIN |\n| products[].items[].title | string | 商品标题 |\n| products[].items[].url | string | 商品详情页 URL |\n| products[].items[].cover | string | 商品封面图 URL |\n| products[].items[].price | string | 现价（带币种） |\n| products[].items[].originalPrice | string | 原价或划线价 |\n| products[].items[].score | string | 评分 |\n| products[].items[].ratingsCount | string | 评价数量 |\n| products[].items[].describe | string | 商品简介 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 `errcode` / `code` 字段区分（`200` 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 `errcode` 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析 `stdout` 或 `data` 字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 计费/积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非 200 值 | 业务异常 | 参考 `errmsg` / `msg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n \"errcode\": 401,\n \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n**Markdown 格式（默认）：**\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/amazon/alexaSearch \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"prompts\": [\"best wireless earbuds for running\"]\n }'\n```\n\n**JSON 格式：**\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/amazon/alexaSearch \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"prompts\": [\"best electric kettle on Amazon US\"],\n \"format\": \"json\"\n }'\n```\n\n成功响应（节选）：\n\n```json\n{\n \"msg\": \"ok\",\n \"errcode\": 200,\n \"code\": \"200\",\n \"stdout\": \"# 亚马逊 Alexa 购物助手\\n\\n## 问题 1：best wireless earbuds for running\\n\\n### Alexa 回答\\n- ...\\n\\n### 推荐商品\\n- ...\\n\\n### 可继续追问的问题\\n- ...\\n\",\n \"resultsNum\": 1,\n \"costTime\": 12000,\n \"costToken\": 1500,\n \"type\": \"stdoutWorkbenches\",\n \"taskId\": \"1779367311421-d728ce53704fc86e\"\n}\n```\n\nFile v1.2.3:references/linkfox-amazon-opportunity-report-by-keyword.md\n\n---\nname: linkfox-amazon-opportunity-report-by-keyword\ndescription: 按关键词查询亚马逊商业洞察报告，包含市场潜力、产品特征、用户评论、人群画像、搜索趋势及定价分析。\n---\n\n# 亚马逊-机会报告（Amazon Market Opportunity Report）\n\n本技能用于按关键词生成亚马逊商业洞察报告，帮助卖家基于数据做出选品与市场进入决策。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 按关键词生成亚马逊商业洞察报告，基于实时亚马逊数据由 AI 分析六大维度：市场潜力、产品特征、用户评论、客户画像、搜索趋势、定价分析。\n- 报告以结构化 Markdown 文档形式交付，作为选品与市场进入的决策支持。\n\n### ❌ 边界与限制\n\n- **仅支持美国站**：当前 `site` 仅支持 `US`（美国市场），用户请求其他站点时需告知本工具暂不支持。\n- **非结构化输出**：返回 Markdown 报告，而非结构化 JSON 数据；不能与数据查询工具配合做二次聚合分析。\n- **生成耗时**：报告涉及 AI 分析，耗时长于普通数据查询。\n- **快照数据**：报告反映生成时点的数据，不会持续更新。\n- **不在范围内**：实时关键词排名追踪（用 ABA 或 SIF 工具）；单品详情查询（用商品详情工具）；历史价格追踪（用 Keepa）；指定 ASIN 的评论级分析（用评论工具）；广告/PPC 策略。\n\n## 核心概念\n\n本工具通过分析亚马逊关键词的六大核心维度，生成综合商业洞察报告：\n\n1. **市场潜力（Market Potential）**：搜索量、需求趋势与增长机会。\n2. **产品特征（Product Characteristics）**：常见商品属性、材质、功能。\n3. **用户评论（User Reviews）**：客户情感、痛点与满意度驱动因素。\n4. **客户画像（Customer Profile）**：买家人群特征、偏好与行为模式。\n5. **搜索趋势（Search Trends）**：关键词热度走势与季节性。\n6. **定价分析（Pricing Analysis）**：价格分布与竞争价格格局。\n\n报告由 AI 基于实时亚马逊数据生成，以结构化 Markdown 文档交付。它是用于决策支持的快照分析，而非实时监控工具。\n\n## 调用方式\n\n- **API 端点**：`POST /amazon/opportunity/reportByKeyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/amazon_opportunity_report.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-opportunity-report-by-keyword-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 基础商业洞察报告**\n```\n帮我搜索美国站，关键词是 hair mousse travel size 的商业洞察报告\n```\n\n**2. 细分品类调研**\n```\n帮我生成美国站关键词 magnetic shelves for whiteboard 的商业洞察报告\n```\n\n**3. 趋势选品**\n```\n我想了解美国站 solar power ac unit 这个关键词的商业洞察，帮我生成报告\n```\n\n## 展示规则\n\n1. **直接呈现报告**：API 在 `stdout` 字段返回 Markdown 格式报告，原样展示给用户。\n2. **不做主观建议**：呈现 AI 生成的分析，不添加自己的商业建议。\n3. **说明数据范围**：提醒用户报告基于时点快照，作为决策参考。\n4. **错误处理**：查询失败时，依据 `msg` 字段说明原因，并建议检查关键词或重试。\n5. **不支持二次分析**：本工具的输出不能作为数据查询工具的输入做进一步处理，若用户尝试需告知限制。\n\n## 用户表达与场景速查\n\n**适用** —— 关键词级别的综合市场分析：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"帮我分析这个关键词的市场机会\" | 市场机会评估 |\n| \"给 XX 生成一份市场洞察报告\" | 完整洞察报告 |\n| \"XX 的竞争格局如何\" | 竞争与定价分析 |\n| \"XX 产品的消费者画像\" | 客户行为洞察 |\n| \"XX 这个关键词值不值得做\" | 市场进入评估 |\n| \"选品报告\"、\"商业洞察\" | 中文市场调研请求 |\n\n不适用场景见上方【能力边界】。\n\n**边界判断**：当用户提到\"市场分析\"或\"选品调研\"时，若希望获得关键词市场机会的整体多维度概览，则适用本技能；若需要具体数据点（精确销量、单品详情、关键词历史排名），应引导至对应专项工具。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 亚马逊商业洞察报告 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/amazon/opportunity/reportByKeyword`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n- **User-Agent**：`LinkFox-Skill/1.0`\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| site | string | 是 | 亚马逊站点代码，当前仅支持 `US` |\n| keyword | string | 是 | 要查询洞察报告的搜索关键词 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| code | string | 响应码 |\n| msg | string | 提示信息或错误信息 |\n| stdout | string | 综合商业洞察报告内容（Markdown 格式），包含市场潜力、产品特征、用户评论、客户画像、搜索趋势、定价分析六大维度 |\n| costTime | integer | 总处理耗时（毫秒） |\n| costToken | integer | token 消耗量 |\n| type | string | 响应类型 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 code 字段区分。当遇到未授权等情况时，HTTP 状态码为 401。\n\n| 错误码 | 含义 | 处理建议 |\n|--------|------|----------|\n| 200 | 成功 | 正常解析 `stdout` 字段，将 Markdown 报告展示给用户 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 其他非200值 | 业务异常 | 参考 `msg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n \"errcode\": 401,\n \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/amazon/opportunity/reportByKeyword \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"User-Agent: LinkFox-Skill/1.0\" \\\n -d '{\"site\": \"US\", \"keyword\": \"ice bricks\"}'\n```\n\nFile v1.2.3:references/linkfox-amazon-opportunity-search-by-metrics.md\n\n---\nname: linkfox-amazon-opportunity-search-by-metrics\ndescription: 基于 30+ 项商业指标进行亚马逊反向选品，筛选符合特定市场规模、竞争密度、人群画像及定价机会的细分赛道。\n---\n\n# 亚马逊机会指标反向筛选（Amazon Opportunity Screener by Metrics）\n\n本技能引导你从历史机会报告沉淀的指标数据池中**反向检索**亚马逊赛道与关键词，把模糊的选品想法（低竞争、需求增长、蓝海、痛点机会等）转化为具体的候选赛道。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 基于商业维度（市场规模与增长、竞争密度、价格与档位、人群画像、产品特征、评论卖点/痛点）反向筛选亚马逊**赛道/关键词**级记录。\n- 每条记录约 37 个字段，覆盖赛道快照：市场规模、增长、竞争、价格档位、人群、特征与评论主题。\n- 支持按关键词文本片段、赛道名片段以及任意指标过滤字段组合检索，结果按采集时间倒序返回。\n\n### ❌ 边界与限制\n\n- **仅美国站**：当前仅支持美国市场（`amazonDomain` = `US`），其他站点暂不支持。\n- **无分页**：无 `page` 参数，靠 `limit`（最大 200）扩大候选池，按采集时间倒序返回最近 N 条。\n- **至少一个过滤条件**：未提供 `keyword` / `nicheName` 且无任何指标过滤字段的请求会被拒绝。\n- **快照数据**：记录聚合自历史机会报告，新报告会逐步刷新数据池，但单条记录非实时。\n- **赛道级粒度**：输出为赛道/关键词级，非 ASIN 级。如需钻取赛道内具体商品，转交 `linkfox-amazon-search`、`linkfox-keepa-product-search` 等。\n- **不支持二次聚合**：结果供前端渲染、不入库，无法喂给 `@智能数据查询` 做分组统计。\n- **不在范围内**：对单个关键词做多维度综合 AI 报告（用 `linkfox-amazon-opportunity-report`）；ASIN 级竞品/销量调研（用 SellerSprite / Keepa / Sorftime）；实时关键词排名与搜索词挖掘（用 ABA / SIF 工具）。\n\n## 核心概念\n\n本工具暴露一个可查询的**赛道级指标池**（每条记录约 37 个字段），蒸馏自历史亚马逊机会报告。它不是生成新报告（正向分析），而是让你按 30+ 项商业维度**反向过滤**已有数据池，返回匹配的 `(站点, 关键词)` 记录，按采集时间倒序。\n\n记录粒度为**赛道/关键词**级，非 ASIN 级。每条记录代表一个赛道快照——其市场规模、增长、竞争、价格档位、人群画像、核心特征与评论主题。\n\n**正向 vs 反向**：用户已有具体关键词、要一份综合 AI 报告时用 `linkfox-amazon-opportunity-report`；用户已有商业筛选条件、要发现哪些关键词/赛道符合时用本技能。\n\n**筛选维度**：过滤参数分为六大商业维度——市场规模与增长、竞争密度、价格与档位、人群画像、产品特征、评论卖点/痛点。完整参数列表、类型与取值范围见 [references/api.md](references/api.md)。\n\n## 调用方式\n\n- **API 端点**：`POST /amazon/opportunity/searchByMetrics`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/amazon_opportunity_screener.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-opportunity-search-by-metrics-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 查询构建\n\n用户用自然语言表达商业意图，你将其映射为**最小可行过滤集**。原则：\n\n1. **把意图转为具体边界**：\"低竞争\" → `nicheBrandCountLte: 20`；\"快速增长\" → `nicheSearchVolumeYoyChangePctAtLeastGte: 100`（同比 ≥100%）；\"新人友好\" → `featureNewAvgReviewCountAtLeastLte: 500`。\n2. **先窄后宽**：首次通常用 2–4 个强过滤 + `limit=25`。若结果为空或过少，放宽最激进的过滤，而非新增过滤。\n3. **配对互补信号**：品牌级 + 产品级集中度（`featureTop5BrandSharePctAtLeastLte` + `nicheTop5ProductClickSharePctAtLeastGte`）揭示\"品牌分散但产品集中\"——品牌延伸切入信号。\n4. **标签字段用 snake_case 片段**：`featureEmergingTrendTagsContains`、`demoLifeStageTagsContains`、`reviewNegativeTop1Topic` 等接受 snake_case 词片段并做 LIKE 匹配。传一个词根（`size`、`parent`、`cordless`）即可覆盖归一化变体。\n5. **忠于用户意图**：不要静默添加用户未提的过滤。用户只说\"增长\"就只过滤增长，除非其明确提到价格否则不要额外约束价格。\n\n## 使用示例\n\n**1. 按关键词反向追溯赛道**\n> \"反向查一下 whoop band 这个词的赛道\"\n```json\n{\"keyword\": \"whoop band\", \"limit\": 25}\n```\n\n**2. 新人友好的低竞争赛道**\n```json\n{\"nicheBrandCountLte\": 20, \"featureNewAvgReviewCountAtLeastLte\": 500, \"limit\": 25}\n```\n\n**3. 高增长蓝海（同比 ≥100%，品牌尚未涌入）**\n```json\n{\"nicheSearchVolumeYoyChangePctAtLeastGte\": 100, \"nicheBrandCountYoyChangePctAtLeastLte\": 30, \"limit\": 25}\n```\n\n**4. 中档价格缺口（低价主导、中档稀缺）**\n```json\n{\"priceEntryClickSharePctAtLeastGte\": 70, \"priceMidClickSharePctAtLeastLte\": 5, \"limit\": 25}\n```\n\n**5. 痛点切入——尺码投诉强烈**\n```json\n{\"reviewNegativeTop1Topic\": \"size\", \"reviewNegativeTop1PctAtLeastGte\": 70, \"limit\": 25}\n```\n\n**6. 高端友好的女性主导赛道**\n```json\n{\"demoGenderDominant\": \"female\", \"demoPrimaryIncomeTier\": \"high\", \"priceHighClickSharePctAtLeastGte\": 25, \"limit\": 25}\n```\n\n**7. Q4 季节性赛道且峰值搜索 ≥10 万**\n```json\n{\"nichePeakMonthGte\": 11, \"nichePeakMonthLte\": 12, \"nichePeakSearchVolumeAtLeastGte\": 100000, \"limit\": 25}\n```\n\n**8. 追踪某竞品品牌周边赛道**\n```json\n{\"featureTopBrandsContains\": \"WHOOP\", \"limit\": 50}\n```\n\n## 展示规则\n\n1. **只呈现数据**：把返回的赛道以干净对比表呈现——赛道名/关键词、市场规模、增长、品牌数、价格区间、关键标签。不做主观商业建议。\n2. **回显当前筛选**：把你使用的过滤集回显出来便于用户调整（如\"当前筛选：品牌数 ≤ 20 且搜索量同比 ≥ 100%\"）。\n3. **时间快照提示**：记录反映采集时点数据，非持续更新。当结果看起来过时或与用户外部认知冲突时说明这一点。\n4. **空/少结果处理**：若 `data` 为空或很短，建议放宽最激进的过滤，而非从头再问用户。\n5. **错误处理**：查询失败时基于 `msg` 字段说明原因（最常见是\"参数全空\"拦截），并建议至少添加一个过滤。\n6. **不支持二次聚合**：结果供前端渲染、不入库，无法喂给 `@智能数据查询` 做进一步聚合。用户要跨赛道分组统计时，本地计算或先拉更大 `limit`。\n\n## 用户表达与场景速查\n\n**适用** —— 美国亚马逊市场赛道级反向选品：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"低竞争赛道\"、\"新人友好\"、\"品牌少\" | 品牌密度过滤 |\n| \"品牌在退出\"、\"老玩家在撤退\" | 品牌数同比为负 |\n| \"高增长赛道\"、\"在涨\"、\"同比 ≥100%\" | 搜索量同比过滤 |\n| \"中档蓝海\"、\"低价主导但中档稀缺\" | 价格档位份额缺口 |\n| \"高端友好\"、\"高收入人群\" | 收入档 + 高档份额 |\n| \"女性/男性/混合市场\" | 性别主导过滤 |\n| \"宝妈/学生/退休人群/健身爱好者\" | 生命阶段标签 |\n| \"尺码/质量/耐用性痛点强烈\" | 差评主题 + 占比 |\n| \"舒适驱动\"、\"性价比卖家\" | 好评主题 + 占比 |\n| \"追踪品牌 X 周边所有赛道\" | `featureTopBrandsContains` |\n| \"Q4 季节性赛道\"、\"Prime Day 窗口\" | 峰值月份 + 峰值量 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 亚马逊商业洞察反向选品 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/amazon/opportunity/searchByMetrics`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n- **User-Agent**：`LinkFox-Skill/1.0`\n\n## 请求参数\n\nPOST Body（JSON）。所有参数均为可选，但**必须至少提供 `keyword` / `nicheName` 或任意一个指标过滤字段**，禁止全部为空。\n\n### 站点与翻页\n\n| 参数 | 类型 | 说明 | 示例 |\n|------|------|------|------|\n| amazonDomain | string | 亚马逊站点代码（闭枚举），当前仅支持 `US`，未指定时默认仅查美国站 | `US` |\n| limit | integer | 返回条数上限（1-200），默认 25。无 page 参数，按采集时间倒序返回最近 N 条 | `25` |\n\n### 文本搜索\n\n| 参数 | 类型 | 说明 | 示例 |\n|------|------|------|------|\n| keyword | string | 搜索关键词文本片段（LIKE 模糊匹配） | `whoop band` |\n| nicheName | string | 赛道归一化名称片段（LIKE，snake_case 小写），适合赛道时序对比 | `wired_ribbon` |\n\n### 市场规模与增长\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| nicheRevenue360dMinUsdAtLeastGte | number | 360 天市场营收下界（USD）的最小值 |\n| nicheRevenue360dMinUsdAtLeastLte | number | 360 天市场营收下界（USD）的最大值 |\n| nicheRevenue360dMaxUsdAtLeastGte | number | 360 天市场营收上界（USD）的最小值 |\n| nicheRevenue360dMaxUsdAtLeastLte | number | 360 天市场营收上界（USD）的最大值 |\n| nichePeakSearchVolumeAtLeastGte | integer | 峰值月搜索量下界（非负整数） |\n| nichePeakSearchVolumeAtLeastLte | integer | 峰值月搜索量上界（非负整数） |\n| nicheSearchVolumeYoyChangePctAtLeastGte | number | 搜索量同比变化率下限（%，带符号） |\n| nicheSearchVolumeYoyChangePctAtLeastLte | number | 搜索量同比变化率上限（%，带符号） |\n| nichePeakMonthGte | integer | 搜索峰值月份下限（1-12） |\n| nichePeakMonthLte | integer | 搜索峰值月份上限（1-12） |\n\n### 竞争格局（品牌 / 产品集中度）\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| nicheBrandCountGte | integer | 活跃品牌数下限 |\n| nicheBrandCountLte | integer | 活跃品牌数上限 |\n| nicheBrandCountYoyChangePctAtLeastGte | number | 品牌数同比变化率下限（%，带符号） |\n| nicheBrandCountYoyChangePctAtLeastLte | number | 品牌数同比变化率上限（%，带符号） |\n| nicheTop5ProductClickSharePctAtLeastGte | number | Top5 产品点击份额下限（0-100） |\n| nicheTop5ProductClickSharePctAtLeastLte | number | Top5 产品点击份额上限（0-100） |\n| featureTop5BrandSharePctAtLeastGte | number | Top5 品牌合计份额下限（0-100） |\n| featureTop5BrandSharePctAtLeastLte | number | Top5 品牌合计份额上限（0-100） |\n| featureTopBrandsContains | string | Top3 品牌名片段（原文 LIKE，区分大小写） |\n\n### 价格与档位\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| priceMinUsdGte | number | 赛道最低商品价格下限（USD） |\n| priceMinUsdLte | number | 赛道最低商品价格上限（USD） |\n| priceMaxUsdGte | number | 赛道最高商品价格下限（USD） |\n| priceMaxUsdLte | number | 赛道最高商品价格上限（USD） |\n| priceSweetSpotMinUsdGte | number | Sweet Spot 下限的下界（USD） |\n| priceSweetSpotMinUsdLte | number | Sweet Spot 下限的上界（USD） |\n| priceSweetSpotMaxUsdGte | number | Sweet Spot 上限的下界（USD） |\n| priceSweetSpotMaxUsdLte | number | Sweet Spot 上限的上界（USD） |\n| priceEntryClickSharePctAtLeastGte | number | 入门档点击份额下限（0-100） |\n| priceEntryClickSharePctAtLeastLte | number | 入门档点击份额上限（0-100） |\n| priceMidClickSharePctAtLeastGte | number | 中档点击份额下限（0-100） |\n| priceMidClickSharePctAtLeastLte | number | 中档点击份额上限（0-100） |\n| priceHighClickSharePctAtLeastGte | number | 高端档点击份额下限（0-100） |\n| priceHighClickSharePctAtLeastLte | number | 高端档点击份额上限（0-100） |\n\n### 客户画像（年龄 / 性别 / 收入 / 生命阶段）\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| demoPrimaryAgeMinGte | integer | 主人群年龄下界的最小值（0-120 岁） |\n| demoPrimaryAgeMinLte | integer | 主人群年龄下界的最大值（0-120 岁） |\n| demoPrimaryAgeMaxGte | integer | 主人群年龄上界的最小值（0-120 岁） |\n| demoPrimaryAgeMaxLte | integer | 主人群年龄上界的最大值（0-120 岁） |\n| demoGenderDominant | string | 性别主导（闭枚举）：`female` / `male` / `mixed` / `unspecified` |\n| demoPrimaryIncomeTier | string | 收入档（闭枚举）：`low` / `middle_low` / `middle` / `middle_upper` / `upper_middle` / `high` |\n| demoLifeStageTagsContains | string | 生命阶段标签片段（snake_case，LIKE）：`parent`、`student`、`retiree`、`athlete` 等 |\n\n### 产品特征（成熟度 / 趋势 / 差异化 / 搜索形态）\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| featureNewAvgReviewCountAtLeastGte | integer | 新品平均评论量下限（非负整数） |\n| featureNewAvgReviewCountAtLeastLte | integer | 新品平均评论量上限（非负整数） |\n| featureEstablishedAvgReviewCountAtLeastGte | integer | 成熟老品平均评论量下限（非负整数） |\n| featureEstablishedAvgReviewCountAtLeastLte | integer | 成熟老品平均评论量上限（非负整数） |\n| featureEmergingTrendTagsContains | string | 新兴趋势特征标签片段（snake_case，LIKE）：`cordless`、`portable`、`smart` 等 |\n| featureUncommonFeatureTagsContains | string | 稀有差异化特征标签片段（snake_case，LIKE）：`hema_free`、`medical_grade_silicone` 等 |\n| searchTopCategory1Label | string | 搜索流量第一类目标签片段（snake_case，LIKE）：`core_product_terms`、`set_kit_configurations` 等 |\n\n### 评论卖点 / 痛点\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| reviewPositiveTop1Topic | string | 好评 #1 主题片段（snake_case，LIKE）：`comfort`、`quality_overall_generic` 等 |\n| reviewPositiveTop1PctAtLeastGte | number | 好评 #1 主题占比下限（0-100，正面评论中占比） |\n| reviewPositiveTop1PctAtLeastLte | number | 好评 #1 主题占比上限（0-100） |\n| reviewNegativeTop1Topic | string | 差评 #1 主题片段（snake_case，LIKE）：`size`、`quality`、`durability` 等 |\n| reviewNegativeTop1PctAtLeastGte | number | 差评 #1 主题占比下限（0-100，负面评论中占比） |\n| reviewNegativeTop1PctAtLeastLte | number | 差评 #1 主题占比上限（0-100） |\n| reviewNegativeTop2Topic | string | 差评 #2 主题片段（snake_case，LIKE） |\n| reviewStrategicInsightTagsContains | string | 评论策略建议标签片段（snake_case，LIKE）：`sizing_clarity`、`material_transparency` 等 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| code | string | 响应码，`200` 为成功 |\n| msg | string | 提示信息，成功为 `ok`，失败为错误描述 |\n| data | array | 关键词指标记录数组，每条对应一个 (站点, 关键词) 组合，约 37 个字段，按采集时间倒序 |\n\n`data[]` 主要字段（节选）：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| amazonDomain | string | 站点代码（当前固定 `US`） |\n| keyword | string | 原始搜索关键词 |\n| nicheName | string | 赛道归一化名称（snake_case） |\n| nicheRevenue360dMinUsdAtLeast / nicheRevenue360dMaxUsdAtLeast | number | 近 360 天市场营收下界 / 上界（USD） |\n| nichePeakSearchVolumeAtLeast | integer | 峰值月搜索量 |\n| nichePeakMonth | integer | 搜索峰值月份（1-12） |\n| nicheSearchVolumeYoyChangePctAtLeast | number | 搜索量同比变化率（%，带符号） |\n| nicheBrandCount / nicheBrandCountYoyChangePctAtLeast | integer / number | 活跃品牌数及其同比变化率 |\n| nicheTop5ProductClickSharePctAtLeast | number | Top5 产品点击份额（0-100） |\n| featureTop5BrandSharePctAtLeast | number | Top5 品牌合计份额（0-100） |\n| featureTopBrands | array | Top 3 品牌名列表（原文） |\n| priceMinUsd / priceMaxUsd | number | 赛道整体最低 / 最高商品价 |\n| priceSweetSpotMinUsd / priceSweetSpotMaxUsd | number | Value Sweet Spot 价格区间下界 / 上界 |\n| priceEntryClickSharePctAtLeast / priceMidClickSharePctAtLeast / priceHighClickSharePctAtLeast | number | 入门 / 中 / 高档点击份额（0-100） |\n| demoPrimaryAgeMin / demoPrimaryAgeMax | integer | 核心人群年龄下界 / 上界 |\n| demoGenderDominant | string | 性别主导（`female` / `male` / `mixed` / `unspecified`） |\n| demoPrimaryIncomeTier | string | 核心人群收入档 |\n| demoLifeStageTags | array | 生命阶段标签列表 |\n| featureNewAvgReviewCountAtLeast / featureEstablishedAvgReviewCountAtLeast | integer | 新品 / 成熟老品平均评论量 |\n| featureEmergingTrendTags / featureUncommonFeatureTags | array | 新兴趋势 / 稀有差异化特征标签 |\n| searchTopCategory1Label | string | 流量第一类目归一化标签 |\n| reviewPositiveTop1Topic / reviewPositiveTop1PctAtLeast | string / number | 好评 #1 主题及在正面评论中的占比 |\n| reviewNegativeTop1Topic / reviewNegativeTop1PctAtLeast / reviewNegativeTop2Topic | string / number / string | 差评 #1 主题、占比及次因 |\n| reviewStrategicInsightTags | array | 评论策略建议标签 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 `code` 字段区分；未授权时 HTTP 状态码为 401。\n\n| 错误码 | 含义 | 处理建议 |\n|--------|------|----------|\n| 200 | 成功 | 正常解析 `data` 数组并展示给用户 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 其他非 200 值 | 业务异常 | 参考 `msg` 字段获取具体错误原因，常见为参数全空或参数取值非法 |\n\n错误响应示例：\n\n```json\n{\n \"errcode\": 401,\n \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n按品牌密度低 + 同比高增长筛选新人友好赛道：\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/amazon/opportunity/searchByMetrics \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"User-Agent: LinkFox-Skill/1.0\" \\\n -d '{\n \"nicheBrandCountLte\": 20,\n \"nicheSearchVolumeYoyChangePctAtLeastGte\": 100,\n \"featureNewAvgReviewCountAtLeastLte\": 500,\n \"limit\": 25\n }'\n```\n\n按关键词反向追溯赛道历史：\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/amazon/opportunity/searchByMetrics \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"User-Agent: LinkFox-Skill/1.0\" \\\n -d '{\"keyword\": \"whoop band\", \"limit\": 50}'\n```\n\n按差评痛点 + 中档稀缺锁定切入机会：\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/amazon/opportunity/searchByMetrics \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -H \"User-Agent: LinkFox-Skill/1.0\" \\\n -d '{\n \"reviewNegativeTop1Topic\": \"size\",\n \"reviewNegativeTop1PctAtLeastGte\": 70,\n \"priceMidClickSharePctAtLeastLte\": 5,\n \"priceEntryClickSharePctAtLeastGte\": 70\n }'\n```\n\nFile v1.2.3:references/linkfox-amazon-product-detail.md\n\n---\nname: linkfox-amazon-product-detail\ndescription: 通过 ASIN 获取亚马逊商品的完整详情，包括标题、五点描述、规格参数、价格、变体、A+页面及图片等结构化数据。\n---\n\n# 亚马逊-前端商品详情（Amazon Product Detail Lookup）\n\n本技能通过 ASIN 获取亚马逊商品的完整详情，帮助亚马逊卖家与研究人员从商品页面提取结构化数据，覆盖 22 个亚马逊站点。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 通过 ASIN 获取亚马逊商品页面的结构化详情：标题、主图与附图、五点描述（About This Item）、商品规格、A+ 内容描述、价格、评分分布、变体结构。\n- 支持单次最多 40 个 ASIN 批量查询（逗号分隔）。\n- 支持 22 个亚马逊站点（美、英、德、法、意、西、日、加、澳、巴、印、荷、瑞典、波兰、新、沙、阿联酋、土耳其、墨、埃及、中、比利时）。\n- 可选返回「经常一起购买」「相关商品」「作者评论」数据。\n\n### ❌ 边界与限制\n\n- **按 ASIN 计费**：成本高于搜索类工具，引导用户仅查询真正需要的 ASIN，避免大批量试探性查询。\n- **当前快照**：仅返回当前商品页面数据，不含历史价格追踪、销量估算或收入计算。\n- **非页面数据**：关键词/搜索词分析（用 ABA 工具）、搜索结果排名、广告/PPC 数据、库存管理与 FBA 费用分析、评论情感 NLP（仅返回原始评论文本）均不在范围内。\n- **ASIN 有效性**：查询失败时需检查 ASIN 是否有效、站点域名是否正确。\n- 同一会话同一参数组合默认只调用一次；失败/空结果不得自动换关键词、翻页或改邮编连续试探。\n\n## 核心概念\n\n本工具通过前端模拟亚马逊商品页面，提取结构化详情数据，返回商品标题、主图、附图、五点描述、商品规格、A+ 内容描述、价格、评分分布、变体结构，并可选返回「经常一起购买」与「相关商品」数据。\n\n**批量支持**：单次请求最多 40 个 ASIN，以逗号分隔字符串传入。\n\n## 调用方式\n\n- **API 端点**：`POST /amazon/product/detail`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/amazon_product_detail.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-product-detail-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 基础单个 ASIN 查询**\n```\n查一下美国站 ASIN B072MQ5BRX 的详情。\n```\n参数：`{\"asins\": \"B072MQ5BRX\"}`\n\n**2. 多 ASIN 批量查询**\n```\n查 B072MQ5BRX 和 B08N5WRWNW 的商品详情。\n```\n参数：`{\"asins\": \"B072MQ5BRX,B08N5WRWNW\"}`\n\n**3. 非美国站查询**\n```\n查德国站 B09V3KXJPB 的商品信息。\n```\n参数：`{\"asins\": \"B09V3KXJPB\", \"amazonDomain\": \"amazon.de\"}`\n\n**4. 含评论与经常一起购买**\n```\n查日本站 B08N5WRWNW 的完整详情，包含评论和经常一起购买。\n```\n参数：`{\"asins\": \"B08N5WRWNW\", \"amazonDomain\": \"amazon.co.jp\", \"returnBoughtTogether\": true, \"returnAuthorsReviews\": true}`\n\n**5. 竞品 Listing 对比**\n```\n对比这 3 个 ASIN 的五点描述和价格：B072MQ5BRX, B08N5WRWNW, B09V3KXJPB。\n```\n参数：`{\"asins\": \"B072MQ5BRX,B08N5WRWNW,B09V3KXJPB\"}`\n\n**6. 移动端商品页检查**\n```\n看看英国站 B072MQ5BRX 在移动端的展示。\n```\n参数：`{\"asins\": \"B072MQ5BRX\", \"amazonDomain\": \"amazon.co.uk\", \"device\": \"mobile\"}`\n\n## 展示规则\n\n1. **清晰呈现数据**：用结构化格式展示商品详情——规格与价格对比用表格，五点描述用列表。\n2. **图片处理**：响应含图片 URL（`productImageUrls`、`thumbnail`、`imageUrl`）时，按场景以可点击链接或内嵌图片展示。\n3. **多 ASIN 结果**：查询多个 ASIN 时，按 ASIN 与标题清晰分隔并标注每个商品。\n4. **价格格式**：价格须带币种符号/代码；有折扣时同时展示现价与原价以突出优惠。\n5. **评分拆解**：存在 `customerReviews` 数据时，展示星级分布（5 星到 1 星占比）及总评分与评论数。\n6. **变体展示**：存在变体时，按变体维度（颜色、尺寸等）分组用紧凑表格展示。\n7. **错误处理**：查询失败时说明原因，并建议检查 ASIN 是否有效、站点域名是否正确。\n8. **成本提醒**：提示用户本工具按 ASIN 计费，仅批量查询真正需要的 ASIN。\n\n## 用户表达与场景速查\n\n**适用** —— 需要亚马逊商品页面结构化数据的任务：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"查一下这个 ASIN\"、\"获取……的商品详情\" | 单个/批量 ASIN 详情查询 |\n| \"这个商品的五点描述是什么\" | Listing 内容提取 |\n| \"看看竞品的 Listing\" | 多 ASIN 对比 |\n| \"这个 ASIN 在德国站多少钱\" | 跨站点价格查询 |\n| \"这个商品有多少评论\" | 评分与评论分析 |\n| \"这个商品有哪些变体\" | 变体结构查看 |\n| \"获取 A+ 内容/商品描述\" | 商品描述获取 |\n| \"这个 ASIN 的主图是什么\" | 商品图片提取 |\n| \"这个商品是否支持 Prime\" | 资格/徽章检查 |\n| \"商品规格/尺寸是什么\" | 规格查询 |\n\n不适用场景见上方【能力边界】。\n\n**边界判断**：用户说\"分析这个商品\"或\"调研这个 ASIN\"时，若本质是获取当前商品页面数据（标题、价格、五点、图片、评论、变体），则适用本技能；若需要历史趋势、销量估算或广告洞察，则不适用。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用skill内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个skill。\n\n---\n\n# 亚马逊前端-商品详情 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/amazon/product/detail`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| asins | string | 是 | ASIN列表，支持批量查询，最多40个ASIN。格式：`^[A-Z0-9]+(,[A-Z0-9]+){0,39}$`。示例：`B072MQ5BRX,B08N5WRWNW` |\n| amazonDomain | string | 否 | 亚马逊各个国家站点，默认 `amazon.com`。可选值：`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.tr`、`amazon.com.mx`、`amazon.eg`、`amazon.cn`、`amazon.com.be` |\n| language | string | 否 | 语言。示例：`en_US`、`de_DE`、`fr_FR`、`ja_JP`、`it_IT`、`es_ES`、`pt_BR`、`en_GB`、`zh_CN` |\n| deliveryZip | string | 否 | 配送邮编，用于获取配送相关定价。示例：`10001`（美国纽约）、`10115`（德国柏林）、`EC1A 1BB`（英国伦敦） |\n| device | string | 否 | 设备类型：`desktop`（默认）、`mobile`、`tablet` |\n| returnBoughtTogether | boolean | 否 | 是否返回经常一起购买的商品（boughtTogether），默认 `false` |\n| returnRelatedProducts | boolean | 否 | 是否返回相关商品列表（relatedProducts），默认 `false` |\n| returnAuthorsReviews | boolean | 否 | 是否返回作者评论列表（authorsReviews），默认 `false` |\n\n## 响应结构\n\n顶层字段：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 总行数 |\n| columns | array | 渲染的列 |\n| type | string | 渲染的样式 |\n| costToken | integer | 消耗token |\n| products | array | 产品列表（详见下方） |\n\n### 产品对象字段\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| asin | string | ASIN编码 |\n| title | string | 商品标题 |\n| brand | string | 品牌 |\n| price | number | 价格 |\n| extractedPrice | number | 提取的价格 |\n| oldPrice | number | 原价 |\n| extractedOldPrice | number | 提取的原价 |\n| currency | string | 币种 |\n| discount | string | 折扣 |\n| saveWithCoupon | string | 优惠券节省金额 |\n| rating | number | 评分 |\n| ratings | integer | 评论数 |\n| prime | boolean | 是否Prime商品 |\n| stock | string | 库存状态 |\n| delivery | string | 配送信息 |\n| link | string | 商品链接 |\n| linkClean | string | 纯净链接 |\n| asinUrl | string | 链接 |\n| imageUrl | string | 缩略图 |\n| thumbnail | string | 缩略图 |\n| productImageUrls | array | 商品图片链接列表 |\n| aboutItem | array | 五点描述 |\n| productDescription | string | 商品描述列表 |\n| description | string | 商品描述 |\n| dimension | string | 商品尺寸 |\n| weight | string | 重量 |\n| tags | string | 标签列表 |\n| badges | string | 徽章列表 |\n| climatePledgeFriendly | boolean | 是否气候友好 |\n| snapEbtEligible | boolean | 是否支持SNAP EBT |\n| boughtLastMonth | string | 上月购买数（字符串） |\n| boughtLastMonthCount | integer | 上月购买数（数字） |\n| reviewsSummary | string | 评论摘要 |\n| reviewsImages | array | 评论图片列表 |\n| sourceTool | string | 来源工具 |\n| sourceType | string | 来源类型：amazon |\n| pageFileUrl | string | 完整页面文件url |\n\n### 嵌套对象\n\n**productDetails** -- 商品详细规格信息：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| asin | string | ASIN编码 |\n| manufacturer | string | 制造商 |\n| productDimensions | string | 商品尺寸 |\n| upc | string | UPC编码 |\n| units | string | 单位 |\n| rating | number | 评分 |\n| review | integer | 评论数 |\n\n**customerReviews** -- 星级评分分布：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| fiveStar | integer | 五星评论数 |\n| fourStar | integer | 四星评论数 |\n| threeStar | integer | 三星评论数 |\n| twoStar | integer | 二星评论数 |\n| oneStar | integer | 一星评论数 |\n\n**variants** -- 商品变体列表（数组）：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| title | string | 变体标题（如颜色、尺寸） |\n| items | array | 变体项列表，每项包含 `name`（名称）、`asin`（ASIN编码）、`position`（位置）、`selected`（是否已选择） |\n\n**itemSpecifications** -- 商品规格（动态键值）。\n\n**itemIngredients** -- 商品成分列表（数组）。\n\n**reviewsImages** -- 评论图片列表（数组）。\n\n### 可选嵌套数组（按需返回）\n\n**boughtTogether**（当 `returnBoughtTogether: true` 时返回）：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| asin | string | ASIN编码 |\n| title | string | 标题 |\n| price | string | 价格 |\n| extractedPrice | number | 提取的价格 |\n| priceUnit | string | 单价 |\n| extractedPriceUnit | number | 提取的单价 |\n| thumbnail | string | 缩略图 |\n| link | string | 链接 |\n| linkClean | string | 纯净链接 |\n| stock | string | 库存状态 |\n| delivery | array | 配送信息 |\n| position | integer | 位置 |\n\n**relatedProducts**（当 `returnRelatedProducts: true` 时返回）：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| asin | string | ASIN编码 |\n| title | string | 标题 |\n| price | string | 价格 |\n| extractedPrice | number | 提取的价格 |\n| oldPrice | string | 原价 |\n| extractedOldPrice | number | 提取的原价 |\n| priceUnit | string | 单价 |\n| extractedPriceUnit | number | 提取的单价 |\n| rating | number | 评分 |\n| reviews | integer | 评论数 |\n| thumbnail | string | 缩略图 |\n| link | string | 链接 |\n| linkClean | string | 纯净链接 |\n| prime | boolean | 是否Prime商品 |\n| sponsored | boolean | 是否赞助商品 |\n| climatePledgeFriendly | boolean | 是否气候友好 |\n| discount | string | 折扣 |\n| badges | array | 徽章列表 |\n| position | integer | 位置 |\n\n**authorsReviews**（当 `returnAuthorsReviews: true` 时返回）：\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| title | string | 标题 |\n| text | string | 评论内容 |\n| author | string | 作者 |\n| authorImage | string | 作者头像 |\n| authorLink | string | 作者链接 |\n| rating | integer | 评分 |\n| date | string | 日期 |\n| verifiedPurchase | boolean | 是否已验证购买 |\n| helpfulVotes | string | 有用投票数 |\n| productSize | string | 商品尺寸 |\n| productFlavorName | string | 商品口味名称 |\n| position | integer | 位置 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n \"errcode\": 401,\n \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/amazon/product/detail \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"asins\": \"B072MQ5BRX,B08N5WRWNW\", \"amazonDomain\": \"amazon.com\"}'\n```\n\n### 包含可选参数\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/amazon/product/detail \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"asins\": \"B072MQ5BRX\",\n \"amazonDomain\": \"amazon.de\",\n \"language\": \"de_DE\",\n \"deliveryZip\": \"10115\",\n \"returnBoughtTogether\": true,\n \"returnAuthorsReviews\": true\n }'\n```\n\nFile v1.2.3:references/linkfox-amazon-reviews-list.md\n\n---\nname: linkfox-amazon-reviews-list\ndescription: 获取并分析亚马逊 15 个站点的商品评论，支持按星级筛选，用于差评拆解、情感分析与产品改良建议。\n---\n\n# 亚马逊商品评论（Amazon Product Reviews）\n\n本技能用于按 ASIN 获取并分析亚马逊商品评论，帮助卖家从买家反馈中提取可落地的洞察。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 按 ASIN 获取亚马逊商品真实买家评论，覆盖 **15 个站点**（含美国站）。\n- 按星级（1-5 星）分别控制抓取数量，每星最多 100 条。\n- 支持按关键词、评论者类型（含仅已验证购买）、媒体类型、格式类型筛选。\n- 按最新或最有用排序。\n- 用于差评拆解、好评挖掘、情感倾向识别与产品改良建议。\n\n### ❌ 边界与限制\n\n- **单次请求仅支持一个 ASIN**；多 ASIN 需分别调用。\n- **每星上限**：每个星级单次最多返回 100 条评论。\n- **无历史快照**：评论为实时抓取，不提供历史版本对比。\n- **评论语言**：评论文本按原始语言返回，不做翻译。\n- **不在范围内**：ABA 搜索词/关键词研究（用 ABA 工具）；销量估算或收入分析；Listing 文案或 A+ 内容创作；广告/PPC 策略；定价或利润计算。\n\n## 核心概念\n\n本工具按给定亚马逊 ASIN 检索真实买家评论，覆盖 **15 个站点**。可按星级（1-5 星，每星最多 100 条）控制抓取数量，按最新或有用量排序，并应用多种筛选条件。单次请求仅支持一个 ASIN；多 ASIN 需分别调用。\n\n## 调用方式\n\n- **API 端点**：`POST /amazon/reviews/list`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/amazon_reviews.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-reviews-list-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 支持站点\n\n| 站点 | 代码 |\n|------|------|\n| 美国 | `com` |\n| 加拿大 | `ca` |\n| 英国 | `co.uk` |\n| 德国 | `de` |\n| 法国 | `fr` |\n| 意大利 | `it` |\n| 西班牙 | `es` |\n| 日本 | `co.jp` |\n| 印度 | `in` |\n| 澳大利亚 | `com.au` |\n| 巴西 | `com.br` |\n| 墨西哥 | `com.mx` |\n| 荷兰 | `nl` |\n| 瑞典 | `se` |\n| 阿联酋 | `ae` |\n\n通过 `domainCode` 指定站点。每次调用前务必与用户确认目标站点。\n\n## 使用示例\n\n**1. 获取美国站评论**\n```json\n{\"asin\": \"B08N5WRWNW\", \"domainCode\": \"com\", \"star1Num\": 10, \"star2Num\": 10, \"star3Num\": 10, \"star4Num\": 10, \"star5Num\": 10, \"sortBy\": \"recent\"}\n```\n\n**2. 按关键词筛选差评（德国站）**\n```json\n{\"asin\": \"B08N5WRWNW\", \"domainCode\": \"de\", \"star1Num\": 30, \"star2Num\": 30, \"filterByKeyword\": \"quality\", \"reviewerType\": \"avp_only_reviews\"}\n```\n\n**3. 获取带图片/视频的 5 星好评（日本站）**\n```json\n{\"asin\": \"B08N5WRWNW\", \"domainCode\": \"co.jp\", \"star5Num\": 50, \"star1Num\": 0, \"star2Num\": 0, \"star3Num\": 0, \"star4Num\": 0, \"sortBy\": \"helpful\", \"mediaType\": \"media_reviews_only\"}\n```\n\n**4. 仅获取 3 星评论（显式星级模式）**\n```json\n{\"asin\": \"B0FP5C63HZ\", \"domainCode\": \"com\", \"star3Num\": 100}\n```\n\n## 展示规则\n\n1. **清晰呈现数据**：按星级分组展示评论，包含评分、标题、正文、日期、是否已验证购买、有用数等关键字段。\n2. **适时总结**：评论较多时，先给出主题/痛点摘要，再列出个体评论。\n3. **突出可落地洞察**：在差评中点出反复出现的投诉；在好评中标注被赞美的卖点。\n4. **Vine 与验证标签**：明确标注 Vine Voice 与已验证购买状态。\n5. **媒体标识**：标注评论是否包含图片或视频。\n6. **字段归一化**：当原始响应使用站点特定的文本格式时，对评分和有用数字段做归一化以保证展示一致。\n7. **错误处理**：查询失败时根据响应信息说明原因，并建议调整参数。\n8. **单 ASIN 限制**：用户询问多个 ASIN 时，分别发起请求。\n\n## 用户表达与场景速查\n\n**适用** —— 涉及亚马逊商品评论的任务：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"看下这个 ASIN 的评论\" | 直接评论查询 |\n| \"获取 B08N5WRWNW 的美国站评论\" | 指定站点查询 |\n| \"买家都在抱怨什么\" | 差评分析 |\n| \"把 1 星评论都拉出来\" | 按星级筛选 |\n| \"差评里有什么共性问题\" | 痛点挖掘 |\n| \"买家喜欢这个产品的什么\" | 好评分析 |\n| \"找提到'电池'的评论\" | 关键词筛选 |\n| \"看带图的评论\" | 媒体筛选 |\n| \"只要已验证购买的评论\" | 评论者类型筛选 |\n| \"帮我分析竞品评论\" | 竞品评论研究 |\n| \"从评论里提炼产品改良建议\" | 可落地洞察提取 |\n\n不适用场景见上方【能力边界】。\n\n**边界判断**：若\"产品调研\"或\"竞品分析\"实质是读取特定 ASIN 的买家评论，则适用本技能；若涉及搜索量、关键词排名、销量估算或市场规模，则不适用。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 亚马逊商品评论 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/amazon/reviews/list`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| asin | string | 是 | 亚马逊商品 ASIN |\n| domainCode | string | 否 | 亚马逊域名代码，默认 `com`。可选值：`com`、`ca`、`co.uk`、`in`、`de`、`fr`、`it`、`es`、`co.jp`、`com.au`、`com.br`、`nl`、`se`、`com.mx`、`ae`。美国站使用 `com` |\n| star1Num | integer | 否 | 1 星评论数量，默认获取 10 条，最多 100 条 |\n| star2Num | integer | 否 | 2 星评论数量，默认获取 10 条，最多 100 条 |\n| star3Num | integer | 否 | 3 星评论数量，默认获取 10 条，最多 100 条 |\n| star4Num | integer | 否 | 4 星评论数量，默认获取 10 条，最多 100 条 |\n| star5Num | integer | 否 | 5 星评论数量，默认获取 10 条，最多 100 条 |\n| filterByKeyword | string | 否 | 按关键词筛选评论，最大长度 1000 字符 |\n| sortBy | string | 否 | 评论排序方式：`recent`（最新评论）或 `helpful`（最有用评论），默认 `recent` |\n| reviewerType | string | 否 | 评论者类型：`all_reviews`（所有评论）或 `avp_only_reviews`（仅已验证购买），默认 `all_reviews` |\n| mediaType | string | 否 | 媒体类型：`all_contents`（所有内容）或 `media_reviews_only`（仅包含媒体的评论），默认 `all_contents` |\n| formatType | string | 否 | 格式类型：`all_formats`（所有格式）或 `current_format`（当前格式），默认 `all_formats` |\n\n说明：若 `star1Num` ~ `star5Num` 均未传，则 1~5 星默认各抓取 `10` 条；若已传任意一个星级数量，则其它未传星级默认 `0`。\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 总评论数 |\n| data | array | 评论列表（详见下方评论对象） |\n| columns | array | 渲染的列 |\n| costToken | integer | 总 Token 消耗 |\n| type | string | 渲染的样式 |\n\n### 评论对象\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| reviewId | string | 评论 ID |\n| asin | string | 产品 ASIN |\n| title | string | 评论标题 |\n| text | string | 评论内容 |\n| rating | string | 评分 |\n| date | string | 评论日期 |\n| userName | string | 评论者名称 |\n| verified | boolean | 是否已验证购买 |\n| vine | boolean | 是否 Vine Voice 评论 |\n| numberOfHelpful | integer | 有用数量 |\n| imageUrlList | array | 评论图片列表 |\n| videoUrlList | array | 评论视频列表 |\n| domainCode | string | 国家代码 |\n| productTitle | string | 产品标题 |\n| productRating | string | 产品评分 |\n| countRatings | integer | 产品评分数量 |\n| countReviews | integer | 产品评论数量 |\n| variationId | string | 变体 ID |\n| variationList | array | 变体列表 |\n| profilePath | string | 评论者个人资料路径 |\n| currentPage | integer | 当前页码 |\n| sortStrategy | string | 排序策略 |\n| statusCode | integer | 状态码 |\n| statusMessage | string | 状态消息 |\n| locale | object | 区域信息 |\n| reviewSummary | object | 评论摘要数据 |\n| filters | object | 已应用的筛选条件 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 其他非 200 值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n \"errcode\": 401,\n \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例（美国站）\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/amazon/reviews/list \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"asin\": \"B08N5WRWNW\",\n \"domainCode\": \"com\",\n \"star1Num\": 10,\n \"star2Num\": 10,\n \"star3Num\": 0,\n \"star4Num\": 0,\n \"star5Num\": 0,\n \"sortBy\": \"recent\",\n \"reviewerType\": \"all_reviews\"\n }'\n```\n\nFile v1.2.3:references/linkfox-amazon-search-by-image.md\n\n---\r\nname: linkfox-amazon-search-by-image\r\ndescription: 支持亚马逊 8 个站点的以图搜图，通过图片 URL 跨站点检索外观相似的商品与同款竞品。\r\n---\r\n\r\n# 亚马逊-以图搜图（Amazon Search by Image）\r\n\r\n本技能用于通过图片 URL 在亚马逊 8 个站点进行视觉商品搜索，帮助亚马逊卖家与调研人员跨站点发现外观相似的商品与同款竞品。参数与响应字段详见 [references/api.md](references/api.md)。\r\n\r\n## 能力边界\r\n\r\n### ✅ 能力范围\r\n\r\n- 通过公开可访问的图片 URL 在亚马逊 8 个站点检索外观相似的商品。\r\n- 返回商品 ASIN、标题、图片、价格、评分、评论数、品牌等核心字段。\r\n- 支持按价格、评分、评论数排序，支持指定站内收货邮编或站外收货国家代码。\r\n- 可选聚合 Keepa 数据（销售排名、月销量、FBA 费用、尺寸等）。\r\n\r\n### ❌ 边界与限制\r\n\r\n- **图片要求**：必须提供公开可访问的图片 URL；本地图片需先上传获取公开链接（见下方「本地图片上传」）。\r\n- **排序限制**：仅支持 `default`、`price-asc-rank`、`price-desc-rank`、`rating-asc-rank`、`rating-desc-rank`、`ratings-asc-rank`、`ratings-desc-rank`；不在列表内的排序不得尝试其他变通方式，应告知用户支持的排序选项。\r\n- **邮编与国家代码互斥**：`deliveryZip`（站内邮编）与 `countryOrAreaCode`（站外国家代码）不能同时指定；印度站不支持站外收货。\r\n- **不在范围内**：基于关键词的文本搜索（用关键词搜索工具）；ABA 搜索词数据分析；评论分析与 Listing 优化；无源图片的销量估算；图片编辑或生成；本地图片文件直接搜索。\r\n\r\n## 核心概念\r\n\r\n亚马逊以图搜图（视觉搜索）允许提交商品图片 URL，返回亚马逊上外观相似的商品列表，适用于竞品分析、找同款、识别仿品与基于外观的市场机会发现。\r\n\r\n**支持站点**：\r\n\r\n| 站点 | 域名 | 默认邮编 |\r\n|------|------|----------|\r\n| 美国 | amazon.com | 10001 |\r\n| 英国 | amazon.co.uk | EC1A 1BB |\r\n| 德国 | amazon.de | 10115 |\r\n| 法国 | amazon.fr | 75001 |\r\n| 意大利 | amazon.it | 00100 |\r\n| 西班牙 | amazon.es | 28001 |\r\n| 日本 | amazon.co.jp | 100-0001 |\r\n| 印度 | amazon.in | 110034 |\r\n\r\n默认站点为 **amazon.com**（美国），用户未指定时使用美国站。\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /amazon/searchByImage`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/amazon_search_by_image.py '' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-search-by-image-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## 本地图片上传\r\n\r\n本工具要求**公开可访问的图片 URL**。若用户提供的是本地图片文件路径（如 `C:\\Users\\...\\photo.png`、`/home/.../image.jpg`），需先上传以获取公开链接。\r\n\r\n运行上传脚本：\r\n```bash\r\npython scripts/upload_image.py /path/to/local/image.png\r\n```\r\n\r\n脚本会返回一个公开 URL（有效期 24 小时），可用作 `imageUrl` 参数。\r\n\r\n## 使用示例\r\n\r\n**1. 美国站基础图片搜索**\r\n```\r\n用这张图在亚马逊美国站找外观相似的商品：\r\nhttps://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg\r\n```\r\n\r\n**2. 指定站点找同款**\r\n```\r\n在亚马逊德国站（amazon.de）用这张图找外观相似的商品：\r\nhttps://example.com/product-photo.jpg\r\n```\r\n\r\n**3. 按价格从低到高排序**\r\n```\r\n在亚马逊美国站用这张图找相似商品，按价格从低到高排序：\r\nhttps://example.com/my-product.jpg\r\n```\r\n\r\n**4. 聚合 Keepa 数据**\r\n```\r\n在亚马逊美国站用这张图找相似商品，并包含 Keepa 销售数据：\r\nhttps://example.com/competitor-product.jpg\r\n```\r\n\r\n**5. 站外收货搜索**\r\n```\r\n在亚马逊日本站用这张图找相似商品，收货地址设为中国：\r\nhttps://example.com/item.jpg\r\n```\r\n\r\n**6. 竞品同款发现**\r\n```\r\n我在竞品 listing 上看到这张产品图，在亚马逊英国站帮我找所有外观相似的商品：\r\nhttps://example.com/competitor.jpg\r\n```\r\n\r\n## 展示规则\r\n\r\n1. **清晰呈现数据**：以结构化表格展示搜索结果，优先列：商品图片、标题、ASIN、价格、评分、评论数、品牌。\r\n2. **图片展示**：响应中含 `imageUrl` 时内联展示，便于直观对比。\r\n3. **价格与币种**：价格始终带币种代码（如 $29.99 USD、24.99 EUR）。\r\n4. **Keepa 数据**：启用 `aggregateByKeepaData` 且存在 Keepa 字段时，在展开区或附加列展示月销量、销售排名、FBA 费用等补充数据。\r\n5. **结果总数**：始终告知用户找到的结果总数（`total` / `totalCount`）。\r\n6. **错误处理**：查询失败时说明原因，并建议检查图片 URL 是否有效且公开可访问。\r\n7. **排序限制**：用户请求的排序不在支持列表内时，明确说明可用的排序选项，不尝试未支持的变通方式。\r\n8. **不做二次处理**：本工具结果不入库，无法进行二次 SQL 处理。\r\n\r\n## 用户表达与场景速查\r\n\r\n**适用** —— 亚马逊视觉商品搜索场景：\r\n\r\n| 用户说 | 场景 |\r\n|--------|------|\r\n| \"用这张图找相似商品\" | 基础图片搜索 |\r\n| \"以图搜图\"、\"亚马逊反向图片搜索\" | 视觉搜索 |\r\n| \"找竞品同款\"、\"找同款商品\" | 按外观做竞品分析 |\r\n| \"亚马逊上有什么商品长得像这个\" | 商品发现 |\r\n| \"找长得一样但更便宜的替代品\" | 基于价格的视觉对比 |\r\n| \"在亚马逊日/德/英站用这张产品图搜\" | 跨站点视觉搜索 |\r\n| \"看下相似商品的 Keepa 数据\" | 聚合数据的视觉搜索 |\r\n| \"用这张照片找相似商品，按评分排序\" | 排序视觉搜索 |\r\n\r\n不适用场景见上方【能力边界】。\r\n\r\n**边界判断**：当用户说\"找相似商品\"或\"竞品分析\"时，若提供了图片 URL 且意图是找外观相似的亚马逊商品，则适用本技能；若是要基于关键词的搜索、销量数据分析或无图片的商品调研，则不适用。\r\n\r\n## 解决认证和积分问题\r\n\r\n发生以下异常情况时，采用以下措施来处理：\r\n\r\n### 异常情况\r\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\r\n- **响应 401 或 402 状态码**\r\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\r\n\r\n### 措施\r\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\r\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\r\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\r\n\r\n---\r\n\r\n# 亚马逊-以图搜图 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/amazon/searchByImage`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| imageUrl | string | 是 | 图片URL地址，请确保图片URL地址有效。最大长度：1000 |\r\n| amazonDomain | string | 是 | 亚马逊站点，仅支持以下站点：美国(`amazon.com`)、英国(`amazon.co.uk`)、德国(`amazon.de`)、法国(`amazon.fr`)、意大利(`amazon.it`)、西班牙(`amazon.es`)、日本(`amazon.co.jp`)、印度(`amazon.in`)。默认 `amazon.com` |\r\n| sort | string | 否 | 排序，支持价格、评分、评论数排序。可选值：`default`（默认）、`price-asc-rank`（价格从低到高）、`price-desc-rank`（价格从高到低）、`rating-asc-rank`（评分从低到高）、`rating-desc-rank`（评分从高到低）、`ratings-asc-rank`（评论数从低到高）、`ratings-desc-rank`（评论数从高到低） |\r\n| deliveryZip | string | 否 | 站内收货地址邮编或城市，如果用户未指定，则取站点（国家）的默认邮编。最大长度：1000。各站点默认邮编：美国=10001、英国=EC1A 1BB、德国=10115、法国=75001、意大利=00100、西班牙=28001、日本=100-0001、印度=110034 |\r\n| countryOrAreaCode | string | 否 | 站外收货的国家代码（如 CN、JP、KR、TW、HK、MO、SG、TH、VN、PH、MY）。站内邮编地址和站外国家地区代码不能同时指定。注意：印度站不支持设置站外国家或地区收货。最大长度：1000 |\r\n| aggregateByKeepaData | boolean | 否 | 是否聚合Keepa数据（销售排名、月销量、FBA费用、尺寸等） |\r\n\r\n\r\n## 响应结构\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总行数 |\r\n| totalCount | integer | 总数量 |\r\n| perPage | integer | 每页数量 |\r\n| currentPage | integer | 当前页码 |\r\n| type | string | 渲染的样式 |\r\n| sourceType | string | 来源类型 |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗token |\r\n| products | array | 商品列表（详见下方商品字段） |\r\n\r\n### 商品字段\r\n\r\n每个商品返回的核心字段：\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| asin | string | ASIN |\r\n| title | string | 商品标题 |\r\n| imageUrl | string | 图片URL（请求地址） |\r\n| asinUrl | string | 亚马逊ASIN的详情网址 |\r\n| price | number | 当前价格（单位：元，如美元/欧元等） |\r\n| oldPrice | number | 划线价格 |\r\n| currency | string | 币种 |\r\n| rating | number | 当前评分（0.0-5.0，如4.5星） |\r\n| ratings | integer | 评分数量 |\r\n| brand | string | 品牌 |\r\n| sourceTool | string | 来源工具 |\r\n| sourceType | string | 来源类型 |\r\n\r\nKeepa 聚合字段（当 `aggregateByKeepaData` 为 true 时返回）：\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| salesRank | integer | 销售排名(keepa) |\r\n| salesRank30 | integer | 近30天平均销售排名(keepa) |\r\n| salesRank90 | integer | 近90天平均销售排名(keepa) |\r\n| salesRank180 | integer | 近180天平均销售排名(keepa) |\r\n| monthlySalesUnits | integer | 月销量(keepa) |\r\n| monthlySalesRevenue | number | 月销售额(keepa) |\r\n| monthlySalesUnits1MonthAgo ~ monthlySalesUnits12MonthsAgo | integer | 1~12月前月销量(keepa) |\r\n| reviewCount | integer | 评论数量(keepa) |\r\n| fbaFees | number | FBA配送费(keepa)（单位：元） |\r\n| profit | number | 利润率(keepa)（利润率百分比，如25.5表示25.5%） |\r\n| referralFeePercentage | number | 推荐费百分比(keepa) |\r\n| fulfillment | string | 配送方式(AMZ, FBA, FBM)(keepa) |\r\n| primePrice | number | Prime价格(keepa) |\r\n| buyBoxSellerId | string | 购买按钮卖家ID(keepa) |\r\n| sellerNum | integer | 卖家数(keepa) |\r\n| variationNum | integer | 变体数量(keepa) |\r\n| parentAsin | string | 父ASIN(keepa) |\r\n| availableDate | string | 上架时间(keepa)（yyyy-MM-dd HH:mm:ss） |\r\n| lastUpdate | string | 最后更新时间(keepa)（yyyy-MM-dd HH:mm:ss） |\r\n| manufacturer | string | 制造商(keepa) |\r\n| model | string | 型号(keepa) |\r\n| color | string | 颜色(keepa) |\r\n| material | string | 产品的材质(keepa)，指其构造中使用的主要材料 |\r\n| weight | string | 重量（克）(keepa) |\r\n| dimension | string | 尺寸(keepa) |\r\n| itemLength | integer | 商品长度(keepa)，单位为毫米，不可用时为0或-1 |\r\n| itemWidth | integer | 商品宽度(keepa)，单位为毫米，不可用时为0或-1 |\r\n| itemHeight | integer | 商品高度(keepa)，单位为毫米，不可用时为0或-1 |\r\n| packageLength | integer | 包装长度（毫米）(keepa) |\r\n| packageWidth | integer | 包装宽度（毫米）(keepa) |\r\n| packageHeight | integer | 包装高度（毫米）(keepa) |\r\n| packageWeight | string | 包装重量（克）(keepa) |\r\n| packageDimensions | string | 包装尺寸(keepa) |\r\n| packageQuantity | integer | 包装中商品的数量(keepa)，不可用时为0或-1 |\r\n| dimensionsType | string | 尺寸类型(keepa) |\r\n| categoryTree | string | 类目树(keepa) |\r\n| categoryTreeId | string | 类目树ID(keepa) |\r\n| rootCategory | integer | 根类目ID(keepa) |\r\n| isAdultProduct | boolean | 是否为成人产品(keepa) |\r\n| isHazmat | boolean | 是否为危险品(keepa) |\r\n| urlSlug | string | URL Slug(keepa) |\r\n| productImageUrls | array | 商品图片列表(keepa) |\r\n\r\n## 错误码\r\n\r\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\r\n\r\n| errcode | 含义 | 处理建议 |\r\n|---------|------|----------|\r\n| 200 | 成功 | 正常解析业务字段 |\r\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\r\n\r\n错误响应示例：\r\n\r\n```json\r\n{\r\n \"errcode\": 401,\r\n \"errmsg\": \"authorized error\"\r\n}\r\n```\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/amazon/searchByImage \\\r\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\r\n \"imageUrl\": \"https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg\",\r\n \"amazonDomain\": \"amazon.com\",\r\n \"sort\": \"default\"\r\n }'\r\n```\r\n\r\n### 聚合 Keepa 数据示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/amazon/searchByImage \\\r\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\r\n \"imageUrl\": \"https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg\",\r\n \"amazonDomain\": \"amazon.com\",\r\n \"sort\": \"price-asc-rank\",\r\n \"aggregateByKeepaData\": true\r\n }'\r\n```\r\n\r\n### 站外收货示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/amazon/searchByImage \\\r\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\r\n \"imageUrl\": \"https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg\",\r\n \"amazonDomain\": \"amazon.co.jp\",\r\n \"countryOrAreaCode\": \"CN\"\r\n }'\r\n```\n\nFile v1.2.3:references/linkfox-amazon-search.md\n\n---\r\nname: linkfox-amazon-search\r\ndescription: 模拟亚马逊前台搜索，实时抓取关键词搜索结果页（SERP）数据，用于查询商品排名、价格对比和竞品监控。\r\n---\r\n\r\n# 亚马逊前端商品搜索（Amazon Product Search）\r\n\r\n本技能模拟真实用户在亚马逊前台搜索，实时抓取关键词搜索结果页（SERP）数据，包括商品排位、价格、评分、评论数、品牌、配送信息、广告标识等。参数与响应字段详见 [references/api.md](references/api.md)。\r\n\r\n## 能力边界\r\n\r\n### ✅ 能力范围\r\n\r\n- 模拟亚马逊前台搜索，获取实时的搜索结果页（SERP）数据：商品列表及其排位、价格、评分、评论数、品牌、配送信息、广告标识等。\r\n- 支持多站点（amazon.com、amazon.de、amazon.co.jp 等）、多设备（desktop/mobile/tablet）、类目范围、邮编模拟、多语言。\r\n- 适用于竞品发现、关键词排位查询、价格对比、广告商品分析、新品监控。\r\n\r\n### ❌ 边界与限制\r\n\r\n- **仅实时数据**：返回的是当前真实搜索结果，非历史聚合数据。历史搜索词分析、搜索量趋势请用 ABA 数据。\r\n- **关键词语言**：关键词须用目标站点对应语言（amazon.com 用英语、amazon.de 用德语、amazon.co.jp 用日语等）。\r\n- **每页约 20 条**：每次请求返回约 20 个商品列表。\r\n- **调用频率**：每次调用即模拟一次真实搜索请求，避免密集连续调用。\r\n- **不在范围内**：广告投放管理与出价优化；评论分析与情感分析；销量预估与营收分析；Listing 优化与文案建议；库存与供应链数据。\r\n\r\n## 核心概念\r\n\r\n本工具模拟真实用户在亚马逊前台搜索，返回实时的搜索结果页（SERP）数据：商品列表及其排位、价格、评分、评论数、品牌、配送信息、广告标识等。这是直接来自亚马逊前端的**实时**数据，而非历史分析。\r\n\r\n**与 ABA 数据的区别**：ABA 数据是聚合的历史搜索词分析；本工具返回的是用户此刻在亚马逊上搜索某关键词时实际看到的商品列表。\r\n\r\n**关键词语言**：关键词须用目标站点对应语言。例如 amazon.com 用英语，amazon.de 用德语，amazon.co.jp 用日语。\r\n\r\n## 调用方式\r\n\r\n- **API 端点**：`POST /amazon/search`（完整参数/响应/错误码见 `references/api.md`）\r\n- **Python 脚本**：`python scripts/amazon_search.py '' [--inline]`\r\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\r\n\r\n**输出策略（脚本默认行为）**：\r\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-search-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\r\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\r\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\r\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\r\n\r\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\r\n\r\n## 使用示例\r\n\r\n**1. 美国站基础关键词搜索**\r\n> \"搜一下亚马逊上 wireless earbuds\"\r\n```json\r\n{\"keyword\": \"wireless earbuds\", \"amazonDomain\": \"amazon.com\"}\r\n```\r\n\r\n**2. 德国站德语关键词搜索**\r\n> \"在德国站搜 kabellose Kopfhörer\"\r\n```json\r\n{\"keyword\": \"kabellose Kopfhoerer\", \"amazonDomain\": \"amazon.de\", \"language\": \"de_DE\"}\r\n```\r\n\r\n**3. 按价格从低到高排序**\r\n> \"亚马逊上 phone case 按价格从低到高排\"\r\n```json\r\n{\"keyword\": \"phone case\", \"amazonDomain\": \"amazon.com\", \"sort\": \"price-asc-rank\"}\r\n```\r\n\r\n**4. 查某类目下的畅销商品**\r\n> \"亚马逊上 yoga mat 的畅销商品有哪些？\"\r\n```json\r\n{\"keyword\": \"yoga mat\", \"amazonDomain\": \"amazon.com\", \"sort\": \"exact-aware-popularity-rank\"}\r\n```\r\n\r\n**5. 日本站最新上架**\r\n> \"日本站 USB充電器 最新上架的商品\"\r\n```json\r\n{\"keyword\": \"USB充電器\", \"amazonDomain\": \"amazon.co.jp\", \"language\": \"ja_JP\", \"sort\": \"date-desc-rank\"}\r\n```\r\n\r\n**6. 多页搜索分析更深结果**\r\n> \"laptop stand 第二页结果\"\r\n```json\r\n{\"keyword\": \"laptop stand\", \"amazonDomain\": \"amazon.com\", \"page\": 2}\r\n```\r\n\r\n**7. 移动端搜索模拟**\r\n> \"running shoes 在手机端的亚马逊搜索结果\"\r\n```json\r\n{\"keyword\": \"running shoes\", \"amazonDomain\": \"amazon.com\", \"device\": \"mobile\"}\r\n```\r\n\r\n**8. 类目范围并指定配送邮编**\r\n> \"office chair 配送到纽约 10001 的搜索结果\"\r\n```json\r\n{\"keyword\": \"office chair\", \"amazonDomain\": \"amazon.com\", \"deliveryZip\": \"10001\"}\r\n```\r\n\r\n## 展示规则\r\n\r\n1. **清晰呈现数据**：以结构化表格展示搜索结果关键字段——排位、ASIN、标题、价格、评分、评论数、品牌。\r\n2. **突出广告商品**：明确标注哪些是赞助商广告结果，哪些是自然结果。\r\n3. **价格格式**：按站点币种显示价格，带正确货币符号。\r\n4. **排位语境**：提醒用户排位反映的是搜索结果页上的实际排名。\r\n5. **分页提示**：结果跨多页时告知总条数，并建议按需继续翻页。\r\n6. **错误处理**：查询失败时根据错误响应说明原因，并建议调整参数。\r\n7. **图片链接**：如有图片 URL，可提及但不内联渲染，除非用户要求。\r\n\r\n## 用户表达与场景速查\r\n\r\n**适用** —— 实时亚马逊搜索结果查询：\r\n\r\n| 用户说 | 场景 |\r\n|--------|------|\r\n| \"在亚马逊上搜 XX\" | 基础商品搜索 |\r\n| \"关键词 XX 下会出现哪些商品\" | 关键词 SERP 分析 |\r\n| \"我的 ASIN 在 XX 关键词下排第几\" | 排位/排名查询 |\r\n| \"看看 XX 关键词的顶部结果\" | 竞争格局 |\r\n| \"XX 的价格区间是多少\" | 价格对比 |\r\n| \"XX 关键词下有赞助商商品吗\" | 广告商品分析 |\r\n| \"XX 关键词的新品\" | 新品监控 |\r\n| \"在亚马逊德国/日本/英国站搜 XX\" | 跨站点搜索 |\r\n| \"XX 关键词下哪些是畅销品\" | 畅销品发现 |\r\n| \"对比移动端和 PC 端搜索结果\" | 设备差异 SERP |\r\n\r\n不适用场景见上方【能力边界】。\r\n\r\n## 解决认证和积分问题\r\n\r\n发生以下异常情况时，采用以下措施来处理：\r\n\r\n### 异常情况\r\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\r\n- **响应 401 或 402 状态码**\r\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\r\n\r\n### 措施\r\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\r\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\r\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\r\n\r\n---\r\n\r\n# 亚马逊前端搜索模拟 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/amazon/search`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| keyword | string | 否 | 关键词；请尽量翻译为对应国家的语言，比如美国用英语关键词，德国用德语关键词等等（最大长度1024） |\r\n| amazonDomain | string | 否 | 亚马逊各个国家站点，默认 `amazon.com` |\r\n| node | string | 否 | 亚马逊类目节点（最大长度1000） |\r\n| language | string | 否 | 语言区域代码，如 en_US、de_DE、ja_JP、fr_FR（最大长度1000） |\r\n| sort | string | 否 | 排序方式：`relevanceblender`（精选，默认）、`price-asc-rank`（价格从低到高）、`price-desc-rank`（价格从高到低）、`review-rank`（平均客户评价）、`date-desc-rank`（最新到货）、`exact-aware-popularity-rank`（畅销商品） |\r\n| page | integer | 否 | 页码（从1开始，每页大概20条），默认 `1` |\r\n| deliveryZip | string | 否 | 配送地邮编，用于模拟亚马逊前台地址，建议使用目标国家主要城市的常用邮编，如美国站常用纽约邮编 10001（最大长度1000） |\r\n| device | string | 否 | 设备类型：`desktop`、`mobile`、`tablet`，默认 `desktop`（最大长度1000） |\r\n\r\n### 支持的 amazonDomain 值\r\n\r\n| 域名 | 国家 |\r\n|------|------|\r\n| amazon.com | 美国 |\r\n| amazon.co.uk | 英国 |\r\n| amazon.de | 德国 |\r\n| amazon.fr | 法国 |\r\n| amazon.it | 意大利 |\r\n| amazon.es | 西班牙 |\r\n| amazon.co.jp | 日本 |\r\n| amazon.ca | 加拿大 |\r\n| amazon.com.au | 澳大利亚 |\r\n| amazon.com.br | 巴西 |\r\n| amazon.in | 印度 |\r\n| amazon.nl | 荷兰 |\r\n| amazon.se | 瑞典 |\r\n| amazon.pl | 波兰 |\r\n| amazon.sg | 新加坡 |\r\n| amazon.sa | 沙特阿拉伯 |\r\n| amazon.ae | 阿联酋 |\r\n| amazon.com.mx | 墨西哥 |\r\n| amazon.com.tr | 土耳其 |\r\n| amazon.com.be | 比利时 |\r\n| amazon.cn | 中国 |\r\n| amazon.eg | 埃及 |\r\n\r\n### 常用 language 值\r\n\r\n| 区域代码 | 说明 |\r\n|----------|------|\r\n| en_US | 美国站 英语 |\r\n| en_GB | 英国站 英语 |\r\n| de_DE | 德国站 德语 |\r\n| fr_FR | 法国站 法语 |\r\n| it_IT | 意大利站 意大利语 |\r\n| es_ES | 西班牙站 西班牙语 |\r\n| ja_JP | 日本站 日语 |\r\n| en_CA | 加拿大站 英语 |\r\n| fr_CA | 加拿大站 法语 |\r\n| en_AU | 澳大利亚站 英语 |\r\n| pt_BR | 巴西站 葡萄牙语 |\r\n| en_IN | 印度站 英语 |\r\n| hi_IN | 印度站 印地语 |\r\n| nl_NL | 荷兰站 荷兰语 |\r\n| sv_SE | 瑞典站 瑞典语 |\r\n| pl_PL | 波兰站 波兰语 |\r\n| en_SG | 新加坡站 英语 |\r\n| ar_AE | 阿联酋/沙特阿拉伯/埃及站 阿拉伯语 |\r\n| en_AE | 阿联酋/沙特阿拉伯/埃及站 英语 |\r\n| tr_TR | 土耳其站 土耳其语 |\r\n| nl_BE | 比利时站 荷兰语 |\r\n| fr_BE | 比利时站 法语 |\r\n| zh_CN | 中国站 中文 |\r\n| pt_MX | 墨西哥站 西班牙语 |\r\n\r\n### 常用 deliveryZip 值\r\n\r\n| 国家 | 城市 | 邮编 |\r\n|------|------|------|\r\n| 美国 | 纽约 | 10001 |\r\n| 英国 | 伦敦 | EC1A 1BB |\r\n| 德国 | 柏林 | 10115 |\r\n| 法国 | 巴黎 | 75001 |\r\n| 意大利 | 罗马 | 00100 |\r\n| 西班牙 | 马德里 | 28001 |\r\n| 日本 | 东京 | 100-0001 |\r\n| 加拿大 | 多伦多 | M5A 1A1 |\r\n| 澳大利亚 | 悉尼 | 2000 |\r\n| 巴西 | 圣保罗 | 01000-000 |\r\n| 印度 | 新德里 | 110001 |\r\n| 荷兰 | 阿姆斯特丹 | 1012 |\r\n| 瑞典 | 斯德哥尔摩 | 111 22 |\r\n| 波兰 | 华沙 | 00-001 |\r\n| 新加坡 | 新加坡 | 018989 |\r\n| 沙特阿拉伯 | 利雅得 | 11564 |\r\n| 阿联酋 | 阿布扎比 | 00000 |\r\n| 墨西哥 | 墨西哥城 | 01000 |\r\n| 土耳其 | 伊斯坦布尔 | 34349 |\r\n| 比利时 | 布鲁塞尔 | 1000 |\r\n| 中国 | 北京 | 100000 |\r\n| 埃及 | 开罗 | 11511 |\r\n\r\n## 响应结构\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 总行数 |\r\n| keyword | string | 搜索关键词 |\r\n| type | string | 渲染的样式 |\r\n| columns | array | 渲染的列定义 |\r\n| costToken | integer | 消耗token |\r\n| products | array | 搜索结果列表（详见下方） |\r\n\r\n### products 商品对象字段\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| asin | string | ASIN |\r\n| title | string | 标题 |\r\n| brand | string | 品牌 |\r\n| price | number | 价格 |\r\n| extractedPrice | number | 解析后的价格 |\r\n| oldPrice | number | 划线价格 |\r\n| extractedOldPrice | number | 解析后的划线价格 |\r\n| currency | string | 币种 |\r\n| priceUnit | string | 价格单位 |\r\n| extractedPriceUnit | number | 解析后的价格单位 |\r\n| rating | number | 评分 |\r\n| ratings | integer | 评分数 |\r\n| position | integer | 位置 |\r\n| sponsored | boolean | 是否赞助商 |\r\n| imageUrl | string | 缩略图 |\r\n| asinUrl | string | 链接 |\r\n| delivery | string | 配送信息 |\r\n| fulfillment | string | 配送信息（如 FBA） |\r\n| availableDate | string (date) | 上架时间 |\r\n| monthlySalesUnits | integer | 月销量 |\r\n| monthlySalesRevenue | string | 月销售额 |\r\n| sellerNation | string | 卖家国籍 |\r\n| dimension | string | 尺寸 |\r\n| weight | string | 重量 |\r\n| options | string | 选项 |\r\n| offers | string | 优惠信息 |\r\n| badges | string | 亚马逊前台搜索标识 |\r\n| tags | string | 标签 |\r\n| snapEbtEligible | boolean | SNAP/EBT资格 |\r\n| sourceType | string | 来源类型：amazon |\r\n| sourceTool | string | 来源工具 |\r\n| keyword | string | 关键词 |\r\n\r\n## 错误码\r\n\r\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 `errcode` 字段区分（`errcode = 200` 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 `errcode` 也是 401。\r\n\r\n| errcode | 含义 | 处理建议 |\r\n|---------|------|----------|\r\n| 200 | 成功 | 正常解析业务字段 |\r\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\r\n\r\n错误响应示例：\r\n\r\n```json\r\n{\r\n \"errcode\": 401,\r\n \"errmsg\": \"authorized error\"\r\n}\r\n```\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/amazon/search \\\r\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\"keyword\": \"wireless earbuds\", \"amazonDomain\": \"amazon.com\", \"page\": 1}'\r\n```\n\nFile v1.2.3:references/linkfox-jiimore-get-niche-info-by-keyword.md\n\n---\nname: linkfox-jiimore-get-niche-info-by-keyword\ndescription: 通过关键词深度评估亚马逊细分市场的竞争格局，包括行业垄断度、品牌集中度、新品成功率及市场机会评分。\n---\n\n# Jiimore 关键词细分市场（Niche Info by Keyword）\n\n本技能用于按关键词查询并分析亚马逊细分市场数据，帮助卖家评估细分市场的竞争强度、品牌成熟度、价格结构与入场机会。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 按关键词查询亚马逊细分市场，返回搜索量、销量、点击率、品牌数量、头部品牌集中度、新品成功率、CPC 预估及综合需求得分等多维分析数据。\n- 支持按商品数量、价格、搜索量、销量、点击量、转化率、品牌指标、卖家指标、广告竞争、新品与退货等多维条件筛选与排序。\n- 覆盖 **US**、**JP**、**DE** 三个站点。\n\n### ❌ 边界与限制\n\n- **站点限制**：仅支持 US、JP、DE，其他国家编码会被拒绝。\n- **关键词必填**：每次查询必须包含 `keyword`，且应使用目标站点语言（US 用英文、JP 用日文、DE 用德文）；用户提供其他语言时需先翻译再调用。\n- **分页上限**：每页最多返回 100 条。\n- **百分比值域**：所有比率/份额参数使用 0-1 区间（非 0-100），构造筛选时需注意取值。\n- **不在范围内**：单个 ASIN 表现或销量预估；搜索词排名趋势（用 ABA 数据工具）；广告投放管理与竞价优化；商品评论分析与 Listing 优化；货源采购与物流规划。\n\n## 核心概念\n\n**细分市场（niche）**是亚马逊上共享同一关键词主题的商品集合。本工具为每个细分市场返回搜索量、销量、点击率、品牌数量、头部品牌集中度、新品成功率、CPC 预估及综合需求得分等丰富分析维度。\n\n- **关键词必填**：每次查询必须包含 `keyword`，并使用目标站点语言。用户提供其他语言时，先翻译为目标站点语言再调用。\n- **百分比字段**：部分参数与响应字段使用 0-1 小数表示 0%-100%；展示给用户时换算为百分比（如 0.35 -> 35%）。\n- **需求得分**：`demand` 字段是每个细分市场的综合机会评分，数值越高表示市场需求潜力越大。\n\n## 调用方式\n\n- **API 端点**：`POST /jiimore/getNicheInfoByKeyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/jiimore_get_niche_info_by_keyword.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-jiimore-get-niche-info-by-keyword-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 基础细分市场探索**\n查询美国市场与 \"wireless earbuds\" 相关的细分市场，按周销量排序：\n```json\n{\n \"keyword\": \"wireless earbuds\",\n \"countryCode\": \"US\",\n \"sortField\": \"unitsSoldT7\",\n \"sortType\": \"desc\"\n}\n```\n\n**2. 低竞争细分市场发现**\n查找 \"yoga mat\" 下前 5 品牌点击份额低于 50%、品牌数超过 20 的细分市场：\n```json\n{\n \"keyword\": \"yoga mat\",\n \"countryCode\": \"US\",\n \"top5BrandsClickShareMax\": 0.5,\n \"brandCountMin\": 20,\n \"sortField\": \"demand\",\n \"sortType\": \"desc\"\n}\n```\n\n**3. 高需求高转化细分市场**\n查找 \"phone case\" 下周搜索量大于 10000、点击转化率高于 10% 的细分市场：\n```json\n{\n \"keyword\": \"phone case\",\n \"countryCode\": \"US\",\n \"searchVolumeT7Min\": 10000,\n \"clickConversionRateT7Min\": 0.1,\n \"sortField\": \"searchVolumeT7\",\n \"sortType\": \"desc\"\n}\n```\n\n**4. 新品机会分析**\n查找 \"LED light\" 下新品成功率高于 20%、退货率低于 5% 的细分市场：\n```json\n{\n \"keyword\": \"LED light\",\n \"countryCode\": \"US\",\n \"launchRateT180Min\": 0.2,\n \"returnRateT360Max\": 0.05,\n \"sortField\": \"launchRateT180\",\n \"sortType\": \"desc\"\n}\n```\n\n**5. 日本市场细分调研**\n探索日本市场与耳机相关的细分市场，按需求得分排序：\n```json\n{\n \"keyword\": \"ヘッドホン\",\n \"countryCode\": \"JP\",\n \"sortField\": \"demand\",\n \"sortType\": \"desc\"\n}\n```\n\n**6. 价格区间细分分析**\n查找 \"backpack\" 下均价在 20-50 美元、广告饱和度较低的细分市场：\n```json\n{\n \"keyword\": \"backpack\",\n \"countryCode\": \"US\",\n \"avgPriceMin\": 20,\n \"avgPriceMax\": 50,\n \"sponsoredProductsPercentageMax\": 0.3,\n \"sortField\": \"unitsSoldT7\",\n \"sortType\": \"desc\"\n}\n```\n\n## 展示规则\n\n1. **清晰呈现数据**：以结构化表格展示结果，将小数比率换算为百分比（如 0.25 -> 25%）。\n2. **突出关键指标**：将细分市场标题、需求得分、周搜索量、周销量、品牌数量、前 5 品牌点击份额作为主列展示。\n3. **翻译细分市场标题**：当 `translationZh` 字段存在且用户偏好中文时，与原 `nicheTitle` 并列展示。\n4. **分页提示**：`total` 超出当前页大小时，告知总数并建议是否继续翻页。\n5. **错误处理**：查询失败时根据响应消息说明原因，并建议调整筛选条件（如放宽区间、检查关键词）。\n6. **CPC 展示**：存在 CPC 数据时，同时展示低、中、高三档，给出完整广告成本图景。\n7. **不做主观建议**：客观呈现数据，不主动附加商业建议；仅在用户明确要求解读时才提供。\n\n## 用户表达与场景速查\n\n**适用** —— 按关键词的细分市场级市场调研：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"XX 市场有没有机会\" | 细分市场机会评估 |\n| \"XX 关键词竞争有多激烈\" | 垄断/品牌集中度 |\n| \"给 XX 找低竞争细分市场\" | 蓝海细分市场发现 |\n| \"XX 的新品成功率是多少\" | 新入场可行性 |\n| \"看下 XX 的细分市场数据\" | 通用细分市场探索 |\n| \"XX 哪些细分市场需求高\" | 需求驱动细分市场排名 |\n| \"XX 细分市场的 CPC/广告成本\" | 广告成本分析 |\n| \"找 XX 高转化的细分市场\" | 转化导向细分市场 |\n| \"XX 市场的品牌集中度\" | 品牌主导度评估 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 极目-亚马逊-细分市场信息 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/jiimore/getNicheInfoByKeyword`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n### 必填参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| keyword | string | 是 | 关键词（必填，并根据所选国家，翻译关键词为对应国家的语言），最大长度1000字符 |\n\n### 站点与分页\n\n| 参数 | 类型 | 必填 | 默认值 | 说明 |\n|------|------|------|--------|------|\n| countryCode | string | 否 | US | 国家编码，可选值：`US`（美国）、`JP`（日本）、`DE`（德国） |\n| page | integer | 否 | 1 | 页码（从1开始） |\n| pageSize | integer | 否 | 50 | 每页返回数量（10-100） |\n| sortField | string | 否 | unitsSoldT7 | 排序字段（见下方排序选项） |\n| sortType | string | 否 | desc | 排序方式：`desc`（降序）或 `asc`（升序） |\n\n### 筛选参数（均为可选）\n\n**商品与价格**：\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| productCountMin | integer | 商品数量（当前）最小值 |\n| productCountMax | integer | 商品数量（当前）最大值 |\n| avgPriceMin | number | 平均价格（当前）最小值 |\n| avgPriceMax | number | 平均价格（当前）最大值 |\n\n**搜索与销售（7天统计）**：\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| searchVolumeT7Min | integer | 搜索量（7天统计）最小值 |\n| searchVolumeT7Max | integer | 搜索量（7天统计）最大值 |\n| unitsSoldT7Min | integer | 销售量（7天统计）最小值 |\n| unitsSoldT7Max | integer | 销售量（7天统计）最大值 |\n| clickCountT7Min | integer | 点击量（7天统计）最小值 |\n| clickCountT7Max | integer | 点击量（7天统计）最大值 |\n| clickConversionRateT7Min | number | 点击转换率（7天统计）最小值，数值范围为0-1，代表0%-100% |\n| clickConversionRateT7Max | number | 点击转换率（7天统计）最大值，数值范围为0-1，代表0%-100% |\n\n**品牌指标**：\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| brandCountMin | integer | 品牌数量最小值 |\n| brandCountMax | integer | 品牌数量最大值 |\n| top5BrandsClickShareMin | number | 前5个品牌所占细分市场的点击量份额最小值，数值范围为0-1，代表0%-100% |\n| top5BrandsClickShareMax | number | 前5个品牌所占细分市场的点击量份额最大值，数值范围为0-1，代表0%-100% |\n| avgBrandAgeMin | number | 平均品牌年龄（当前）最小值 |\n| avgBrandAgeMax | number | 平均品牌年龄（当前）最大值 |\n| avgBrandAgeQoqMin | number | 平均品牌年龄（90天统计）最小值 |\n| avgBrandAgeQoqMax | number | 平均品牌年龄（90天统计）最大值 |\n| avgBrandAgeYoyMin | number | 平均品牌年龄（360天统计）最小值 |\n| avgBrandAgeYoyMax | number | 平均品牌年龄（360天统计）最大值 |\n\n**卖家指标**：\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| avgSellingPartnerAgeMin | number | 平均销售伙伴年龄最小值 |\n| avgSellingPartnerAgeMax | number | 平均销售伙伴年龄最大值 |\n| avgSellingPartnerAgeQoqMin | number | 平均销售伙伴年龄（90天统计）最小值 |\n| avgSellingPartnerAgeQoqMax | number | 平均销售伙伴年龄（90天统计）最大值 |\n| avgSellingPartnerAgeYoyMin | number | 平均销售伙伴年龄（360天统计）最小值 |\n| avgSellingPartnerAgeYoyMax | number | 平均销售伙伴年龄（360天统计）最大值 |\n\n**竞争与广告**：\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| top5ProductsClickShareMin | number | 排名前5位的商品点击份额（当前）最小值，数值范围为0-1，代表0%-100% |\n| top5ProductsClickShareMax | number | 排名前5位的商品点击份额（当前）最大值，数值范围为0-1，代表0%-100% |\n| sponsoredProductsPercentageMin | number | SP广告占比最小值，数值范围为0-1，代表0%-100% |\n| sponsoredProductsPercentageMax | number | SP广告占比最大值，数值范围为0-1，代表0%-100% |\n| cpcMediumMin | number | CPC（当前）最小值 |\n| cpcMediumMax | number | CPC（当前）最大值 |\n\n**新品与退货**：\n\n| 参数 | 类型 | 说明 |\n|------|------|------|\n| launchRateT180Min | number | 发布商品的成功率（180天统计）最小值，数值范围为0-1，代表0%-100% |\n| launchRateT180Max | number | 发布商品的成功率（180天统计）最大值，数值范围为0-1，代表0%-100% |\n| newProductRateT180 | number | 新商品占比（180天统计）最小值，数值范围为0-1，代表0%-100% |\n| returnRateT360Min | number | 退货率（360天统计）最小值，数值范围为0-1，代表0%-100% |\n| returnRateT360Max | number | 退货率（360天统计）最大值，数值范围为0-1，代表0%-100% |\n\n### 排序选项\n\n| 值 | 说明 |\n|------|------|\n| unitsSoldT7 | 7天销量 |\n| searchVolumeT7 | 7天搜索量 |\n| demand | 需求得分 |\n| avgPrice | 商品均价 |\n| maximumPrice | 商品最高价 |\n| minimumPrice | 商品最低价 |\n| productCount | 商品数量 |\n| searchConversionRateT7 | 7天搜索转化率 |\n| clickConversionRateT7 | 7天点击转化率 |\n| searchVolumeGrowthT7 | 搜索增长率 |\n| clickCountT7 | 周点击量 |\n| clickCountT90 | 90天点击量 |\n| brandCount | 品牌数量 |\n| top5BrandsClickShare | TOP5品牌份额 |\n| top5ProductsClickShare | top5商品点击份额 |\n| newProductsLaunchedT180 | 180d新品成功率-发布数 |\n| successfulLaunchesT180 | 180d新品成功率-新品数 |\n| launchRateT180 | 180d新品成功率-发布率 |\n| returnRateT360 | 退货率 |\n| clickConversionRateT90 | 90天点击转化率 |\n| searchConversionRateT90 | 90天搜索转化率 |\n| searchVolumeT90 | 90天搜索量 |\n| unitsSoldT90 | 90天销量 |\n| unitsSoldGrowthT90 | 90天销量增长率 |\n| searchVolumeGrowthT90 | 90天搜索增长率 |\n| acos | 广告销售成本比 |\n| profitRate50 | 50%自然单的利润率 |\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| total | integer | 总数 |\n| data | array | 细分市场信息列表（见下方细分市场对象字段） |\n| columns | array | 渲染的列 |\n| title | string | 标题 |\n| type | string | 渲染的样式 |\n| costToken | integer | 消耗token |\n\n### 细分市场对象字段（`data` 数组内）\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| nicheId | string | 细分市场ID |\n| nicheTitle | string | 细分市场标题 |\n| translationZh | string | 细分市场标题(中文) |\n| demand | integer | 细分市场得分 |\n| productCount | integer | 商品数量 |\n| avgPrice | number | 产品均价 |\n| minimumPrice | number | 产品最低价 |\n| maximumPrice | number | 产品最高价 |\n| searchVolumeWeekly | integer | 搜索量（周数据） |\n| searchVolumeQuarterly | integer | 搜索量（季度数据） |\n| searchVolumeGrowthWeekly | number | 搜索量增长率（周数据） |\n| searchVolumeGrowthQuarterly | number | 搜索量增长率（季度数据） |\n| unitsSoldWeekly | integer | 销售数量（周数据） |\n| unitsSoldQuarterly | integer | 销售数量（季度数据） |\n| clickCountWeekly | integer | 点击量（周数据） |\n| clickCountQuarterly | integer | 点击量（季度数据） |\n| clickToSaleConversionWeekly | number | 点击转换率（周数据） |\n| clickConversionRateQuarterly | number | 点击转换率（季度数据） |\n| searchConversionRateWeekly | number | 搜索转换率（周数据） |\n| searchConversionRateQuarterly | number | 搜索转换率（季度数据） |\n| brandCount | integer | 品牌数量 |\n| top5BrandsClickShare | number | 前5个品牌所占细分市场的点击量份额 |\n| top5ProductsClickShare | number | 排名前5位的商品点击份额 |\n| avgBrandAgeNow | number | 平均品牌年龄(当前) |\n| avgBrandAgeQuarterly | number | 平均品牌年龄(季度数据) |\n| newProductsLaunchedSemiannual | integer | 已发布新产品的数量（半年数据） |\n| successfulLaunchedSemiannual | integer | 成功发布商品的数量（半年数据） |\n| launchRateSemiannual | number | 发布商品的成功率（半年数据） |\n| returnRateAnnual | number | 退货率（全年数据） |\n| acos | number | （ACOS）广告销售成本比 |\n| profitMarginGt50PctSkuRatio | number | 利润率大于50%的商品比例 |\n| breakEvenRatio | number | 盈亏平衡比率 |\n| cpc | object | CPC数据：`{ high（最高价）, medium（中间价）, low（最低价） }` |\n| categorieList | array | 商品类目列表 |\n| referenceAsinImageUrl | string | 细分市场参考图片地址 |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n \"errcode\": 401,\n \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheInfoByKeyword \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"keyword\": \"wireless earbuds\",\n \"countryCode\": \"US\",\n \"sortField\": \"demand\",\n \"sortType\": \"desc\",\n \"page\": 1,\n \"pageSize\": 20\n }'\n```\n\n### 带筛选条件的查询示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheInfoByKeyword \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"keyword\": \"yoga mat\",\n \"countryCode\": \"US\",\n \"top5BrandsClickShareMax\": 0.5,\n \"brandCountMin\": 20,\n \"searchVolumeT7Min\": 5000,\n \"sortField\": \"unitsSoldT7\",\n \"sortType\": \"desc\",\n \"page\": 1,\n \"pageSize\": 50\n }'\n```\n\nFile v1.2.3:references/linkfox-jiimore-get-niche-info.md\n\n---\nname: linkfox-jiimore-get-niche-info\ndescription: 基于极目数据查询亚马逊细分市场的核心指标、竞争格局、价格走势、断货率及市场增长趋势。\n---\n\n# 极目细分市场信息（Jiimore Niche Market Info）\n\n本技能通过极目数据服务查询并分析亚马逊细分市场数据，帮助卖家深入了解特定细分市场的竞争、定价、评论与增长趋势。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 通过 `nicheId` 查询单个亚马逊细分市场的综合市场情报，涵盖市场概览、价格、搜索与转化、竞争集中度、商品上架、库存健康、卖家成熟度、评论洞察、广告与盈利等维度。\n- 支持对比当前、90 天前、360 天前的时间快照，识别市场趋势。\n- 支持美国（US）、日本（JP）、德国（DE）三个站点，默认 US。\n\n### ❌ 边界与限制\n\n- **单 ID 查询**：每次请求仅支持一个 `nicheId`，不支持批量查询；需对比多个细分市场时需分别调用。\n- **三个站点**：仅支持 US、JP、DE，不支持其他站点。\n- **需已知 nicheId**：本工具无法按关键词或品类搜索细分市场，用户须提供 `nicheId`。\n- **不在范围内**：按关键词/品类搜索细分市场；单个 ASIN 级商品分析；ABA 搜索词数据（请用 ABA Data Explorer）；广告投放管理与 PPC 优化；Listing 文案撰写与评论管理。\n\n## 核心概念\n\n极目**细分市场**（niche market）代表亚马逊上一个细粒度的商品品类，每个细分市场由唯一的 `nicheId` 标识。本工具一次查询一个细分市场的综合市场情报，覆盖：\n\n- **市场概览**：细分市场标题、需求评分、商品数、品牌数、销售伙伴数\n- **价格**：均价、最低价、最高价\n- **搜索与转化**：周/季度搜索量及增长率、搜索转化率、点击转化率、销量\n- **竞争集中度**：前 5 / 前 20 商品与品牌点击份额（当前、90 天、360 天快照）\n- **商品上架**：新上架商品数、90/180/360 天窗口的成功上架数\n- **库存健康**：平均断货率趋势\n- **卖家成熟度**：平均品牌年龄、平均销售伙伴年龄\n- **评论洞察**：平均评论评分、平均评论数、正面/负面客户评论洞察\n- **广告**：ACOS（广告销售成本比）、广告商品占比\n- **盈利**：利润率 > 50% 的 SKU 占比、盈亏平衡比率、退货率\n\n**支持站点**：US（美国）、JP（日本）、DE（德国），默认 **US**。\n\n## 调用方式\n\n- **API 端点**：`POST /jiimore/getNicheInfo`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/jiimore_get_niche_info.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-jiimore-get-niche-info-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq`或`ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 基础查询（US 站点）**\n查询指定 nicheId 的美国站细分市场数据：\n```\nnicheId: \"12345678\"\ncountryCode: \"US\"\n```\n\n**2. 查询日本站细分市场**\n```\nnicheId: \"87654321\"\ncountryCode: \"JP\"\n```\n\n**3. 查询德国站细分市场**\n```\nnicheId: \"11223344\"\ncountryCode: \"DE\"\n```\n\n## 展示规则\n\n1. **清晰呈现数据**：以结构化表格或分组区块展示查询结果，除非用户明确要求，否则不做主观商业建议。\n2. **趋势对比**：当响应包含当前、90 天前、360 天前数据点时，并排展示以便用户识别趋势。\n3. **百分比格式**：份额与比率值以百分比展示（如 0.35 显示为 35.0%）。\n4. **评论洞察**：若存在正面/负面客户评论洞察，以列表形式呈现。\n5. **图片展示**：若返回 `referenceAsinImageUrl`，展示或链接细分市场参考图片。\n6. **错误处理**：查询失败时根据响应说明原因，并建议检查 nicheId 或 countryCode。\n7. **结果组织建议**：按市场概览、价格与盈利、搜索与需求趋势、竞争格局、商品上架活动、评论与客户洞察、库存与运营等逻辑分组呈现。\n\n## 用户表达与场景速查\n\n**适用** —— 针对特定亚马逊细分市场的查询：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"查一下这个细分市场\"、\"niche ID 信息\" | 基础细分市场查询 |\n| \"这个细分市场竞争如何\"、\"品牌集中度\" | 竞争分析 |\n| \"这个细分市场均价多少\" | 价格情报 |\n| \"这个细分市场的搜索量\"、\"需求趋势\" | 搜索与需求分析 |\n| \"上了多少新品\"、\"上架成功率\" | 商品上架追踪 |\n| \"这个细分市场的评论评分\"、\"买家反馈洞察\" | 评论分析 |\n| \"断货率\"、\"库存健康度\" | 库存分析 |\n| \"这个细分市场值不值得做\"、\"细分市场机会\" | 综合细分市场评估 |\n\n不适用场景见上方【能力边界】。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# 极目-亚马逊-细分市场洞察信息 API 参考\r\n\r\n## 调用规范\r\n\r\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/jiimore/getNicheInfo`\r\n- **请求方式**：POST，Content-Type: application/json\r\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\r\n\r\n## 请求参数\r\n\r\nPOST Body（JSON）：\r\n\r\n| 参数 | 类型 | 必填 | 说明 |\r\n|------|------|------|------|\r\n| nicheId | string | 是 | 细分市场ID，最大长度1000字符，只支持单个ID查询 |\r\n| countryCode | string | 否 | 国家编码，仅支持 `US`、`JP`、`DE`，默认 `US` |\r\n\r\n\r\n## 响应结构\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| total | integer | 记录数 |\r\n| data | array | 细分市场信息列表，每个元素为包含以下字段的对象 |\r\n| columns | array | 渲染的列 |\r\n| costToken | integer | 消耗token |\r\n| type | string | 渲染的样式 |\r\n\r\n### `data` 元素关键字段\r\n\r\n#### 市场概览\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| nicheId | string | 细分市场ID |\r\n| nicheTitle | string | 细分市场标题 |\r\n| translationZh | string | 细分市场标题(中文) |\r\n| referenceAsinImageUrl | string | 细分市场参考图片地址 |\r\n| marketplaceId | string | 市场ID |\r\n| demand | integer | 细分市场得分 |\r\n| categorieList | array | 商品品类列表 |\r\n\r\n#### 商品与品牌数量\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| productCount | integer | 商品数量 |\r\n| productCountNow | integer | 商品数量(当前) |\r\n| productCountT90Before | integer | 商品数量(90天前) |\r\n| productCountT360Before | integer | 商品数量(360天前) |\r\n| brandCount | integer | 品牌数量 |\r\n| brandCountNow | integer | 品牌数量(当前) |\r\n| brandCountT90Before | integer | 品牌数量(90天前) |\r\n| brandCountT360Before | integer | 品牌数量(360天前) |\r\n| brandCountT360Now | integer | 品牌数量(360天统计)(当前) |\r\n| brandCountT360T90Before | integer | 品牌数量(360天统计)(90天前) |\r\n| brandCountT360T360Before | integer | 品牌数量(360天统计)(360天前) |\r\n| sellingPartnerCountNow | integer | 销售伙伴数量(当前) |\r\n| sellingPartnerCountT90Before | integer | 销售伙伴数量(90天前) |\r\n| sellingPartnerCountT360Before | integer | 销售伙伴数量(360天前) |\r\n| sellingPartnerCountT360Now | integer | 销售伙伴数量(360 天统计)(当前) |\r\n| sellingPartnerCountT360T90Before | integer | 销售伙伴数量(360 天统计)(90天前) |\r\n| sellingPartnerCountT360T360Before | integer | 销售伙伴数量(360 天统计)(360天前) |\r\n\r\n#### 价格\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgPrice | number | 产品均价 |\r\n| avgProductPriceNow | number | 产品均价(当前) |\r\n| avgProductPriceT90Before | number | 产品均价(90天前) |\r\n| avgProductPriceT360Before | number | 产品均价(360天前) |\r\n| minimumPrice | number | 产品最低价 |\r\n| maximumPrice | number | 产品最高价 |\r\n\r\n#### 搜索与转化\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| searchVolumeWeekly | integer | 搜索量（周数据） |\r\n| searchVolumeQuarterly | integer | 搜索量（季度数据） |\r\n| searchVolumeGrowthWeekly | number | 搜索量增长率（周数据） |\r\n| searchVolumeGrowthQuarterly | number | 搜索量增长率（季度数据） |\r\n| searchConversionRateWeekly | number | 搜索转换率（周数据） |\r\n| searchConversionRateQuarterly | number | 搜索转换率（季度数据） |\r\n| clickCountWeekly | integer | 点击量（周数据） |\r\n| clickCountQuarterly | integer | 点击量（季度数据） |\r\n| clickConversionRateQuarterly | number | 点击转换率（季度数据） |\r\n| clickToSaleConversionWeekly | number | 点击转换率（周数据） |\r\n| unitsSoldWeekly | integer | 销售数量（周数据） |\r\n| unitsSoldQuarterly | integer | 销售数量（季度数据） |\r\n\r\n#### 竞争 - 商品点击份额\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| top5ProductsClickShare | number | 排名前 5 位的商品点击份额 |\r\n| top5ProductsClickShareNow | number | 前5个商品所占细分市场的点击量份额(当前) |\r\n| top5ProductsClickShareT90Before | number | 前5个商品所占细分市场的点击量份额(90天前) |\r\n| top5ProductsClickShareT360Before | number | 前5个商品所占细分市场的点击量份额(360天前) |\r\n| top5ProductsClickShareT360Now | number | 排名前 5 位的商品点击份额（360天统计）(当前) |\r\n| top5ProductsClickShareT360T90Before | number | 排名前 5 位的商品点击份额（360天统计）(90天前) |\r\n| top5ProductsClickShareT360T360Before | number | 排名前 5 位的商品点击份额（360天统计）(360天前) |\r\n| top20ProductsClickShareNow | number | 前20个商品所占细分市场的点击量份额（当前) |\r\n| top20ProductsClickShareT90Before | number | 前20个商品所占细分市场的点击量份额（90天前) |\r\n| top20ProductsClickShareT360Before | number | 前20个商品所占细分市场的点击量份额（360天前) |\r\n| top20ProductsClickShareT360Now | number | 排名前20位的商品点击份额(360 天统计)(当前) |\r\n| top20ProductsClickShareT360T90Before | number | 排名前20位的商品点击份额(360 天统计)(90天前) |\r\n| top20ProductsClickShareT360T360Before | number | 排名前20位的商品点击份额(360 天统计)(360天前) |\r\n\r\n#### 竞争 - 品牌点击份额\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| top5BrandsClickShare | number | 前5个品牌所占细分市场的点击量份额 |\r\n| top5BrandsClickShareNow | number | 前5个品牌所占细分市场的点击量份额(当前) |\r\n| top5BrandsClickShareT90Before | number | 前5个品牌所占细分市场的点击量份额(90天前) |\r\n| top5BrandsClickShareT360Before | number | 前5个品牌所占细分市场的点击量份额(360天前) |\r\n| top5BrandsClickShareT360Now | number | 前5个品牌所占细分市场的点击量份额(360 天统计)(当前) |\r\n| top5BrandsClickShareT360T90Before | number | 前5个品牌所占细分市场的点击量份额(360 天统计)(90天前) |\r\n| top5BrandsClickShareT360T360Before | number | 前5个品牌所占细分市场的点击量份额(360 天统计)(360天前) |\r\n| top20BrandsClickShareNow | number | 前20个品牌所占细分市场的点击量份额(当前) |\r\n| top20BrandsClickShareT90Before | number | 前20个品牌所占细分市场的点击量份额(90天前) |\r\n| top20BrandsClickShareT360Before | number | 前20个品牌所占细分市场的点击量份额(360天前) |\r\n| top20BrandsClickShareT360Now | number | 前20个品牌所占细分市场的点击量份额(360天统计)（当前) |\r\n| top20BrandsClickShareT360T90Before | number | 前20个品牌所占细分市场的点击量份额(360天统计)（90天前) |\r\n| top20BrandsClickShareT360T360Before | number | 前20个品牌所占细分市场的点击量份额(360天统计)（360天前) |\r\n\r\n#### 商品上架\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| newProductsLaunchedSemiannual | integer | 已发布新产品的数量（半年数据） |\r\n| newProductsLaunchedT180Now | integer | 已发布新产品的数量(180天统计)(当前) |\r\n| newProductsLaunchedT180T90Before | integer | 已发布新产品的数量(180天统计)(90天前) |\r\n| newProductsLaunchedT180T360Before | integer | 已发布新产品的数量(180天统计)(360天前) |\r\n| newProductsLaunchedT360Now | integer | 新上架商品数(360天统计)(当前) |\r\n| newProductsLaunchedT360T90Before | integer | 新上架商品数(360天统计)(90天前) |\r\n| newProductsLaunchedT360T360Before | integer | 新上架商品数(360天统计)(360天前) |\r\n| successfulLaunchedSemiannual | integer | 成功发布商品的数量（半年数据） |\r\n| launchRateSemiannual | number | 发布商品的成功率（半年数据） |\r\n| successfulLaunchesT90Now | integer | 成功上架数(90天统计)(当前） |\r\n| successfulLaunchesT90T90Before | integer | 成功上架数(90天统计)(90天前) |\r\n| successfulLaunchesT90T360Before | integer | 成功上架数(90天统计)(360天前) |\r\n| successfulLaunchesT180Now | integer | 成功发布商品的数量（180 天统计）(当前) |\r\n| successfulLaunchesT180T90Before | integer | 成功发布商品的数量（180 天统计）(90天前) |\r\n| successfulLaunchesT180T360Before | integer | 成功发布商品的数量（180 天统计）(360天前) |\r\n| successfulLaunchesT360Now | integer | 成功发布商品的数量（360 天统计）(当前) |\r\n| successfulLaunchesT360T90Before | integer | 成功发布商品的数量（360 天统计）(90天前) |\r\n| successfulLaunchesT360T360Before | integer | 成功发布商品的数量（360 天统计）(360天前) |\r\n\r\n#### 库存与运营\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgOOSRateNow | number | 平均缺货率(当前) |\r\n| avgOOSRateT90Before | number | 平均缺货率(90天前) |\r\n| avgOOSRateT360Before | number | 平均缺货率(360天前) |\r\n| avgOOSRateT360Now | number | 平均缺货率(360天统计)(当前) |\r\n| avgOOSRateT360T90Before | number | 平均缺货率(360天统计)(90天前) |\r\n| avgOOSRateT360T360Before | number | 平均缺货率(360天统计)(360天前) |\r\n| primeProductsPercentageNow | number | prime商品的百分比(当前) |\r\n| primeProductsPercentageT90Before | number | prime商品的百分比(90天前) |\r\n| primeProductsPercentageT360Before | number | prime商品的百分比(360天前) |\r\n| primeProductsPercentageT360Now | number | prime商品的百分比(360 天统计）(当前) |\r\n| primeProductsPercentageT360T90Before | number | prime商品的百分比(360 天统计）(90天前) |\r\n| primeProductsPercentageT360T360Before | number | prime商品的百分比(360 天统计）(360天前) |\r\n\r\n#### 评论与评分\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgReviewRatingNow | number | 平均评论评分(当前) |\r\n| avgReviewRatingT90Before | number | 平均评论评分(90天前) |\r\n| avgReviewRatingT360Before | number | 平均评论评分(360天前) |\r\n| avgReviewCountNow | number | 平均评论数(当前) |\r\n| avgReviewCountT90Before | number | 平均评论数(90天前) |\r\n| avgReviewCountT360Before | number | 平均评论数(360天前) |\r\n| positiveCustomerReviewInsights | array | 正面客户评论见解信息 |\r\n| negativeCustomerReviewInsights | array | 负面客户评论见解信息 |\r\n| productStarRatingImpact | array | 产品星级影响力信息 |\r\n\r\n#### 卖家成熟度\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| avgBrandAgeNow | number | 平均品牌年龄(当前) |\r\n| avgBrandAgeT90Before | number | 平均品牌年龄(90天前) |\r\n| avgBrandAgeT360Before | number | 平均品牌年龄(360天前) |\r\n| avgBrandAgeQuarterly | number | 平均品牌年龄(季度数据) |\r\n| avgBrandAgeT360Now | number | 平均品牌年龄(360 天统计)(当前) |\r\n| avgBrandAgeT360T90Before | number | 平均品牌年龄(360 天统计)(90天前) |\r\n| avgBrandAgeT360T360Before | number | 平均品牌年龄(360 天统计)(360天前) |\r\n| avgSellingPartnerAgeNow | number | 平均销售伙伴年龄(当前) |\r\n| avgSellingPartnerAgeT90Before | number | 平均销售伙伴年龄(90天前) |\r\n| avgSellingPartnerAgeT360Before | number | 平均销售伙伴年龄(360天前) |\r\n| avgBestSellerRankNow | number | 平均BestSeller排名(当前) |\r\n| avgBestSellerRankT90Before | number | 平均BestSeller排名(90天前) |\r\n| avgBestSellerRankT360Before | number | 平均BestSeller排名(360天前) |\r\n\r\n#### 广告与盈利\r\n\r\n| 字段 | 类型 | 说明 |\r\n|------|------|------|\r\n| acos | number | （ACOS）广告销售成本比 |\r\n| sponsoredProductsPercentageNow | number | 已进行商品推广的商品的百分比(当前) |\r\n| sponsoredProductsPercentageT90Before | number | 已进行商品推广的商品的百分比(90天前) |\r\n| sponsoredProductsPercentageT360Before | number | 已进行商品推广的商品的百分比(360天前) |\r\n| sponsoredProductsPercentageT360Now | number | 已进行商品推广的商品的百分比(360 天统计)(当前) |\r\n| sponsoredProductsPercentageT360T90Before | number | 已进行商品推广的商品的百分比(360 天统计)(90天前) |\r\n| sponsoredProductsPercentageT360T360Before | number | 已进行商品推广的商品的百分比(360 天统计)(360天前) |\r\n| profitMarginGt50PctSkuRatio | number | 利润率大于50%的商品比例 |\r\n| breakEvenRatio | number | 盈亏平衡比率 |\r\n| returnRateAnnual | number | 退货率（全年数据） |\r\n| cpc | object | CPC（每次点击费用）数据 |\r\n\r\n## 错误码\r\n\r\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\r\n\r\n| errcode | 含义 | 处理建议 |\r\n|---------|------|----------|\r\n| 200 | 成功 | 正常解析业务字段 |\r\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。|\r\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\r\n\r\n错误响应示例：\r\n\r\n```json\r\n{\r\n \"errcode\": 401,\r\n \"errmsg\": \"authorized error\"\r\n}\r\n```\r\n\r\n## curl 示例\r\n\r\n```bash\r\ncurl -X POST https://tool-gateway.linkfox.com/jiimore/getNicheInfo \\\r\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\r\n -H \"Content-Type: application/json\" \\\r\n -d '{\"nicheId\": \"12345678\", \"countryCode\": \"US\"}'\r\n```\n\nArchive v1.2.2: 72 files, 392508 bytes\n\nFiles: references/linkfox-aba-intelligent-query.md (12111b), references/linkfox-amazon-alexa-search.md (13115b), references/linkfox-amazon-opportunity-report-by-keyword.md (8429b), references/linkfox-amazon-opportunity-search-by-metrics.md (21329b), references/linkfox-amazon-product-detail.md (15679b), references/linkfox-amazon-reviews-list.md (11589b), references/linkfox-amazon-search-by-image.md (15714b), references/linkfox-amazon-search.md (14314b), references/linkfox-jiimore-get-niche-info-by-keyword.md (18462b), references/linkfox-jiimore-get-niche-info.md (20485b), references/linkfox-jiimore-get-niche-review-from-keyword.md (16190b), references/linkfox-jiimore-page-asins-by-asin.md (16981b), references/linkfox-jiimore-product-discovery.md (14022b), references/linkfox-junglescout-keyword-by-asin.md (16210b), references/linkfox-junglescout-keyword-by-keyword.md (14274b), references/linkfox-junglescout-keyword-history.md (10589b), references/linkfox-junglescout-keyword-share-of-voice.md (13612b), references/linkfox-junglescout-product-database.md (16844b), references/linkfox-junglescout-sales-estimates.md (11831b), references/linkfox-keepa-product-request.md (14068b), references/linkfox-keepa-product-search.md (18601b), references/linkfox-keepa-product-series.md (12490b), references/linkfox-sellersprite-competitor-lookup.md (16713b), references/linkfox-sellersprite-market-research.md (16064b), references/linkfox-sellersprite-market-statistics.md (10076b), references/linkfox-sellersprite-product-search.md (23376b), references/linkfox-sellersprite-traffic-keyword.md (12288b), references/linkfox-sif-asin-keywords.md (17315b), references/linkfox-sif-asin-summary.md (18718b), references/linkfox-sif-keyword-overview.md (13932b), references/linkfox-sif-keyword-summary.md (19104b), references/linkfox-sorftime-amazon-product-detail.md (16840b), references/linkfox-sorftime-amazon-product-query.md (17923b), references/onboarding.md (2068b), scripts/aba_query.py (12662b), scripts/amazon_alexa_search.py (12686b), scripts/amazon_opportunity_report.py (12771b), scripts/amazon_opportunity_screener.py (12783b), scripts/amazon_product_detail.py (12699b), scripts/amazon_reviews.py (12664b), scripts/amazon_search_by_image.py (12699b), scripts/amazon_search.py (12636b), scripts/jiimore_get_niche_info_by_keyword.py (13133b), scripts/jiimore_get_niche_info.py (13056b), scripts/jiimore_get_niche_review.py (13126b), scripts/jiimore_page_asins_by_asin.py (13101b), scripts/jiimore_product_discovery.py (13091b), scripts/junglescout_keyword_by_asin.py (13140b), scripts/junglescout_keyword_by_keyword.py (13191b), scripts/junglescout_keyword_history.py (13171b), scripts/junglescout_keyword_sov.py (13165b), scripts/junglescout_product_database.py (13151b), scripts/junglescout_sales_estimates.py (13140b), scripts/keepa_product_detail.py (13061b), scripts/keepa_product_history.py (13061b), scripts/keepa_product_search.py (12682b), scripts/onboarding.py (24089b), scripts/sellersprite_competitor_lookup.py (13133b), scripts/sellersprite_market_research.py (13117b), scripts/sellersprite_market_statistics.py (13133b), scripts/sellersprite_product_search.py (12750b), scripts/sellersprite_traffic_keyword.py (13117b), scripts/sif_asin_keywords.py (13035b), scripts/sif_asin_summary.py (13019b), scripts/sif_keyword_overview.py (13051b), scripts/sif_keyword_traffic.py (13058b), scripts/sorftime_product_detail.py (13103b), scripts/sorftime_product_search.py (13099b), scripts/upload_image.py (4669b), skill-card.md (4229b), SKILL.md (23723b), _meta.json (151b)\n\nFile v1.2.2:SKILL.md\n\n---\nname: linkfox-amazon-product-selection\ndisplay_name: Linkfox 亚马逊选品\ndisplay_name_en: LinkFox Amazon Product Selection\ndescription: 亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。\ndescription_zh: 亚马逊选品一站式 AI 工具集，整合 竞品查询、ABA 搜索词分析、亚马逊前台搜索/以图搜图/商品详情/评论/Alexa 导购、商业洞察六维报告、Keepa/Sorftime 历史时序、Jungle Scout/卖家精灵/SIF/极目关键词与利基市场等 12 类底层工具、33 项子能力。覆盖美国、英国、德国、日本等 15+ 站点，支持关键词挖掘、流量反查、竞品深挖、销量与价格趋势、利基竞争格局、评论痛点、AI 市场机会报告与反向赛道筛选。当用户需要亚马逊选品、市场调研、竞品分析、关键词分析、评论挖掘、历史趋势追踪或反向找赛道时触发。各子能力完整参数见 references/ 对应文件，脚本见 scripts/。\ndescription_en: One-stop Amazon product-selection AI toolkit integrating 33 sub-capabilities across 12 tool families — competitor lookup, ABA search-term analysis, Amazon frontend search/image-search/product-detail/reviews/Alexa, business-insight six-dimension reports and reverse selection, Keepa/Sorftime historical time series, and Jungle Scout/SellerSprite/SIF/Jiimore keyword and niche analysis. Covers 15+ marketplaces (US/UK/DE/JP…) for keyword mining, traffic reverse lookup, competitor deep-dive, sales/price trends, niche competition, review pain points, AI opportunity reports and reverse niche screening. Triggered when the user needs Amazon product selection, market research, competitor analysis, keyword analysis, review mining, historical trend tracking or reverse niche discovery. Full params per sub-capability are in references/, executable scripts in scripts/.\ncategory: e-commerce\nversion: 1.0.0\nauthor: LinkFox\n---\n\n# Linkfox 亚马逊选品（Amazon Product Selection）\n\n亚马逊选品一站式 AI 工具集，整合 **12 类底层工具、33 项子能力**，覆盖前台实时、历史时序、关键词与流量、利基市场、商业洞察与评论挖掘。各子能力完整参数、响应字段与错误码见 `references/` 下对应文件，可执行脚本见 `scripts/`。\n\n## 能力边界\n\n### ✅ 能力范围\n- **前台实时数据**：关键词搜索排名与 SERP、以图搜图（`amazon_search`）、商品详情/五点/A+/变体（`amazon_product_detail`）、按星级筛选评论（`amazon_reviews`）、Alexa 自然语言导购（`amazon_alexa_assistant`）。\n- **竞品搜索**：卖家精灵竞品查询（按关键词/ASIN/卖家/品牌/类目反查竞品，含销量、BSR、定价、评分与增长趋势，`sellersprite` 竞品查询）、极目按 ASIN 挖同细分市场竞品并按转化率/销量/价格/利润多维筛选（`jiimore` page-asins-by-asin）。\n- **历史时序与趋势**：Keepa 商品详情/搜索/历史曲线（`keepa`，价格/BSR/月销/卖家数）、Sorftime 详情/搜索与趋势回看（`sorftime`，含 FBA 利润、Deal 历史、历史快照）。\n- **关键词与流量分析**：ABA 搜索词挖掘（`amazon_aba_search_term`）、Jungle Scout 反查/拓展/历史/声量份额（`jungle_scout`）、SIF ASIN 关键词反查/ASIN 流量结构/关键词竞争概览/关键词下竞品流量来源拆解（`sif_search_intelligence`）、卖家精灵流量词反查（`sellersprite` 流量关键词）。\n- **利基与市场分析**：极目细分市场指标/评论/竞品/潜力爆品（`jiimore`）、卖家精灵商品搜索选品、选市场列表与统计看板（`sellersprite`）、Jungle Scout 商品库与销量预估（`jungle_scout`）。\n- **商业洞察与反向选品**：按关键词生成市场潜力/产品特征/评论/客户画像/搜索趋势/定价六维 AI 报告，按 30+ 商业维度反向筛选蓝海赛道（`amazon_business_insight`）。\n- 覆盖美国、英国、德国、法国、日本、加拿大、意大利、西班牙、印度、墨西哥、巴西等 15+ 站点（站点集合随工具略有差异，详见各 references）。\n\n### ❌ 边界与限制\n- **API Key 必需**：所有工具均需环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）；各工具独立计费、独立限频，数据时效与站点覆盖随数据源而异。\n- **计费约束**：同一会话同一参数组合默认只调用一次（脚本带 24h 本地缓存）；失败或空结果不得自动换关键词、翻页或改邮编连续试探；需继续检索时先向用户说明会产生额外消耗（各工具计费规则见 `skills-version.json` 对应条目与 references 内 api.md 的 `costToken` 字段）。\n- **不在范围内**：店铺运营（Listing 刊登/订单/库存，用 SP-API 系列）、广告投放与管理（用 Amazon Ads 系列）、物流与供应链规划、1688 找货源、TikTok/沃尔玛等其他平台选品、非电商任务、与平台或卖家的直接沟通、实时库存与订单处理。\n- **数据时效**：前台类工具为实时抓取（含 SERP 排名、评论、Alexa）；历史类（Keepa/Sorftime/ABA）为各自数据源的更新周期，`lastUpdate`/`costToken` 等字段标识刷新与消耗。\n\n## 工具选择指南\n\n按需求在下表定到子能力，再跳到【业务需求路由速查】查端点/脚本/references 取参执行。\n\n| 需求 / 用户说 | 默认推荐（子能力） | 何时换用其他 |\n|---|---|---|\n| ASIN 商品数据 / 价格销量趋势（\"这个 ASIN 卖得怎么样\"） | `linkfox-keepa-product-request`（字段最全） | 要 FBA 利润+趋势回看用 `linkfox-sorftime-amazon-product-detail`；要 A+/变体/实时价用 `linkfox-amazon-product-detail` |\n| ASIN 流量词反查（\"ASIN 的流量词有哪些\"） | `linkfox-sif-asin-keywords`（流量词+排名+搜索量） | 要 PPC 竞价+排名难度用 `linkfox-junglescout-keyword-by-asin`；要转化类型+历史月份用 `linkfox-sellersprite-traffic-keyword` |\n| 关键词拓展 / 相关流量词（\"这个词有哪些相关词/长尾词\"） | `linkfox-junglescout-keyword-by-keyword`（种子词拓展，含搜索量/趋势/PPC 竞价） | 要按 ASIN 反查其流量词用 `linkfox-sif-asin-keywords`；要官方搜索词排名（非拓展）用 `linkfox-aba-intelligent-query` |\n| 关键词搜索量趋势（\"这个词的搜索量/排名\"） | `linkfox-junglescout-keyword-history`（精确搜索量） | 要官方搜索排名（非搜索量）用 `linkfox-aba-intelligent-query` |\n| 商品搜索 / 选品筛选（\"帮我选品 / 什么好卖\"） | `linkfox-keepa-product-search`（多维+历史） | 要历史快照回看用 `linkfox-sorftime-amazon-product-query`；要毛利筛选用 `linkfox-sellersprite-product-search`；要实时 SERP 用 `linkfox-amazon-search` |\n| 关键词竞争度（\"这个词竞争大不大\"） | `linkfox-sif-keyword-overview`（供需比+搜索量） | 要品牌声量份额用 `linkfox-junglescout-keyword-share-of-voice` |\n| 利基 / 细分市场评估（\"细分市场能不能进\"） | `linkfox-jiimore-get-niche-info-by-keyword`（垄断/品牌/新品成功率） | 要类目维度看板用 `linkfox-sellersprite-market-research` / `-market-statistics`；要多条件筛选商品库用 `linkfox-junglescout-product-database` |\n| ASIN 销量预估 | `linkfox-junglescout-sales-estimates`（日维度） | 要 12 月月销趋势用 `linkfox-keepa-product-request` |\n| 利基评论 / 痛点（\"评论痛点 / 差评\"） | `linkfox-jiimore-get-niche-review-from-keyword`（细分市场级） | 要单 ASIN 评论用 `linkfox-amazon-reviews-list` |\n| ASIN 流量结构 / 竞品分析 | `linkfox-sif-asin-summary`（ASIN 流量构成） | 要关键词下竞品流量拆解用 `linkfox-sif-keyword-summary` |\n| 竞品反查（关键词/ASIN/卖家/品牌） | `linkfox-sellersprite-competitor-lookup` | 要按 ASIN 挖同细分竞品用 `linkfox-jiimore-page-asins-by-asin` |\n| 六维 AI 市场报告（\"AI 市场报告\"） | `linkfox-amazon-opportunity-report-by-keyword` | — |\n| 反向按指标找赛道（\"按条件反找赛道\"） | `linkfox-amazon-opportunity-search-by-metrics` | — |\n| 前台实时搜索 / 以图搜图（\"前台搜一下这个词\"） | `linkfox-amazon-search` / `linkfox-amazon-search-by-image` | — |\n| 自然语言导购（\"用自然语言问亚马逊推荐\"） | `linkfox-amazon-alexa-search` | — |\n\n### 工具选择思路\n- **重要**：多个子能力满足需求时，要依据需求深入分析子能力的功能、用途、出入参、从中调研出最合适的子能力，并推荐用户，让用户自己决定。\n- 满足程度同等的前提下，向用户推荐“默认推荐子能力”。\n\n## 业务需求路由速查\n\n按【工具选择指南】定到子能力 后，下表查端点、脚本与 references 文件取参执行：\n\n### 子能力 ↔ references 文件 ↔ 端点 ↔ 脚本（33 项）\n\n**amazon_aba_search_term**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-aba-intelligent-query | references/linkfox-aba-intelligent-query.md | POST /aba/intelligentQuery | aba_query.py |\n\n**amazon_alexa_assistant**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-alexa-search | references/linkfox-amazon-alexa-search.md | POST /amazon/alexaSearch | amazon_alexa_search.py |\n\n**amazon_business_insight**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-opportunity-report-by-keyword | references/linkfox-amazon-opportunity-report-by-keyword.md | POST /amazon/opportunity/reportByKeyword | amazon_opportunity_report.py |\n| linkfox-amazon-opportunity-search-by-metrics | references/linkfox-amazon-opportunity-search-by-metrics.md | POST /amazon/opportunity/searchByMetrics | amazon_opportunity_screener.py |\n\n**amazon_search**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-search | references/linkfox-amazon-search.md | POST /amazon/search | amazon_search.py |\n| linkfox-amazon-search-by-image | references/linkfox-amazon-search-by-image.md | POST /amazon/searchByImage | amazon_search_by_image.py、upload_image.py |\n\n**amazon_product_detail**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-product-detail | references/linkfox-amazon-product-detail.md | POST /amazon/product/detail | amazon_product_detail.py |\n\n**amazon_reviews**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-amazon-reviews-list | references/linkfox-amazon-reviews-list.md | POST /amazon/reviews/list | amazon_reviews.py |\n\n**jiimore**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| 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 |\n| linkfox-jiimore-get-niche-info | references/linkfox-jiimore-get-niche-info.md | POST /jiimore/getNicheInfo | jiimore_get_niche_info.py |\n| linkfox-jiimore-get-niche-review-from-keyword | references/linkfox-jiimore-get-niche-review-from-keyword.md | POST /jiimore/getNicheReviewFromKeyword | jiimore_get_niche_review.py |\n| linkfox-jiimore-product-discovery | references/linkfox-jiimore-product-discovery.md | POST /jiimore/productDiscovery | jiimore_product_discovery.py |\n| linkfox-jiimore-page-asins-by-asin | references/linkfox-jiimore-page-asins-by-asin.md | POST /jiimore/pageAsinsByAsin | jiimore_page_asins_by_asin.py |\n\n**jungle_scout**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-junglescout-keyword-by-asin | references/linkfox-junglescout-keyword-by-asin.md | POST /tool-jungle-scout/keywords/by-asin | junglescout_keyword_by_asin.py |\n| linkfox-junglescout-keyword-by-keyword | references/linkfox-junglescout-keyword-by-keyword.md | POST /tool-jungle-scout/keywords/by-keyword | junglescout_keyword_by_keyword.py |\n| linkfox-junglescout-keyword-history | references/linkfox-junglescout-keyword-history.md | POST /tool-jungle-scout/keywords/historical-search-volume | junglescout_keyword_history.py |\n| 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 |\n| linkfox-junglescout-product-database | references/linkfox-junglescout-product-database.md | POST /tool-jungle-scout/product-database/query | junglescout_product_database.py |\n| linkfox-junglescout-sales-estimates | references/linkfox-junglescout-sales-estimates.md | POST /tool-jungle-scout/sales-estimates/query | junglescout_sales_estimates.py |\n\n**keepa**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-keepa-product-request | references/linkfox-keepa-product-request.md | POST /keepa/productRequest | keepa_product_detail.py |\n| linkfox-keepa-product-search | references/linkfox-keepa-product-search.md | POST /keepa/productSearch | keepa_product_search.py |\n| linkfox-keepa-product-series | references/linkfox-keepa-product-series.md | POST /keepa/productSeries | keepa_product_history.py |\n\n**sellersprite**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-sellersprite-competitor-lookup | references/linkfox-sellersprite-competitor-lookup.md | POST /sellersprite/competitor-lookup | sellersprite_competitor_lookup.py |\n| linkfox-sellersprite-product-search | references/linkfox-sellersprite-product-search.md | POST /sellersprite/productSearch | sellersprite_product_search.py |\n| linkfox-sellersprite-market-research | references/linkfox-sellersprite-market-research.md | POST /sellersprite/market/research | sellersprite_market_research.py |\n| linkfox-sellersprite-market-statistics | references/linkfox-sellersprite-market-statistics.md | POST /sellersprite/market/statistics | sellersprite_market_statistics.py |\n| linkfox-sellersprite-traffic-keyword | references/linkfox-sellersprite-traffic-keyword.md | POST /sellersprite/traffic/keyword | sellersprite_traffic_keyword.py |\n\n**sif_search_intelligence**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-sif-asin-keywords | references/linkfox-sif-asin-keywords.md | POST /sif/asinKeywords | sif_asin_keywords.py |\n| linkfox-sif-asin-summary | references/linkfox-sif-asin-summary.md | POST /sif/asinSummary | sif_asin_summary.py |\n| linkfox-sif-keyword-overview | references/linkfox-sif-keyword-overview.md | POST /sif/keywordOverview | sif_keyword_overview.py |\n| linkfox-sif-keyword-summary | references/linkfox-sif-keyword-summary.md | POST /sif/keywordSummary | sif_keyword_traffic.py |\n\n**sorftime**\n| 子能力 | references 文件 | 端点 | 脚本 |\n|---|---|---|---|\n| linkfox-sorftime-amazon-product-detail | references/linkfox-sorftime-amazon-product-detail.md | POST /sorftime/amazon/productDetail | sorftime_product_detail.py |\n| linkfox-sorftime-amazon-product-query | references/linkfox-sorftime-amazon-product-query.md | POST /sorftime/amazon/productQuery | sorftime_product_search.py |\n\n## 调用方式\n\n- **网关**：`${LINKFOX_TOOL_GATEWAY}/<端点>`，请求方式 POST、Content-Type `application/json`，认证 Header `Authorization: `（api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取；未配置按下方【解决认证和积分问题】处理）。各端点路径见下方【业务需求路由速查】与对应 references 文件。\n- **Python 脚本**：每项子能力对应 `scripts/<脚本名>.py '' [--inline]`（脚本名与端点见路由速查表）。脚本内部完成网关调用、鉴权与落盘。\n- **输出策略（脚本默认行为）**：始终将完整响应写入 `/linkfox///data/-.json`（`` 为脚本执行时工作目录；`` 取自环境变量 `SESSION_ID`；禁止写入 /tmp，当前目录不可写则报错）；响应体 ≤ 8 KB 落盘后完整打印到 stdout，> 8 KB 仅打印摘要（顶层字段、常见计数、最大列表长度 + 前 3 条样本）；加 `--inline` 强制全量打印（同样落盘）。\n- **读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 PowerShell `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n- **完整参数**：每个子能力的请求参数、响应字段、错误码、curl 示例见 `references/<源skill>.md`（文件内含该子能力 SKILL.md 正文与 api.md 全文）。\n\n## 使用示例\n\n以下按数据层给出代表性子能力的出入参示例；其余子能力参数见对应 references 文件。`domain` 为 Keepa 站点数字 ID（`1`=美/`2`=英/`3`=德/`5`=日…），`marketplace`/`amazonDomain`/`country`/`countryCode`/`region` 为各工具的站点代码，含义见 references。\n\n### 前台实时层\n\n**1. 关键词搜索排名（amazon_search → amazon_search.py）**\n```json\n{\"keyword\": \"wireless earbuds\", \"amazonDomain\": \"amazon.com\", \"page\": 1}\n```\n出参：`products[]`（asin/title/brand/price/rating/ratings/position/sponsored/imageUrl/asinUrl/delivery）、`total`、`costToken`。\n\n**2. 以图搜图（amazon_search_by_image → amazon_search_by_image.py，需先 upload_image.py 上传）**\n```json\n{\"imageUrl\": \"https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg\", \"amazonDomain\": \"amazon.com\", \"sort\": \"default\"}\n```\n出参：`products[]`（asin/title/price/oldPrice/rating/ratings/brand）；设 `aggregateByKeepaData:true` 可聚合 salesRank/monthlySalesUnits/fbaFees/profit。\n\n**3. 商品详情（amazon_product_detail → amazon_product_detail.py）**\n```json\n{\"asins\": \"B072MQ5BRX,B08N5WRWNW\", \"amazonDomain\": \"amazon.com\"}\n```\n出参：`products[]`（asin/title/brand/price/oldPrice/rating/ratings/aboutItem/variants/customerReviews/productImageUrls）、`total`、`costToken`。\n\n**4. 商品评论（amazon_reviews → amazon_reviews.py）**\n```json\n{\"asin\": \"B08N5WRWNW\", \"domainCode\": \"com\", \"star1Num\": 10, \"star2Num\": 10, \"star3Num\": 10, \"star4Num\": 10, \"star5Num\": 10, \"sortBy\": \"recent\"}\n```\n出参：`data[]`（reviewId/title/text/rating/date/userName/verified/vine/numberOfHelpful/imageUrlList/videoUrlList）、`total`、`costToken`。\n\n**5. Alexa 导购问答（amazon_alexa_assistant → amazon_alexa_search.py）**\n```json\n{\"prompts\": [\"best wireless earbuds for running\"], \"format\": \"json\"}\n```\n出参：`data`（导购回答/推荐商品分组/ASIN 列表/可追问问题）、`resultsNum`、`costToken`。仅支持单条 prompt，追问需 agent 拼接上下文后发起新请求。\n\n### 历史时序层\n\n**6. Keepa 商品详情（keepa → keepa_product_detail.py）**\n```json\n{\"asin\": \"B0088PUEPK\", \"domain\": \"1\", \"history\": 1}\n```\n出参：`products[]`（asin/title/price/salesRank/salesRank30/90/180/monthlySalesUnits(含近12月)/monthlySalesRevenue/fbaFees/profit/rating/reviewCount/categoryTree/lastUpdate）、`costToken`。批量最多 5 个 ASIN。\n\n**7. Sorftime 商品详情与趋势（sorftime → sorftime_product_detail.py）**\n```json\n{\"asin\": \"B00FLYWNYQ\", \"marketplace\": \"us\"}\n```\n出参：`products[]`（asin/title/price/profitRate/profitAmount/salesRank/monthlySalesUnits/rating/fbaFees/bsrRankTrend/priceTrend/rankTrend/dealTrend）、`costToken`。\n\n### 关键词与流量层\n\n**8. ABA 搜索词分析（amazon_aba_search_term → aba_query.py）**\n```json\n{\"analysisDescription\": \"筛选美国站关键词gift在过去12周的搜索热度排名\", \"region\": \"US\"}\n```\n出参：`tables`（搜索词/周开始日期/站点/搜索排名/点击ASIN/商品名/点击占比/转化占比）、`total`、`downloadUrl`（`createDownloadUrl:true` 时生成 CSV）、`costToken`。\n\n**9. Jungle Scout 关键词拓展（jungle_scout → junglescout_keyword_by_keyword.py）**\n```json\n{\"marketplace\": \"us\", \"searchTerms\": \"yoga mat\", \"needCount\": 20}\n```\n出参：`keywordInfoList[]`（name/monthlySearchVolumeExact/monthlySearchVolumeBroad/monthlyTrend/dominantCategory/organicProductCount/ppcBidExact/ppcBidBroad/easeOfRankingScore）、`costToken`。\n\n**10. SIF 关键词竞争概览（sif_search_intelligence → sif_keyword_overview.py）**\n```json\n{\"keyword\": \"wireless charger\", \"country\": \"US\"}\n```\n出参：`keyword`/keywordPopularityRank/estimatedWeeklySearchVolume/supplyDemandRatio/totalSearchResultProductCount/sponsoredProductsCount/paidAdvertisingProductCount/trackedAsinTotalCount。\n\n### 利基与市场层\n\n**11. 极目利基市场分析（jiimore → jiimore_get_niche_info_by_keyword.py）**\n```json\n{\"keyword\": \"wireless earbuds\", \"countryCode\": \"US\", \"sortField\": \"demand\", \"sortType\": \"desc\", \"pageSize\": 20}\n```\n出参：`data`（nicheId/nicheTitle/translationZh/demand/productCount/avgPrice/searchVolumeWeekly/unitsSoldWeekly/brandCount/top5BrandsClickShare/launchRateSemiannual/cpc）、`costToken`。\n\n**12. 卖家精灵商品搜索选品（sellersprite → sellersprite_product_search.py）**\n```json\n{\"keyword\": \"yoga mat\", \"marketplace\": \"US\", \"minUnits\": 300, \"minPrice\": 10, \"maxPrice\": 50, \"order\": {\"field\": \"total_units\", \"desc\": \"true\"}, \"page\": 1, \"size\": 20}\n```\n出参：`products[]`（asin/title/price/月销量/月销售额/BSR/评分/毛利率/配送方式）、`total`、`costToken`。\n\n### 商业洞察层\n\n**13. 六维 AI 市场机会报告（amazon_business_insight → amazon_opportunity_report.py）**\n```json\n{\"site\": \"US\", \"keyword\": \"ice bricks\"}\n```\n出参：市场潜力/产品特征/用户评论/客户画像/搜索趋势/定价分析六维 AI 报告，`costTime`、`costToken`。当前仅支持 US 站。\n\n**14. 反向选品赛道筛选（amazon_business_insight → amazon_opportunity_screener.py）**\n```json\n{\"nicheBrandCountLte\": 20, \"nicheSearchVolumeYoyChangePctAtLeastGte\": 100, \"featureNewAvgReviewCountAtLeastLte\": 500, \"limit\": 25}\n```\n出参：`data[]`（每条约 37 字段：keyword/nicheName/nicheRevenue360d/nicheBrandCount/priceMinUsd/demoGenderDominant/reviewNegativeTop1Topic…），至少一个过滤条件。计费按返回条数 N（即使 N=0 也按最低计费）。\n\n## 展示规则\n\n1. **客观呈现数据**：以清晰表格展示查询结果，不做主观商业建议（除非用户主动要求）；不同平台币种不同，展示价格/收入时务必提示币种（响应 `currency` 字段标明本地币种）。\n2. **来源标注**：展示数据时说明来自哪个工具/数据源（Keepa/Sorftime/Jungle Scout/极目/SIF/卖家精灵/ABA/前台/商业洞察）。\n3. **不可用数据**：值为 `0` 或 `-1` 的字段表示数据不可用，标注\"N/A\"或省略，不作实际值展示。\n4. **错误处理与协同**：查询失败时根据响应 `errcode`/`errmsg` 说明原因并建议修正（ASIN 格式、站点不支持、参数越界等）；连续使用多工具时将各工具发现汇总为连贯分析，标注数据来源与时间窗。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用 references/onboarding.md 引导解决问题：\n\n**注意**：你是workbuddy，并且渠道是workbuddy，使用 onboarding 引导登录注册时 channel **必须**为 workbuddy。这非常重要！\n\n### 异常情况\n- **未配置API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应401或402状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\nFile v1.2.2:_meta.json\n\n{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-amazon-product-selection\",\n \"version\": \"1.2.2\",\n \"publishedAt\": 1786099230197\n}\n\nFile v1.2.2:references/linkfox-aba-intelligent-query.md\n\n---\nname: linkfox-aba-intelligent-query\ndescription: 提供亚马逊ABA（品牌分析）搜索词数据的查询与分析，涵盖15个站点近3年的周维度数据，用于关键词挖掘与市场趋势分析。\n---\n\n# 亚马逊 ABA 数据挖掘（ABA Intelligent Query）\n\n本技能用于查询和分析亚马逊 ABA（Amazon Brand Analytics）搜索词数据，帮助卖家从搜索词报告中挖掘关键词机会、排名趋势与市场洞察。完整请求参数、响应字段与错误码见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 查询亚马逊 ABA 搜索词数据，覆盖 15 个站点、近 3 年的**周维度**历史数据。\n- 通过自然语言 `analysisDescription` 精确描述查询意图，后端转化为结构化查询。\n- 支持关键词热度排名趋势、黑马词发现、蓝海词挖掘、季节性关键词、高点击低转化 ASIN 诊断、竞品流量分布等场景。\n- 可按需生成 CSV 下载链接（最多 10,000 条）。\n\n### ❌ 边界与限制\n\n- **数据粒度**：仅周维度，无日维度数据；历史范围约 3 年。\n- **结果上限**：下载链接单次最多 10,000 条记录。\n- **站点范围**：仅支持 15 个亚马逊站点（US、DE、BR、CA、AU、JP、AE、ES、FR、IT、SA、TR、MX、SE、NL），不含其他电商平台。\n- **默认站点**：用户未指定站点时默认 US。\n- **不在范围内**：广告/PPC 出价与投放策略；商品评论、Listing 文案撰写；ASIN 销量估算；用户已有本地 ABA 文件处理；利润测算、定价策略与综合市场报告。\n- **成本约束**：本工具消耗积分，同一会话同一参数组合默认只调用一次；失败/空结果不得自动换关键词、翻页或改邮编连续试探。\n\n## 核心概念\n\nABA（Amazon Brand Analytics）搜索词报告是亚马逊官方搜索行为数据，反映消费者真实搜索活动。本工具持有近 3 年的**周维度**数据，覆盖 15 个亚马逊站点。\n\n**排名逻辑**：`searchFrequencyRank` 数值越小代表搜索热度越高，排名 1 为最热门搜索词。此处易混淆——用户说\"排名提升\"指数值变小；\"排名下降\"指数值变大。\n\n### 数据字段\n\n| 字段 | API 名称 | 说明 | 示例 |\n|------|----------|------|------|\n| 搜索词 | searchTerm | 消费者搜索关键词 | rimel loreal |\n| 报告起始日期 | reportStartDate | 数据采集周起始日 | 2025-10-26 |\n| 站点 | region | 亚马逊站点代码 | US |\n| 搜索频率排名 | searchFrequencyRank | 搜索热度排名（越小越优） | 82135 |\n| 被点击 ASIN | clickedAsin | 被点击商品的 ASIN | B0XXXXXXXX |\n| 被点击商品名 | clickedItemName | 被点击商品名称 | xxx |\n| 点击占比排名 | clickShareRank | 该 ASIN 在该搜索词下的点击占比排名 | 1 |\n| 点击占比 | clickShare | 该 ASIN 占据的点击份额（0~1） | 0.28 |\n| 转化占比 | conversionShare | 该 ASIN 占据的转化份额（0~1） | 0.3333 |\n\n### 支持站点\n\nUS（美国）、DE（德国）、BR（巴西）、CA（加拿大）、AU（澳大利亚）、JP（日本）、AE（阿联酋）、ES（西班牙）、FR（法国）、IT（意大利）、SA（沙特）、TR（土耳其）、MX（墨西哥）、SE（瑞典）、NL（荷兰）。\n\n用户未指定站点时默认 **US**。\n\n## 调用方式\n\n- **API 端点**：`POST /aba/intelligentQuery`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/aba_query.py '' [--inline]`\n- **成本约束**：同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-aba-intelligent-query-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 查询构建\n\n调用本工具的关键参数是 `analysisDescription`——用自然语言描述要查询的数据。该描述会在后端转化为结构化查询，因此需要**精确、具体**。\n\n### analysisDescription 编写原则\n\n1. **明确站点**：在开头说明站点，如\"筛选美国站\"。\n2. **用精确筛选条件**：用具体数值区间而非模糊描述，\"排名在5万以内\"远优于\"排名较好\"。\n3. **明确时间范围**：用具体时间描述，如\"过去12周\"、\"2024年1-9月\"、\"近3个月\"。\n4. **明确对比基线**：做趋势分析时清楚说明对比的时间点，如\"4周前的排名比8周前提升30%\"。\n5. **处理去重逻辑**：同一搜索词 + ASIN 组合有多条记录时，说明保留哪条，如\"相同搜索词相同ASIN值保留最新的一个\"。\n6. **忠实用户意图**：不要曲解或过度扩展用户需求，准确反映其本意。\n\n### 常见场景示例\n\n**1. 搜索词热度趋势**\n```\n筛选美国站，关键词\"gift\"在过去12周的搜索热度排名。\n```\n\n**2. 上升黑马关键词**\n```\n筛选美国站，关键词包含\"gift\"，2025年Q1和全年的平均搜索排名都大于50万，但最新排名冲进5万-10万的搜索词。\n```\n\n**3. 持续增长趋势发现**\n```\n筛选美国站，最新排名在20万以内，且4周前的排名比8周前提升30%，本周的排名比4周前提升30%的搜索词。\n```\n\n**4. 市场机会发现（高搜索量、低垄断）**\n```\n筛选美国站，筛选当前搜索排名在20000以内，近三个月点击占比Top 1的Asin的转化率占比低于5%的搜索词。相同搜索词相同Asin值保留最新的一个。\n```\n\n**5. 季节性/节日关键词定位**\n```\n筛选美国站，包含\"cup\"的关键词中，去年（2024年）1-9月份排名未进入50万，10-11月份连续进入20万的词。\n```\n\n**6. 高点击低转化 ASIN 挖掘**\n```\n筛选美国站关键词包含\"hat\"的，最新搜索排名在5万-20万之间，且近3个月来点击占比大于20%，转化占比小于10%的ASIN。相同搜索词和ASIN仅保留点击占比和转化占比的比例最小数据。\n```\n\n**7. 高 ROAS 长尾蓝海词**\n```\n筛选美国站，关键词包含\"charger\"的，当前排名在20万开外的，近2个月的平均转化占比大于平均转化占比1.5倍的关键词，以及相应的ASIN。\n```\n\n**8. 新市场词与新兴需求探测**\n```\n找到美国站\"charger\"的长尾词中，近一个月才进入排名榜单，且当前排名在50万以内的所有词。\n```\n\n**9. 利基趋势/变体增长捕捉**\n```\n筛选美国站中\"table\"的长尾词中，排名在10万-30万之间，且近4周的搜索排名增长50%以上的搜索词。\n```\n\n## 展示规则\n\n1. **只呈现数据**：以清晰表格展示查询结果，不做主观商业建议。\n2. **排名澄清**：展示排名数据时提醒用户数值越小排名越优。\n3. **体量提示**：结果较大时展示核心数据并提醒用户可通过下载链接获取完整数据。\n4. **下载引导**：响应含 `downloadUrl` 时明确告知下载地址；用户需要全量数据但未请求下载时，主动建议生成下载链接。\n5. **错误处理**：查询失败时依据 `msg` 字段说明原因，并建议调整查询条件。\n\n## 用户表达与场景速查\n\n**适用** —— 围绕亚马逊搜索词的数据查询：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"XX 关键词搜索量/热度怎么样\" | 排名趋势 |\n| \"最近火的词\"、\"新冒出来的词\" | 黑马/新词探测 |\n| \"蓝海词\"、\"低竞争词\" | 市场机会发现 |\n| \"哪些词转化好\"、\"高转化长尾\" | 高 ROAS 关键词库 |\n| \"季节性词\"、\"旺季爆发的词\" | 季节性关键词 |\n| \"流量被谁占了\"、\"有没有垄断\" | 点击占比/垄断分析 |\n| \"高点击低转化的 ASIN\" | 高点击低转化诊断 |\n\n不适用场景见上方【能力边界】。\n\n**边界判断**：用户说\"选品\"、\"竞品分析\"、\"有没有市场机会\"时，若本质是搜索词级数据查询（找蓝海词、分析关键词下竞品流量分布），则适用本技能；若问利润空间、定价策略或综合市场报告，则不适用。\n\n## 解决认证和积分问题\n\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill 并根据它的引导来处理。如未安装请先安装：\n - 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装这个 skill。\n\n---\n\n# ABA 智能查询 API 参考\n\n## 调用规范\n\n- **请求地址**：`${LINKFOX_TOOL_GATEWAY}/aba/intelligentQuery`\n- **请求方式**：POST，Content-Type: application/json\n- **认证方式**：Header `Authorization: `，api_key 从环境变量 `LINKFOX_AGENT_API_KEY` 或 `LINKFOXAGENT_API_KEY` 读取（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）\n\n## 请求参数\n\nPOST Body（JSON）：\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| analysisDescription | string | 是 | 精确描述查询意图的自然语言 |\n| region | string | 否 | 站点代码，默认 `US`。可选值：US、DE、BR、CA、AU、JP、AE、ES、FR、IT、SA、TR、MX、SE、NL |\n| createDownloadUrl | boolean | 否 | 是否生成CSV下载链接，默认 `false` |\n\n- 当用户明确要求\"下载\"、\"导出\"、\"生成文件\"时，将 `createDownloadUrl` 设为 `true`\n\n## 响应结构\n\n| 字段 | 类型 | 说明 |\n|------|------|------|\n| success | boolean | 是否查询成功 |\n| tables | array | 结果数据数组，每个元素包含 `data`（数据行）、`columns`（列定义）、`name`（Sheet名称） |\n| total | integer | 结果总数 |\n| downloadUrl | string | 当 `createDownloadUrl` 为 true 时返回CSV文件地址 |\n| msg | string | 附加消息 |\n| downloadNote | string | 下载相关提示 |\n| code | string | 返回码 |\n| costTime | integer | 耗时（ms） |\n| costToken | integer | 消耗token |\n\n## 错误码\n\n正常情况下，接口的 HTTP 状态码均为 200，业务的成功与否通过响应体中的 errorCode 字段区分（errorCode = 200 表示成功，其他值表示业务错误）。当遇到未授权等情况时，HTTP 状态码为 401，且对应的 errorCode 也是 401。\n\n| errcode | 含义 | 处理建议 |\n|---------|------|----------|\n| 200 | 成功 | 正常解析 `tables` / `data` 等业务字段 |\n| 401 | 认证失败 | HTTP 401 或 authorized error：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 402 | 积分不足 | HTTP 402：按 SKILL.md 的 **## 解决认证和积分问题** 处理。 |\n| 其他非200值 | 业务异常 | 参考 `errmsg` 字段获取具体错误原因 |\n\n错误响应示例：\n\n```json\n{\n \"errcode\": 401,\n \"errmsg\": \"authorized error\"\n}\n```\n\n## curl 示例\n\n```bash\ncurl -X POST https://tool-gateway.linkfox.com/aba/intelligentQuery \\\n -H \"Authorization: $LINKFOXAGENT_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"analysisDescription\": \"筛选美国站，关键词gift在过去12周的搜索热度排名\", \"region\": \"US\"}'\n```\n\nFile v1.2.2:references/linkfox-amazon-alexa-search.md\n\n---\nname: linkfox-amazon-alexa-search\ndescription: 模拟亚马逊前台 Alexa 购物助手，通过自然语言多轮问答获取导购建议、推荐商品分组及相关 ASIN 列表。\n---\n\n# 亚马逊 Alexa 购物助手（Amazon Alexa Shopping Assistant）\n\n本技能驱动亚马逊前台 Alexa 购物助手：用自然语言提问，获取导购回答、推荐商品分组（含 ASIN 与链接）以及可继续追问的问题。每次调用仅支持 1 条 prompt；多轮对话需由 agent 总结上文并拼接新问题发起新请求。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 通过亚马逊前台 Alexa 购物助手发起自然语言问答，获取导购回答与推荐商品分组（含 ASIN、标题、价格、评分、链接）。\n- 返回可继续追问的问题列表，支持 agent 总结上文后拼接新问题进行多轮对话。\n- 可用 `url` 锚定具体亚马逊页面（分类页 / 搜索结果页 / 商品详情页）作为对话上下文。\n- 支持 `markdown`（可读报告）与 `json`（结构化数据）两种输出格式。\n\n### ❌ 边界与限制\n\n- **每次仅 1 条 prompt**：`prompts` 数组只接受 1 个元素，不可一次传入多个问题。\n- **无跨调用记忆**：每次调用是全新的 Alexa 会话，追问须由 agent 总结上文 + 新问题作为 `prompts[0]` 重新发起。\n- **Alexa 驱动、非确定性**：相同 prompt 在不同时间/流量下可能返回不同答案。\n- **站点覆盖**：主要锚定 amazon.com 前台 Alexa 体验；非美国站点的可用性取决于 Alexa 上线情况。\n- **不传首页 URL**：`url` 仅在用户提供具体页面时传入；`https://www.amazon.com/` 这类首页 URL 不要传。\n- **不在范围内**：关键词 SERP 全量结果与排名（用前台搜索模拟技能）；历史搜索词分析或搜索量趋势（用 ABA 数据浏览器）；已知 ASIN 的商品详情/A+/五点（用亚马逊商品详情技能）；评论情感分析（用亚马逊评论技能）；以图搜款（用图片搜索技能）；对扁平商品列表的聚合统计。\n\n## 核心概念\n\n1. **单轮单问题**：`prompts` 是数组但只支持 **1 个元素**，每次调用发送 1 个问题并返回 1 个回答，不要传入多个元素。\n2. **跨调用无上下文**：每次调用都是全新 Alexa 会话。追问时 agent 须总结上一轮回答（关键推荐、ASIN、相关上下文），与新问题拼接后作为 `prompts[0]` 发起新请求。\n3. **可选页面上下文 `url`**：仅在需要把对话锚定到**具体**亚马逊页面（分类页、搜索结果页、商品详情页）时传入。不要传 `https://www.amazon.com/` 这类首页 URL——它不提供有用上下文。无具体页面时省略 `url`。\n4. **两种输出格式**：\n - `markdown`（默认）：一份可读 Markdown 报告，包含问题、Alexa 回答、推荐商品分组、可继续追问的问题。\n - `json`：`data` 下的结构化数组，每项含 `prompt`、`content`、`products`（分组推荐）、`followUpQuestions`、`screenshot`。\n\n`resultsNum` 为 Alexa 实际答复的对话轮次；为 `0` 表示 Alexa 未对该输入产生可用回答。\n\n## 调用方式\n\n- **API 端点**：`POST /amazon/alexaSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/amazon_alexa_search.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-alexa-search-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 单轮购物提问**\n```json\n{\n \"prompts\": [\"best wireless earbuds for running on Amazon US under $100\"]\n}\n```\n\n**2. 追问（agent 总结上文后重新提问）**\n\n首次调用：\n```json\n{\n \"prompts\": [\"best electric kettle on Amazon US\"]\n}\n```\n\n第二次调用（agent 总结上一轮回答并拼接追问）：\n```json\n{\n \"prompts\": [\"Previously Alexa recommended: 1) Cosori Electric Kettle (B07T1KY5TZ, $35.99, 4.7★), 2) Mueller Ultra Kettle (B09KC7D3HR, $29.97, 4.5★). Now compare these two on noise level and boil time.\"]\n}\n```\n\n**3. 锚定到分类页的问题**\n```json\n{\n \"prompts\": [\"What are the most popular picks on this page?\"],\n \"url\": \"https://www.amazon.com/s?k=electric+kettle\"\n}\n```\n\n**4. 结构化输出便于下游提取**\n```json\n{\n \"prompts\": [\"best gift ideas for a 10-year-old who likes science\"],\n \"format\": \"json\"\n}\n```\n\n## 展示规则\n\n1. **直接渲染 Markdown**：`format=markdown` 时 `stdout` 已按轮次标题、商品卡片、追问问题结构化，保留该结构呈现。\n2. **突出推荐 ASIN**：展示 `title`、`price`、`score`/`ratingsCount` 与商品 URL，便于用户点击直达。\n3. **展示追问问题**：Alexa 返回的 `followUpQuestions` 是可用的继续提问选项；用户选中其一后，总结当前回答并以该问题作为 `prompts[0]` 发起新调用。\n4. **不要重定向到数据分析沙箱**：回答正文是对话式的，推荐商品是嵌套分组而非适合 SQL 聚合的扁平表。\n5. **标注空结果**：`resultsNum` 为 `0` 或 `data` 为空时，告知用户 Alexa 未产生可用回答，建议改写问题或用 `url` 锚定页面。\n6. **说明时效**：结果反映调用时 Alexa 的实时回答；用户问及时效时说明这一点。\n7. **处理业务错误**：`code`/`errcode` 非 `200` 时，呈现 `msg`/`errmsg` 并建议用更简单的问题重试。\n\n## 用户表达与场景速查\n\n**适用** —— 亚马逊自然语言对话式购物：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"用 Alexa 帮我推荐...\", \"亚马逊 Alexa 问下...\" | 直接 Alexa 问答 |\n| \"在亚马逊上聊聊给我推荐 ...\", \"对话式选品\" | 对话式发现 |\n| \"顺便再追问一下 / 接着问 ...\" | 追问（agent 总结上文后在新调用中重新提问） |\n| \"在这个页面 / 这个分类下推荐...\", \"基于这个页面再问一下\" | 页面锚定对话（用 `url`） |\n| \"best XX for YY under $Z on Amazon\" | 目标 + 约束 + 预算问答 |\n| \"对比 Alexa 给的前两个推荐\" | 在 Alexa \n\nArchive v1.2.1: 72 files, 392800 bytes\n\nFiles: references/linkfox-aba-intelligent-query.md (12111b), references/linkfox-amazon-alexa-search.md (13115b), references/linkfox-amazon-opportunity-report-by-keyword.md (8429b), references/linkfox-amazon-opportunity-search-by-metrics.md (21329b), references/linkfox-amazon-product-detail.md (15679b), references/linkfox-amazon-reviews-list.md (11589b), references/linkfox-amazon-search-by-image.md (15714b), references/linkfox-amazon-search.md (14314b), references/linkfox-jiimore-get-niche-info-by-keyword.md (18462b), references/linkfox-jiimore-get-niche-info.md (20485b), references/linkfox-jiimore-get-niche-review-from-keyword.md (16190b), references/linkfox-jiimore-page-asins-by-asin.md (16981b), references/linkfox-jiimore-product-discovery.md (14022b), references/linkfox-junglescout-keyword-by-asin.md (16210b), references/linkfox-junglescout-keyword-by-keyword.md (14274b), references/linkfox-junglescout-keyword-history.md (10589b), references/linkfox-junglescout-keyword-share-of-voice.md (13612b), references/linkfox-junglescout-product-database.md (16844b), references/linkfox-junglescout-sales-estimates.md (11831b), references/linkfox-keepa-product-request.md (14068b), references/linkfox-keepa-product-search.md (18601b), references/linkfox-keepa-product-series.md (12490b), references/linkfox-sellersprite-competitor-lookup.md (16713b), references/linkfox-sellersprite-market-research.md (16064b), references/linkfox-sellersprite-market-statistics.md (10076b), references/linkfox-sellersprite-product-search.md (23376b), references/linkfox-sellersprite-traffic-keyword.md (12288b), references/linkfox-sif-asin-keywords.md (17315b), references/linkfox-sif-asin-summary.md (18718b), references/linkfox-sif-keyword-overview.md (13932b), references/linkfox-sif-keyword-summary.md (19104b), references/linkfox-sorftime-amazon-product-detail.md (16840b), references/linkfox-sorftime-amazon-product-query.md (17923b), references/onboarding.md (2068b), scripts/aba_query.py (12662b), scripts/amazon_alexa_search.py (12686b), scripts/amazon_opportunity_report.py (12771b), scripts/amazon_opportunity_screener.py (12783b), scripts/amazon_product_detail.py (12699b), scripts/amazon_reviews.py (12664b), scripts/amazon_search_by_image.py (12699b), scripts/amazon_search.py (12636b), scripts/jiimore_get_niche_info_by_keyword.py (13133b), scripts/jiimore_get_niche_info.py (13056b), scripts/jiimore_get_niche_review.py (13126b), scripts/jiimore_page_asins_by_asin.py (13101b), scripts/jiimore_product_discovery.py (13091b), scripts/junglescout_keyword_by_asin.py (13140b), scripts/junglescout_keyword_by_keyword.py (13191b), scripts/junglescout_keyword_history.py (13171b), scripts/junglescout_keyword_sov.py (13165b), scripts/junglescout_product_database.py (13151b), scripts/junglescout_sales_estimates.py (13140b), scripts/keepa_product_detail.py (13061b), scripts/keepa_product_history.py (13061b), scripts/keepa_product_search.py (12682b), scripts/onboarding.py (24089b), scripts/sellersprite_competitor_lookup.py (13133b), scripts/sellersprite_market_research.py (13117b), scripts/sellersprite_market_statistics.py (13133b), scripts/sellersprite_product_search.py (12750b), scripts/sellersprite_traffic_keyword.py (13117b), scripts/sif_asin_keywords.py (13035b), scripts/sif_asin_summary.py (13019b), scripts/sif_keyword_overview.py (13051b), scripts/sif_keyword_traffic.py (13058b), scripts/sorftime_product_detail.py (13103b), scripts/sorftime_product_search.py (13099b), scripts/upload_image.py (4669b), skill-card.md (5617b), SKILL.md (23723b), _meta.json (151b)\n\nArchive v1.2.0: 70 files, 383086 bytes\n\nFiles: references/linkfox-aba-intelligent-query.md (12111b), references/linkfox-amazon-alexa-search.md (13115b), references/linkfox-amazon-opportunity-report-by-keyword.md (8429b), references/linkfox-amazon-opportunity-search-by-metrics.md (21329b), references/linkfox-amazon-product-detail.md (15679b), references/linkfox-amazon-reviews-list.md (11589b), references/linkfox-amazon-search-by-image.md (15714b), references/linkfox-amazon-search.md (14314b), references/linkfox-jiimore-get-niche-info-by-keyword.md (18462b), references/linkfox-jiimore-get-niche-info.md (20485b), references/linkfox-jiimore-get-niche-review-from-keyword.md (16190b), references/linkfox-jiimore-page-asins-by-asin.md (16981b), references/linkfox-jiimore-product-discovery.md (14022b), references/linkfox-junglescout-keyword-by-asin.md (16210b), references/linkfox-junglescout-keyword-by-keyword.md (14274b), references/linkfox-junglescout-keyword-history.md (10589b), references/linkfox-junglescout-keyword-share-of-voice.md (13612b), references/linkfox-junglescout-product-database.md (16844b), references/linkfox-junglescout-sales-estimates.md (11831b), references/linkfox-keepa-product-request.md (14068b), references/linkfox-keepa-product-search.md (18601b), references/linkfox-keepa-product-series.md (12490b), references/linkfox-sellersprite-competitor-lookup.md (16713b), references/linkfox-sellersprite-market-research.md (16064b), references/linkfox-sellersprite-market-statistics.md (10076b), references/linkfox-sellersprite-product-search.md (23376b), references/linkfox-sellersprite-traffic-keyword.md (12288b), references/linkfox-sif-asin-keywords.md (17315b), references/linkfox-sif-asin-summary.md (18718b), references/linkfox-sif-keyword-overview.md (13932b), references/linkfox-sif-keyword-summary.md (19104b), references/linkfox-sorftime-amazon-product-detail.md (16840b), references/linkfox-sorftime-amazon-product-query.md (17923b), scripts/aba_query.py (12662b), scripts/amazon_alexa_search.py (12686b), scripts/amazon_opportunity_report.py (12771b), scripts/amazon_opportunity_screener.py (12783b), scripts/amazon_product_detail.py (12699b), scripts/amazon_reviews.py (12664b), scripts/amazon_search_by_image.py (12699b), scripts/amazon_search.py (12636b), scripts/jiimore_get_niche_info_by_keyword.py (13133b), scripts/jiimore_get_niche_info.py (13056b), scripts/jiimore_get_niche_review.py (13126b), scripts/jiimore_page_asins_by_asin.py (13101b), scripts/jiimore_product_discovery.py (13091b), scripts/junglescout_keyword_by_asin.py (13140b), scripts/junglescout_keyword_by_keyword.py (13191b), scripts/junglescout_keyword_history.py (13171b), scripts/junglescout_keyword_sov.py (13165b), scripts/junglescout_product_database.py (13151b), scripts/junglescout_sales_estimates.py (13140b), scripts/keepa_product_detail.py (13061b), scripts/keepa_product_history.py (13061b), scripts/keepa_product_search.py (12682b), scripts/sellersprite_competitor_lookup.py (13133b), scripts/sellersprite_market_research.py (13117b), scripts/sellersprite_market_statistics.py (13133b), scripts/sellersprite_product_search.py (12750b), scripts/sellersprite_traffic_keyword.py (13117b), scripts/sif_asin_keywords.py (13035b), scripts/sif_asin_summary.py (13019b), scripts/sif_keyword_overview.py (13051b), scripts/sif_keyword_traffic.py (13058b), scripts/sorftime_product_detail.py (13103b), scripts/sorftime_product_search.py (13099b), scripts/upload_image.py (4669b), skill-card.md (3690b), SKILL.md (23683b), _meta.json (151b)\n\nArchive v1.0.1: 70 files, 383783 bytes\n\nFiles: references/linkfox-aba-intelligent-query.md (12111b), references/linkfox-amazon-alexa-search.md (13115b), references/linkfox-amazon-opportunity-report-by-keyword.md (8429b), references/linkfox-amazon-opportunity-search-by-metrics.md (21329b), references/linkfox-amazon-product-detail.md (15679b), references/linkfox-amazon-reviews-list.md (11589b), references/linkfox-amazon-search-by-image.md (15714b), references/linkfox-amazon-search.md (14314b), references/linkfox-jiimore-get-niche-info-by-keyword.md (18462b), references/linkfox-jiimore-get-niche-info.md (20485b), references/linkfox-jiimore-get-niche-review-from-keyword.md (16190b), references/linkfox-jiimore-page-asins-by-asin.md (16981b), references/linkfox-jiimore-product-discovery.md (14022b), references/linkfox-junglescout-keyword-by-asin.md (16210b), references/linkfox-junglescout-keyword-by-keyword.md (14274b), references/linkfox-junglescout-keyword-history.md (10589b), references/linkfox-junglescout-keyword-share-of-voice.md (13612b), references/linkfox-junglescout-product-database.md (16844b), references/linkfox-junglescout-sales-estimates.md (11831b), references/linkfox-keepa-product-request.md (14068b), references/linkfox-keepa-product-search.md (18601b), references/linkfox-keepa-product-series.md (12490b), references/linkfox-sellersprite-competitor-lookup.md (16713b), references/linkfox-sellersprite-market-research.md (16064b), references/linkfox-sellersprite-market-statistics.md (10076b), references/linkfox-sellersprite-product-search.md (23376b), references/linkfox-sellersprite-traffic-keyword.md (12288b), references/linkfox-sif-asin-keywords.md (17315b), references/linkfox-sif-asin-summary.md (18718b), references/linkfox-sif-keyword-overview.md (13932b), references/linkfox-sif-keyword-summary.md (19104b), references/linkfox-sorftime-amazon-product-detail.md (16840b), references/linkfox-sorftime-amazon-product-query.md (17923b), scripts/aba_query.py (12662b), scripts/amazon_alexa_search.py (12686b), scripts/amazon_opportunity_report.py (12771b), scripts/amazon_opportunity_screener.py (12783b), scripts/amazon_product_detail.py (12699b), scripts/amazon_reviews.py (12664b), scripts/amazon_search_by_image.py (12699b), scripts/amazon_search.py (12636b), scripts/jiimore_get_niche_info_by_keyword.py (13133b), scripts/jiimore_get_niche_info.py (13056b), scripts/jiimore_get_niche_review.py (13126b), scripts/jiimore_page_asins_by_asin.py (13101b), scripts/jiimore_product_discovery.py (13091b), scripts/junglescout_keyword_by_asin.py (13140b), scripts/junglescout_keyword_by_keyword.py (13191b), scripts/junglescout_keyword_history.py (13171b), scripts/junglescout_keyword_sov.py (13165b), scripts/junglescout_product_database.py (13151b), scripts/junglescout_sales_estimates.py (13140b), scripts/keepa_product_detail.py (13061b), scripts/keepa_product_history.py (13061b), scripts/keepa_product_search.py (12682b), scripts/sellersprite_competitor_lookup.py (13133b), scripts/sellersprite_market_research.py (13117b), scripts/sellersprite_market_statistics.py (13133b), scripts/sellersprite_product_search.py (12750b), scripts/sellersprite_traffic_keyword.py (13117b), scripts/sif_asin_keywords.py (13035b), scripts/sif_asin_summary.py (13019b), scripts/sif_keyword_overview.py (13051b), scripts/sif_keyword_traffic.py (13058b), scripts/sorftime_product_detail.py (13103b), scripts/sorftime_product_search.py (13099b), scripts/upload_image.py (4669b), skill-card.md (6198b), SKILL.md (23679b), _meta.json (151b)\n\nArchive v1.0.0: 70 files, 383216 bytes\n\nFiles: references/linkfox-aba-intelligent-query.md (12111b), references/linkfox-amazon-alexa-search.md (13115b), references/linkfox-amazon-opportunity-report-by-keyword.md (8429b), references/linkfox-amazon-opportunity-search-by-metrics.md (21329b), references/linkfox-amazon-product-detail.md (15679b), references/linkfox-amazon-reviews-list.md (11589b), references/linkfox-amazon-search-by-image.md (15714b), references/linkfox-amazon-search.md (14314b), references/linkfox-jiimore-get-niche-info-by-keywor...","readmeExcerpt":"Skill: Linkfox 亚马逊选品 Owner: linkfox-ai Summary: 亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。 Tags: latest:1.2.3 Version history: v1.2.3 | 2026-08-14T14:43:39.724Z | user Update from 1.2.2 to 1.2.3 v1.2.2 | 2026-08-07T10:40:30.197Z | user Update from 1.2.1 to 1.2.2 v1.2.1 | 2026-08-05T08:58:14.340Z | user Update from 1.2.0 to 1.2.1 v1.2.0 | 2026-07-1","codeSnippets":[],"executableExamples":[{"language":"json","snippet":"{\"keyword\": \"wireless earbuds\", \"amazonDomain\": \"amazon.com\", \"page\": 1}"},{"language":"json","snippet":"{\"imageUrl\": \"https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg\", \"amazonDomain\": \"amazon.com\", \"sort\": \"default\"}"},{"language":"json","snippet":"{\"asins\": \"B072MQ5BRX,B08N5WRWNW\", \"amazonDomain\": \"amazon.com\"}"},{"language":"json","snippet":"{\"asin\": \"B08N5WRWNW\", \"domainCode\": \"com\", \"star1Num\": 10, \"star2Num\": 10, \"star3Num\": 10, \"star4Num\": 10, \"star5Num\": 10, \"sortBy\": \"recent\"}"},{"language":"json","snippet":"{\"prompts\": [\"best wireless earbuds for running\"], \"format\": \"json\"}"},{"language":"json","snippet":"{\"asin\": \"B0088PUEPK\", \"domain\": \"1\", \"history\": 1}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: linkfox-amazon-product-selection\ndisplay_name: Linkfox 亚马逊选品\ndisplay_name_en: LinkFox Amazon Product Selection\ndescription: 亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。\ndescription_zh: 亚马逊选品一站式 AI 工具集，整合 竞品查询、ABA 搜索词分析、亚马逊前台搜索/以图搜图/商品详情/评论/Alexa 导购、商业洞察六维报告、Keepa/Sorftime 历史时序、Jungle Scout/卖家精灵/SIF/极目关键词与利基市场等 12 类底层工具、33 项子能力。覆盖美国、英国、德国、日本等 15+ 站点，支持关键词挖掘、流量反查、竞品深挖、销量与价格趋势、利基竞争格局、评论痛点、AI 市场机会报告与反向赛道筛选。当用户需要亚马逊选品、市场调研、竞品分析、关键词分析、评论挖掘、历史趋势追踪或反向找赛道时触发。各子能力完整参数见 references/ 对应文件，脚本见 scripts/。\ndescription_en: One-stop Amazon product-selection AI toolkit integrating 33 sub-capabilities across 12 tool families — competitor lookup, ABA search-term analysis, Amazon frontend search/image-search/product-detail/reviews/Alexa, business-insight six-dimension reports and reverse selection, Keepa/Sorftime historical time series, and Jungle Scout/SellerSprite/SIF/Jiimore keyword and niche analysis. Covers 15+ marketplaces (US/UK/DE/JP…) for keyword mining, traffic reverse lookup, competitor deep-dive, sales/price trends, niche competition, review pain points, AI opportunity reports and reverse niche screening. Triggered when the user needs Amazon product selection, market research, competitor analysis, keyword analysis, review mining, historical trend tracking or reverse niche discovery. Full params per sub-capability are in references/, executable scripts in scripts/.\ncategory: e-commerce\nversion: 1.0.0\nauthor: LinkFox\n---\n\n# Linkfox 亚马逊选品（Amazon Product Selection）\n\n亚马逊选品一站式 AI 工具集，整合 **12 类底层工具、33 项子能力**，覆盖前台实时、历史时序、关键词与流量、利基市场、商业洞察与评论挖掘。各子能力完整参数、响应字段与错误码见 `references/` 下对应文件，可执行脚本见 `scripts/`。\n\n## 能力边界\n\n### ✅ 能力范围\n- **前台实时数据**：关键词搜索排名与 SERP、以图搜图（`amazon_search`）、商品详情/五点/A+/变体（`amazon_product_detail`）、按星级筛选评论（`amazon_reviews`）、Alexa 自然语言导购（`amazon_alexa_assistant`）。\n- **竞品搜索**：卖家精灵竞品查询（按关键词/ASIN/卖家/品牌/类目反查竞品，含销量、BSR、定价、评分与增长趋势，`sellersprite` 竞品查询）、极目按 ASIN 挖同细分市场竞品并按转化率/销量/价格/利润多维筛选（`jiimore` page-asins-by-asin）。\n- **历史时序与趋势**：Keepa 商品详情/搜索/历史曲线（`keepa`，价格/BSR/月销/卖家数）、Sorftime 详情/搜索与趋势回看（`sorftime`，含 FBA 利润、Deal 历史、历史快照）。\n- **关键词与流量分析**：ABA 搜索词挖掘（`amazon_aba_search_term`）、Jungle Scout 反查/拓展/历史/声量份额（`jungle_scout`）、SIF ASIN 关键词反查/ASIN 流量结构/关键词竞争概览/关键词下竞品流量来源拆解（`sif_search_intelligence`）、卖家精灵流量词反查（`sellersprite` 流量关键词）。\n- **利基与市场分析**：极目细分市场指标/评论/竞品/潜力爆品（`jiimore`）、卖家精灵商品搜索选品、选市场列表与统计看板（`sellersprite`）、Jungle Scout 商品库与销量预估（`jungle_scout`）。\n- **商业洞察与反向选品**：按关键词生成市场潜力/产品特征/评论/客户画像/搜索趋势/定价六维 AI 报告，按 30+ 商业维度反向筛选蓝海赛道（`amazon_business_insight`）。\n- 覆盖美国、英国、德国、法国、日本、加拿大、意大利、西班牙、印度、墨西哥、巴西等 15+ 站点（站点集合随工具略有差异，详见各 references）。\n\n### ❌ 边界与限制\n- **API Key 必需**：所有工具均需环境变量 `LINKFOX_AGENT_API_KEY`（或 `LINKFOXAGENT_API_KEY`）；各工具独立计费、独立限频，数据时效与站点覆盖随数据源而异。\n- **计费约束**：同一会话同一参数组合默认只调用一次（脚本带 24h 本地缓存）；失败或空结果不得自动换关键词、翻页或改邮编连续试探；需继续检索时先向用户说明会产生额外消耗（各工具计费规则见 `skills-version.json` 对应条目与 references 内 api.md 的 `costToken` 字段）。\n- **不在范围内**：店铺运营（Listing 刊登/订单/库存，用 SP-API 系列）、广告投放与管理（用 Amazon Ads 系列）、物流与供应链规划、1688 找货"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7dmc1t4j28hem1twwyav85p182pb1j\",\n \"slug\": \"linkfox-amazon-product-selection\",\n \"version\": \"1.2.3\",\n \"publishedAt\": 1786718619724\n}"},{"path":"references/linkfox-aba-intelligent-query.md","content":"---\nname: linkfox-aba-intelligent-query\ndescription: 提供亚马逊ABA（品牌分析）搜索词数据的查询与分析，涵盖15个站点近3年的周维度数据，用于关键词挖掘与市场趋势分析。\n---\n\n# 亚马逊 ABA 数据挖掘（ABA Intelligent Query）\n\n本技能用于查询和分析亚马逊 ABA（Amazon Brand Analytics）搜索词数据，帮助卖家从搜索词报告中挖掘关键词机会、排名趋势与市场洞察。完整请求参数、响应字段与错误码见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 查询亚马逊 ABA 搜索词数据，覆盖 15 个站点、近 3 年的**周维度**历史数据。\n- 通过自然语言 `analysisDescription` 精确描述查询意图，后端转化为结构化查询。\n- 支持关键词热度排名趋势、黑马词发现、蓝海词挖掘、季节性关键词、高点击低转化 ASIN 诊断、竞品流量分布等场景。\n- 可按需生成 CSV 下载链接（最多 10,000 条）。\n\n### ❌ 边界与限制\n\n- **数据粒度**：仅周维度，无日维度数据；历史范围约 3 年。\n- **结果上限**：下载链接单次最多 10,000 条记录。\n- **站点范围**：仅支持 15 个亚马逊站点（US、DE、BR、CA、AU、JP、AE、ES、FR、IT、SA、TR、MX、SE、NL），不含其他电商平台。\n- **默认站点**：用户未指定站点时默认 US。\n- **不在范围内**：广告/PPC 出价与投放策略；商品评论、Listing 文案撰写；ASIN 销量估算；用户已有本地 ABA 文件处理；利润测算、定价策略与综合市场报告。\n- **成本约束**：本工具消耗积分，同一会话同一参数组合默认只调用一次；失败/空结果不得自动换关键词、翻页或改邮编连续试探。\n\n## 核心概念\n\nABA（Amazon Brand Analytics）搜索词报告是亚马逊官方搜索行为数据，反映消费者真实搜索活动。本工具持有近 3 年的**周维度**数据，覆盖 15 个亚马逊站点。\n\n**排名逻辑**：`searchFrequencyRank` 数值越小代表搜索热度越高，排名 1 为最热门搜索词。此处易混淆——用户说\"排名提升\"指数值变小；\"排名下降\"指数值变大。\n\n### 数据字段\n\n| 字段 | API 名称 | 说明 | 示例 |\n|------|----------|------|------|\n| 搜索词 | searchTerm | 消费者搜索关键词 | rimel loreal |\n| 报告起始日期 | reportStartDate | 数据采集周起始日 | 2025-10-26 |\n| 站点 | region | 亚马逊站点代码 | US |\n| 搜索频率排名 | searchFrequencyRank | 搜索热度排名（越小越优） | 82135 |\n| 被点击 ASIN | clickedAsin | 被点击商品的 ASIN | B0XXXXXXXX |\n| 被点击商品名 | clickedItemName | 被点击商品名称 | xxx |\n| 点击占比排名 | clickShareRank | 该 ASIN 在该搜索词下的点击占比排名 | 1 |\n| 点击占比 | clickShare | 该 ASIN 占据的点击份额（0~1） | 0.28 |\n| 转化占比 | conversionShare | 该 ASIN 占据的转化份额（0~1） | 0.3333 |\n\n### 支持站点\n\nUS（美国）、DE（德国）、BR（巴西）、CA（加拿大）、AU（澳大利亚）、JP（日本）、AE（阿联酋）、ES（西班牙）、FR（法国）、IT（意大利）、SA（沙特）、TR（土耳其）、MX（墨西哥）、SE（瑞典）、NL（荷兰）。\n\n用户未指定站点时默认 **US**。\n\n## 调用方式\n\n- **API 端点**：`POST /aba/intelligentQuery`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/aba_query.py '' [--inline]`\n- **成本约束**：同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-aba-intelligent-query-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 查询构建\n\n调用本工具的关键参数是 `analysisDescription`——用自然语言描述要查询的数据。该描述会在后端转化为结构化查询，因此需要**精确、具体**。\n\n### analysisDescription 编写原则\n\n1. **明确站点**：在开头说明站点，如\"筛选美国站\"。\n2. **用精确筛选条件**：用具体数值区间而非模糊描述，\"排名在5万以内\"远优于\"排名较好\"。\n3. **明确时间范围**：用具体时间描述，如\"过去12周\"、\"2024年1-9月\"、\"近3个月\"。\n4. **明确对比基线**：做趋势分析时清楚说明对比的时间点，如\"4周前的排名比8周前提升30%\"。\n5. **处理去重逻辑**：同一搜索词 + ASIN 组合有多条记录时，说明保留哪条，如\"相同搜索词相同ASIN值保留最新的一个\"。\n6. **忠实用户意图**：不要曲解或过度扩展用户需求，准确反映其本意。\n\n### 常见场景示例\n\n**1. 搜索词热度趋势**\n```\n筛选美国站，关键词\"gift\"在过去12周的搜索热度排名。\n```\n\n**2. 上升黑马关键词**\n```\n筛选美国站，关键词包含\"gift\"，2025年Q1和全年的平均搜索排名都大于50万，但最新排名冲进5万-10万的搜索词。\n```\n\n**3. 持续增长趋势发现**\n```\n筛选美国站，最新排名在20万以内，且4周前的排名比8周前提"},{"path":"references/linkfox-amazon-alexa-search.md","content":"---\nname: linkfox-amazon-alexa-search\ndescription: 模拟亚马逊前台 Alexa 购物助手，通过自然语言多轮问答获取导购建议、推荐商品分组及相关 ASIN 列表。\n---\n\n# 亚马逊 Alexa 购物助手（Amazon Alexa Shopping Assistant）\n\n本技能驱动亚马逊前台 Alexa 购物助手：用自然语言提问，获取导购回答、推荐商品分组（含 ASIN 与链接）以及可继续追问的问题。每次调用仅支持 1 条 prompt；多轮对话需由 agent 总结上文并拼接新问题发起新请求。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 通过亚马逊前台 Alexa 购物助手发起自然语言问答，获取导购回答与推荐商品分组（含 ASIN、标题、价格、评分、链接）。\n- 返回可继续追问的问题列表，支持 agent 总结上文后拼接新问题进行多轮对话。\n- 可用 `url` 锚定具体亚马逊页面（分类页 / 搜索结果页 / 商品详情页）作为对话上下文。\n- 支持 `markdown`（可读报告）与 `json`（结构化数据）两种输出格式。\n\n### ❌ 边界与限制\n\n- **每次仅 1 条 prompt**：`prompts` 数组只接受 1 个元素，不可一次传入多个问题。\n- **无跨调用记忆**：每次调用是全新的 Alexa 会话，追问须由 agent 总结上文 + 新问题作为 `prompts[0]` 重新发起。\n- **Alexa 驱动、非确定性**：相同 prompt 在不同时间/流量下可能返回不同答案。\n- **站点覆盖**：主要锚定 amazon.com 前台 Alexa 体验；非美国站点的可用性取决于 Alexa 上线情况。\n- **不传首页 URL**：`url` 仅在用户提供具体页面时传入；`https://www.amazon.com/` 这类首页 URL 不要传。\n- **不在范围内**：关键词 SERP 全量结果与排名（用前台搜索模拟技能）；历史搜索词分析或搜索量趋势（用 ABA 数据浏览器）；已知 ASIN 的商品详情/A+/五点（用亚马逊商品详情技能）；评论情感分析（用亚马逊评论技能）；以图搜款（用图片搜索技能）；对扁平商品列表的聚合统计。\n\n## 核心概念\n\n1. **单轮单问题**：`prompts` 是数组但只支持 **1 个元素**，每次调用发送 1 个问题并返回 1 个回答，不要传入多个元素。\n2. **跨调用无上下文**：每次调用都是全新 Alexa 会话。追问时 agent 须总结上一轮回答（关键推荐、ASIN、相关上下文），与新问题拼接后作为 `prompts[0]` 发起新请求。\n3. **可选页面上下文 `url`**：仅在需要把对话锚定到**具体**亚马逊页面（分类页、搜索结果页、商品详情页）时传入。不要传 `https://www.amazon.com/` 这类首页 URL——它不提供有用上下文。无具体页面时省略 `url`。\n4. **两种输出格式**：\n - `markdown`（默认）：一份可读 Markdown 报告，包含问题、Alexa 回答、推荐商品分组、可继续追问的问题。\n - `json`：`data` 下的结构化数组，每项含 `prompt`、`content`、`products`（分组推荐）、`followUpQuestions`、`screenshot`。\n\n`resultsNum` 为 Alexa 实际答复的对话轮次；为 `0` 表示 Alexa 未对该输入产生可用回答。\n\n## 调用方式\n\n- **API 端点**：`POST /amazon/alexaSearch`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/amazon_alexa_search.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-alexa-search-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 单轮购物提问**\n```json\n{\n \"prompts\": [\"best wireless earbuds for running on Amazon US under $100\"]\n}\n```\n\n**2. 追问（agent 总结上文后重新提问）**\n\n首次调用：\n```json\n{\n \"prompts\": [\"best electric kettle on Amazon US\"]\n}\n```\n\n第二次调用（agent 总结上一轮回答并拼接追问）：\n```json\n{\n \"prompts\": [\"Previously Alexa recommended: 1) Cosori Electric Kettle (B07T1KY5TZ, $35.99, 4.7★), 2) Mueller Ultra Kettle (B09KC7D3HR, $29.97, 4.5★). Now compare these two on noise level and boil time.\"]\n}\n```\n\n**3. 锚定到分类页的问题**\n```json\n{\n \"prompts\": [\"What are the most popular picks on this page?\"],\n \"url\": \"https://www.amazon.com/s?k=electric+kettle\"\n}\n```\n\n**4. 结构化输出便于下游提取**\n```json\n{\n \"prompts\": [\"best gift ideas"},{"path":"references/linkfox-amazon-opportunity-report-by-keyword.md","content":"---\nname: linkfox-amazon-opportunity-report-by-keyword\ndescription: 按关键词查询亚马逊商业洞察报告，包含市场潜力、产品特征、用户评论、人群画像、搜索趋势及定价分析。\n---\n\n# 亚马逊-机会报告（Amazon Market Opportunity Report）\n\n本技能用于按关键词生成亚马逊商业洞察报告，帮助卖家基于数据做出选品与市场进入决策。参数与响应字段详见 [references/api.md](references/api.md)。\n\n## 能力边界\n\n### ✅ 能力范围\n\n- 按关键词生成亚马逊商业洞察报告，基于实时亚马逊数据由 AI 分析六大维度：市场潜力、产品特征、用户评论、客户画像、搜索趋势、定价分析。\n- 报告以结构化 Markdown 文档形式交付，作为选品与市场进入的决策支持。\n\n### ❌ 边界与限制\n\n- **仅支持美国站**：当前 `site` 仅支持 `US`（美国市场），用户请求其他站点时需告知本工具暂不支持。\n- **非结构化输出**：返回 Markdown 报告，而非结构化 JSON 数据；不能与数据查询工具配合做二次聚合分析。\n- **生成耗时**：报告涉及 AI 分析，耗时长于普通数据查询。\n- **快照数据**：报告反映生成时点的数据，不会持续更新。\n- **不在范围内**：实时关键词排名追踪（用 ABA 或 SIF 工具）；单品详情查询（用商品详情工具）；历史价格追踪（用 Keepa）；指定 ASIN 的评论级分析（用评论工具）；广告/PPC 策略。\n\n## 核心概念\n\n本工具通过分析亚马逊关键词的六大核心维度，生成综合商业洞察报告：\n\n1. **市场潜力（Market Potential）**：搜索量、需求趋势与增长机会。\n2. **产品特征（Product Characteristics）**：常见商品属性、材质、功能。\n3. **用户评论（User Reviews）**：客户情感、痛点与满意度驱动因素。\n4. **客户画像（Customer Profile）**：买家人群特征、偏好与行为模式。\n5. **搜索趋势（Search Trends）**：关键词热度走势与季节性。\n6. **定价分析（Pricing Analysis）**：价格分布与竞争价格格局。\n\n报告由 AI 基于实时亚马逊数据生成，以结构化 Markdown 文档交付。它是用于决策支持的快照分析，而非实时监控工具。\n\n## 调用方式\n\n- **API 端点**：`POST /amazon/opportunity/reportByKeyword`（完整参数/响应/错误码见 `references/api.md`）\n- **Python 脚本**：`python scripts/amazon_opportunity_report.py '' [--inline]`\n- **成本约束**：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。\n\n**输出策略（脚本默认行为）**：\n- **始终**将完整响应写入 `/linkfox///data/linkfox-amazon-opportunity-report-by-keyword-.json`（`` 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；`` 取自环境变量 `SESSION_ID`，按用户任务自动聚合；**禁止写入 /tmp**，当前目录不可写则报错）\n- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout\n- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 `total`/`costToken`、最大列表字段的长度 + 前 3 条样本）\n- 加 `--inline` 强制全量打印到 stdout（同样落盘）\n\n**读数据建议**：先看摘要判断是否足够；需要具体字段时优先用 `jq` 或 `ConvertFrom-Json` 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。\n\n## 使用示例\n\n**1. 基础商业洞察报告**\n```\n帮我搜索美国站，关键词是 hair mousse travel size 的商业洞察报告\n```\n\n**2. 细分品类调研**\n```\n帮我生成美国站关键词 magnetic shelves for whiteboard 的商业洞察报告\n```\n\n**3. 趋势选品**\n```\n我想了解美国站 solar power ac unit 这个关键词的商业洞察，帮我生成报告\n```\n\n## 展示规则\n\n1. **直接呈现报告**：API 在 `stdout` 字段返回 Markdown 格式报告，原样展示给用户。\n2. **不做主观建议**：呈现 AI 生成的分析，不添加自己的商业建议。\n3. **说明数据范围**：提醒用户报告基于时点快照，作为决策参考。\n4. **错误处理**：查询失败时，依据 `msg` 字段说明原因，并建议检查关键词或重试。\n5. **不支持二次分析**：本工具的输出不能作为数据查询工具的输入做进一步处理，若用户尝试需告知限制。\n\n## 用户表达与场景速查\n\n**适用** —— 关键词级别的综合市场分析：\n\n| 用户说 | 场景 |\n|--------|------|\n| \"帮我分析这个关键词的市场机会\" | 市场机会评估 |\n| \"给 XX 生成一份市场洞察报告\" | 完整洞察报告 |\n| \"XX 的竞争格局如何\" | 竞争与定价分析 |\n| \"XX 产品的消费者画像\" | 客户行为洞察 |\n| \"XX 这个关键词值不值得做\" | 市场进入评估 |\n| \"选品报告\"、\"商业洞察\" | 中文市场调研请求 |\n\n不适用场景见上方【能力边界】。\n\n**边界判断**：当用户提到\"市场分析\"或\"选品调研\"时，若希望获得关键词市场机会的整体多维度概览，则适用本技能；若需要具体数据点（精确销量、单品详情、关键词历史排名），应引导至对应专项工具。\n\n## 解决认证和积分问题\n发生以下异常情况时，采用以下措施来处理：\n\n### 异常情况\n- **未配置 API Key**：环境变量未配置 `LINKFOX_AGENT_API_KEY`，也未配置 `LINKFOXAGENT_API_KEY`。\n- **响应 401 或 402 状态码**\n- **响应提示积分或余额不足**：消息含\"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值\"，或类似含义的内容。\n\n### 措施\n- 优先采用 skill 内的 onboarding.md 引导解决问题。\n- 如找不到 onboarding.md 文件，则加载 /linkfox"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。 Skill: Linkfox 亚马逊选品 Owner: linkfox-ai Summary: 亚马逊选品一站式 AI 工具集，整合 竞品查询/ABA/前台/Keepa/Sorftime/Jungle Scout/卖家精灵/SIF/极目/商业洞察等 12 类工具 33 项子能力，覆盖选品、关键词、竞品、评论、利基与趋势。 Tags: latest:1.2.3 Version history: v1.2.3 | 2026-08-14T14:43:39.724Z | user Update from 1.2.2 to 1.2.3 v1.2.2 | 2026-08-07T10:40:30.197Z | user Update from 1.2.1 to 1.2.2 v1.2.1 | 2026-08-05T08:58:14.340Z | user Update from 1.2.0 to 1.2.1 v1.2.0 | 2026-07-1","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":997,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T22:53:05.635Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T22:53:05.635Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-12T12:05:15.956Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}