用途
本技能用于查询 Jungle Scout 产品数据库，通过 LinkFox 工具网关对亚马逊商品进行多条件筛选，帮助卖家从海量商品中快速锁定目标产品。查询结果覆盖 10 个站点，便于跨站点选品与市场调研。
主要能力
- 品类选品：按亚马逊主分类筛选特定品类下的商品，categories 需使用对应站点的英文标准分类名，如美国站 Sports & Outdoors、Home & Kitchen，多个品类可用逗号分隔。
- 销量/收入筛选：通过月销量和月收入范围圈定市场规模合适的产品，min/max 可成对使用或只传一端，如只设 minSales=300 表示月销量≥300。
- 竞争度评估：通过评论数、评分、卖家数量判断竞争激烈程度。评分范围 1.0–5.0。
- Listing 质量评估：LQS（Listing Quality Score，1–10 分）帮助发现优化空间大的产品。
- 产品类型过滤：区分 FBA/FBM/AMZ 卖家类型、标准尺寸/超大尺寸。
- 新品发现：通过上架日期筛选近期上架的新品。
- 关键词筛选：includeKeywords 支持逗号分隔多个词（标题或 ASIN），excludeKeywords 可排除含特定词的商品，两者最多各 100 项，每项最长 50 字符。
- 排除头部品牌：可排除头部品牌以发现蓝海机会。
- 排序与数量控制：sort 字段名前加 - 表示降序，如 -sales 按销量从高到低，默认按 name 升序；needCount 控制返回结果总数，不设则返回默认数量。
主要输出字段
商品标题、品牌、主分类、完整分类路径、价格（USD）、近 30 天预估销量、近 30 天预估收入（USD）、BSR 排名、累计评论数、平均评分、LQS、在售卖家数、卖家类型、首次上架日期、重量（磅）、尺寸、父 ASIN、Buy Box 持有卖家、费用明细（FBA 费用、推荐费、总费用等）、子分类 BSR 排名列表，以及本次调用消耗的 token 数。
支持站点
us（美国，默认）、uk（英国）、de（德国）、in（印度）、ca（加拿大）、fr（法国）、it（意大利）、es（西班牙）、mx（墨西哥）、jp（日本）。
使用方式
- API 端点：POST /tool-jungle-scout/product-database/query（完整参数、响应与错误码见 references/api.md）。
- Python 脚本：python scripts/junglescout_product_database.py '<JSON 参数>' [--inline]。
- 仅 marketplace 为必填，其余参数均为可选筛选条件，可组合使用。
- 输出策略：脚本默认将完整响应写入工作目录下的 linkfox/<日期>/<会话>/data/ 目录中的 JSON 文件；响应体 ≤ 8 KB 时打印完整 JSON，> 8 KB 时仅输出摘要；加 --inline 可强制全量打印。
适用场景示例
用户表达与对应场景包括：「帮我找月销量 500 以上的瑜伽垫」为关键词+销量筛选；「美国站厨房品类 30 美金以下有什么好产品」为品类+价格筛选；「评论少但评分高的蓝海产品」为高评分低竞争选品；「找 FBA 标准尺寸的手机支架」为卖家类型+产品尺寸筛选；「排除大品牌的运动品类机会」为排除头部品牌；「最近新上架的电子产品有哪些卖得好」为新品发现；「BSR 排名 1 万以内的家居产品」为 BSR 排名筛选；「LQS 低于 5 分的高销量产品」为 Listing 优化机会。
展示规则
结果以结构化表格呈现，关键列包括标题、品牌、价格、月销量、月收入、BSR 排名、评论数、评分、LQS；提示用户已应用的排序方式及返回结果数量；标注评论少但销量高的产品（潜在机会）或高 LQS 产品；用户询问盈利性时提供费用明细；展示单个商品详情时包含图片链接。
限制
- marketplace 必填，每次查询必须指定站点。
- categories 值必须与对应站点的标准主分类名完全一致。
- includeKeywords / excludeKeywords 最多各 100 项，每项最长 50 字符。
- 数据来源于 Jungle Scout 定期更新，非实时数据。
- minRating / maxRating 取值 1.0–5.0。
- minWeight / maxWeight 以磅（pounds）为单位。
- 不适用于以下需求：关键词搜索量/趋势分析（需关键词历史搜索量工具）、ABA 搜索词排名（需 ABA 工具）、商品详情页/Listing 内容分析、广告/PPC 投放策略、非亚马逊平台商品数据。
认证与算力
未配置 API Key（LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY）、响应 401 或 402、或提示算力/余额不足时，需按 references/onboarding.md 处理。本技能按实际查询页数动态计费（消耗算力 = 实际查询页数 × 63.75），可能一次性消耗大量算力，需提醒用户由其决定是否继续。同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存；失败或空结果不得自动换关键词、翻页或改邮编连续试探，需继续检索时应先向用户说明会产生额外消耗。