linkfox-jiimore-product-discovery

Jiimore 产品发现

此技能将指导你如何使用 Jiimore 产品发现引擎发掘并挖掘高潜力 Amazon 商品，帮助 Amazon 卖家根据关键词筛选转化率、点击量增长和盈利能力等指标，从而找到潜在的畅销商品。

核心概念

Jiimore 产品发现是一款由关键词驱动的 Amazon 商品挖掘工具。输入搜索关键词后，它会返回符合指定表现指标的商品列表，例如转化率、点击量增长率、毛利率、价格、评论数和商品上架时间。因此，它非常适合用于发现新兴机会、验证商品创意和进行竞争对标。

必须提供关键词：每次查询都必须包含 keyword。关键词应翻译为目标市场使用的语言（例如，JP 使用日语，DE 使用德语）。

比率值为小数：转化率和增长率以 0 到 1 之间的小数表示。例如，0.1 表示 10%，0.25 表示 25%。用户以百分比指定数值时，这一点很容易引起混淆。

支持的市场：目前支持 US（美国）、JP（日本）和 DE（德国）。默认市场为 US。如果用户未指定市场，请使用 US。

参数指南

必填参数

参数	说明	示例
keyword	搜索关键词（必须翻译为目标市场使用的语言）	无线充电器

筛选参数

参数	说明	值格式
priceMin / priceMax	商品价格范围	数字（例如，10.0、50.0）
totalReviewsMin / totalReviewsMax	评论数范围	整数（例如，0、500）
customerRatingMin / customerRatingMax	客户评分范围	数字（例如，4.0、5.0）
clickConversionRateMin / clickConversionRateMax	点击到购买的转化率	小数 0-1（0.1 = 10%）
clickConversionRateCompositeMin / clickConversionRateCompositeMax	综合转化率	小数 0-1（0.1 = 10%）
clickCountT7Min / clickCountT7Max	每周点击量范围	整数
clickCountT30Min / clickCountT30Max	每月点击量范围	整数
clickCountGrowthT7Min / clickCountGrowthT7Max	每周点击量增长率	小数 0-1（0.1 = 10%）
clickCountGrowthT30Min / clickCountGrowthT30Max	每月点击量增长率	小数 0-1（0.1 = 10%）
salesVolumeT360Min / salesVolumeT360Max	年销量范围	整数
grossProfitMarginMin / grossProfitMarginMax	毛利率范围	数字
fbaFeeMin / fbaFeeMax	FBA 费用范围	数字
launchDateMin / launchDateMax	商品上架日期范围	字符串：yyyyMMdd000000
nicheCountMin / nicheCountMax	细分市场数量范围	整数
sellerCountry	卖家来源国家代码（多个代码以逗号分隔）	CN,US
countryCode	目标市场（US、JP、DE）	US

排序与分页

参数	说明	默认值
sortField	排序字段（见下方选项）	purchasedClicksT360
sortType	排序方向：desc 或 asc	desc
page	页码	1
pageSize	每页结果数（10-100）	50

可用排序字段：totalReviews、price、launchDate、clickCountT7、clickCountT30、clickCountT90、clickConversionRate、clickConversionRateComposite、customerRating、purchasedClicksT360、clickCountGrowthT7、clickCountGrowthT30、currentPrice、fbaFee、shippingFee、gpm

调用方式

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

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-product-discovery-<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/套餐到期/需充值/请充值”，或类似含义的内容。

使用示例

1. 查找美国市场高转化率的无线充电器

{
  "keyword": "wireless charger",
  "countryCode": "US",
  "clickConversionRateMin": 0.1,
  "sortField": "clickConversionRate",
  "sortType": "desc"
}

2. 发掘快速增长的新产品（上架时间在最近 6 个月内，每周点击量增长 > 20%）

{
  "keyword": "desk lamp",
  "countryCode": "US",
  "launchDateMin": "20250901000000",
  "clickCountGrowthT7Min": 0.2,
  "sortField": "clickCountGrowthT7",
  "sortType": "desc"
}

3. 查找定价偏低、利润率高且竞争较小（评论较少）的产品

{
  "keyword": "phone stand",
  "countryCode": "US",
  "priceMin": 10,
  "priceMax": 30,
  "totalReviewsMax": 100,
  "grossProfitMarginMin": 0.3,
  "sortField": "gpm",
  "sortType": "desc"
}

4. 挖掘中国卖家在德国市场中月点击量增长强劲的产品

{
  "keyword": "Handyhuelle",
  "countryCode": "DE",
  "sellerCountry": "CN",
  "clickCountGrowthT30Min": 0.15,
  "sortField": "clickCountGrowthT30",
  "sortType": "desc"
}

5. 查找日本市场中评分高且年销量强劲的产品

{
  "keyword": "ワイヤレスイヤホン",
  "countryCode": "JP",
  "customerRatingMin": 4.0,
  "salesVolumeT360Min": 1000,
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}

6. 识别综合转化率高且涉及多个细分市场的利基机会

{
  "keyword": "yoga mat",
  "countryCode": "US",
  "clickConversionRateCompositeMin": 0.15,
  "nicheCountMin": 3,
  "sortField": "clickConversionRateComposite",
  "sortType": "desc"
}

显示规则

1. 清晰呈现数据：使用结构清晰的表格展示查询结果，包括产品标题、ASIN、价格、评分、转化率、点击量和增长率
2. 比率格式：为便于阅读，始终以百分比显示比率值（例如，将 0.12 显示为 12%）。提醒用户 API 接受小数（0-1）
3. 图片展示：有产品图片 URL 时，在数据旁展示产品主图
4. 分页提示：结果跨越多页时，告知用户总数和当前页，并询问是否获取更多页面
5. 关键词翻译提醒：提醒用户关键词必须使用目标市场语言（美国用英语，JP 用日语，DE 用德语）
6. 错误处理：查询失败时，根据响应说明原因，并建议调整查询条件
7. 不提供主观建议：仅呈现客观产品数据，不提供主观商业建议

重要限制

• 关键词必填：每次查询都必须提供关键词；不支持不带关键词浏览
• 仅支持三个市场：目前仅限 US、JP 和 DE
• 每页结果数量上限：每页最多 100 条结果
• 比率值：所有比率/百分比参数都必须以小数（0-1）传入，而非百分比
• 上架日期格式：必须严格遵循 yyyyMMdd000000 格式（例如，20250101000000）

用户表达与场景速查

适用——产品发现与挖掘任务：

用户表达	场景
“查找关键词 X 的热门产品”	基于关键词的产品发现
“高转化产品”、“畅销产品”	高转化产品筛选
“快速增长的产品”、“热门商品”	基于点击增长的产品发现
“具有高潜力的新品”	新品上架 + 增长筛选
“利润空间大的产品”、“盈利能力强的商品”	毛利率筛选
“竞争较小的产品”、“评论较少的产品”	低评论数机会挖掘
“中国卖家的产品”	卖家来源筛选
“细分市场机会”	基于细分市场数量的产品发现

不适用——超出产品发现范围的需求：

• ABA 搜索词数据和关键词分析（使用 ABA Data Explorer）
• 广告 / PPC 广告活动管理
• 产品评论和商品信息优化
• 库存管理和供应链
• 包含利润 / 定价策略的综合市场报告

算力消耗规则

消耗 9 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

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

1. 此技能所描述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户对技能表示不满或赞赏
4. 任何你认为可以改进的地方

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

---

如需更多高质量、专业的跨境电商技能，请设置 LinkFox Skills。