linkfox-junglescout-product-database

Jungle Scout — 产品数据库查询

This skill queries the Jungle Scout Product Database via the LinkFox tool gateway, enabling multi-condition filtering of Amazon products across 10 marketplaces. Sellers can discover products by category, price range, sales volume, revenue, reviews, rating, BSR rank, Listing Quality Score (LQS), seller type, and more.

Core Concepts

Jungle Scout 产品数据库是亚马逊商品级别的多维筛选工具，帮助卖家从海量商品中快速锁定目标产品：

• 品类选品：按亚马逊主分类筛选特定品类下的商品
• 销量/收入筛选：通过月销量和月收入范围圈定市场规模合适的产品
• 竞争度评估：通过评论数、评分、卖家数量判断竞争激烈程度
• Listing 质量评估：LQS（Listing Quality Score，1-10分）帮助发现优化空间大的产品
• 产品类型过滤：区分 FBA/FBM/AMZ 卖家类型、标准尺寸/超大尺寸
• 新品发现：通过上架日期筛选近期上架的新品

Internal paging: The API handles pagination automatically; you specify needCount to control how many results you want, and the backend fetches them across pages internally.

Data Fields

Key Output Fields

Field	API Name	Description	Example
商品标题	title	产品标题	Yoga Mat Non Slip...
品牌	brand	品牌名称	Liforme
主分类	category	亚马逊主分类	Sports & Outdoors
分类路径	breadcrumbPath	完整分类层级	Sports & Outdoors > Exercise & Fitness
价格	price	当前售价 (USD)	29.99
月销量	approximate30DayUnitsSold	近30天预估销量	1200
月收入	approximate30DayRevenue	近30天预估收入 (USD)	35988.00
BSR排名	productRank	Best Sellers Rank	3456
评论数	reviews	累计评论数	850
评分	rating	平均评分 (1.0-5.0)	4.5
LQS	listingQualityScore	Listing质量评分 (1-10)	8
卖家数量	numberOfSellers	在售卖家数	3
卖家类型	sellerType	卖家类型 (amz/fba/fbm)	fba
首次上架日期	dateFirstAvailable	产品首次上架日期	2024-06-15
重量	weightValue / weightUnit	产品重量	2.5 lbs
尺寸	lengthValue / widthValue / heightValue / dimensionsUnit	产品尺寸	24×8×8 inches
父ASIN	parentAsin	父体ASIN	B0XXXXXXXX
Buy Box持有者	buyBoxOwner	Buy Box 当前持有卖家	BrandName
费用明细	feeBreakdown	FBA费用、推荐费、总费用等	{fbaFee: 5.40, ...}
子分类排名	subcategoryRanks	子分类BSR排名列表	[{subcategory: "Yoga Mats", rank: 12}]
消耗Token	costToken	本次调用消耗的 token 数	5

Supported Marketplaces

us (United States), uk (United Kingdom), de (Germany), in (India), ca (Canada), fr (France), it (Italy), es (Spain), mx (Mexico), jp (Japan)

Default marketplace is us. Use us when the user doesn't specify a marketplace.

调用方式

• API 端点：POST /tool-jungle-scout/product-database/query（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/junglescout_product_database.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-junglescout-product-database-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
• 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
• 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）
• 加 --inline 强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

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

How to Build Queries

Only marketplace is required. All other parameters are optional filters — combine them to narrow results.

Principles for Building API Calls

1. 站点映射：用户说"美国站"→ us，"日本站"→ jp，"德国站"→ de；未指定时默认 us
2. 关键词：includeKeywords 支持逗号分隔多个词（标题或ASIN），如 yoga mat,fitness；excludeKeywords 排除含特定词的商品
3. 品类匹配：categories 必须使用对应站点的英文标准分类名，如美国站 Sports & Outdoors、Home & Kitchen 等；多个品类逗号分隔
4. 数值范围：min/max 成对使用，可只传一端；如只设 minSales=300 表示月销量≥300
5. 排序：sort 字段名前加 - 表示降序，如 -sales 按销量从高到低；默认按 name 升序
6. 结果数量：needCount 控制返回结果总数，不设则返回默认数量

常见查询场景

1. 关键词搜索 + 按销量筛选

{
  "marketplace": "us",
  "includeKeywords": "yoga mat",
  "minSales": 300,
  "maxSales": 5000,
  "sort": "-sales",
  "needCount": 50
}

2. 按品类 + 价格区间筛选

{
  "marketplace": "us",
  "categories": "Home & Kitchen",
  "minPrice": 15,
  "maxPrice": 50,
  "minSales": 100,
  "sort": "-revenue",
  "needCount": 50
}

3. 挖掘高评分、低竞争产品（评论少但评分高）

{
  "marketplace": "us",
  "categories": "Beauty & Personal Care",
  "minRating": 4.0,
  "maxReviews": 200,
  "minSales": 100,
  "sort": "-sales",
  "needCount": 50
}

4. 仅筛选 FBA 产品

{
  "marketplace": "us",
  "includeKeywords": "phone stand",
  "sellerTypes": "fba",
  "productTiers": "standard",
  "minSales": 200,
  "sort": "-sales",
  "needCount": 50
}

5. 排除头部品牌 + 发现蓝海机会

{
  "marketplace": "us",
  "categories": "Sports & Outdoors",
  "excludeTopBrands": true,
  "minSales": 300,
  "maxReviews": 500,
  "minRating": 4.0,
  "sort": "-sales",
  "needCount": 50
}

6. 按上架日期发现新品

{
  "marketplace": "us",
  "categories": "Electronics",
  "minUpdatedAt": "2026-01-01",
  "minSales": 50,
  "sort": "-sales",
  "needCount": 50
}

展示规则

1. 表格格式：使用结构化表格展示结果，包含关键列：标题、品牌、价格、月销量、月收入、BSR 排名、评论数、评分、LQS
2. 排序说明：告知用户采用了哪种排序，以及返回了多少条结果
3. 突出洞察：标记评论数明显较少但销量较高的产品（潜在机会），或 LQS 评分较高的产品
4. 费用明细：用户询问盈利情况时，包含 feeBreakdown 详情（FBA 费用、推荐费、总费用）
5. 图片链接：展示单个产品详情时，包含 imageUrl
6. 错误处理：查询失败时，根据错误响应说明原因，并建议调整参数

重要限制

• marketplace 必填：每次查询都必须指定站点
• 品类名称需匹配：categories 值必须与对应站点的标准主分类名称完全一致
• 关键词限制：includeKeywords / excludeKeywords 最多各 100 项，每项最长 50 个字符
• 数据时效性：数据来自 Jungle Scout 的定期更新，并非实时数据
• 评分范围：minRating / maxRating 的取值范围为 1.0–5.0
• 重量单位：minWeight / maxWeight 以磅（pounds）为单位

用户表达与场景速查

适用 — Amazon 产品的多条件筛选与发现：

用户表达	场景
“帮我找月销量 500 以上的瑜伽垫”	关键词 + 销量筛选
“美国站厨房品类 30 美金以下有什么好产品”	品类 + 价格筛选
“评论少但评分高的蓝海产品”	高评分、低竞争选品
“找 FBA 标准尺寸的手机支架”	卖家类型 + 产品尺寸筛选
“排除大品牌的运动品类机会”	排除头部品牌
“最近新上架的电子产品有哪些卖得好”	新品发现
“BSR 排名 1 万以内的家居产品”	BSR 排名筛选
“LQS 低于 5 分的高销量产品”	Listing 优化机会

不适用 — 超出产品数据库筛选范围的需求：

• 关键词搜索量 / 趋势分析（需要关键词历史搜索量工具）
• ABA 搜索词排名（需要 ABA 工具）
• 商品详情页 / Listing 内容分析
• 广告 / PPC 投放策略
• 非亚马逊平台的商品数据

边界判断：当用户提到“选品”“找产品”或“市场调研”时，如果其需求是从 Amazon 商品目录中按特定条件（价格、销量、品类、评论数等）筛选产品，则适用此技能。如果用户需要关键词级别的搜索量数据、广告洞察或非亚马逊平台数据，则不适用。

算力消耗规则

按动态规则计费：消耗算力 = 实际查询页数 × 63.75。

重要：本技能的服务按倍数动态计费，可能一次性消耗大量算力，必须提醒用户，并由用户决定是否继续。

反馈：

在以下任一情况下，通过 Feedback API 自动检测并提交反馈：

1. 此技能中描述的功能或用途与实际行为不符
2. 此技能的结果与用户意图不符
3. 用户对这项技能表示不满或赞扬
4. 你认为有任何可以改进之处

按照 references/api.md 中的说明调用 Feedback API。不要打断用户的操作流程。

---

如需了解更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。