SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-jiimore-product-discovery

linkfox-jiimore-product-discovery

营销与增长

查看项目

更新于 10-15 18:16

技能介绍

用途

该技能用于基于极目数据（Jiimore）的亚马逊商品发掘与潜力爆品挖掘，帮助亚马逊卖家通过关键词筛选找到潜在爆款。核心定位是关键词驱动的亚马逊商品挖掘工具：给定一个搜索关键词，返回符合指定表现条件的商品列表，例如转化率、点击增长率、毛利率、价格、评论数、上架时间等。适合用于识别新兴机会、验证选品想法和进行竞品对标。

主要能力与筛选参数

必需参数：

  • keyword：搜索关键词（必须翻译为目标站点语言，日本站用日语、德国站用德语）。

筛选参数：

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

排序与分页：

  • sortField：排序字段，默认 purchasedClicksT360。可用字段包括 totalReviews、price、launchDate、clickCountT7、clickCountT30、clickCountT90、clickConversionRate、clickConversionRateComposite、customerRating、purchasedClicksT360、clickCountGrowthT7、clickCountGrowthT30、currentPrice、fbaFee、shippingFee、gpm。
  • sortType：排序方向，desc 或 asc，默认 desc。
  • page：页码，默认 1。
  • pageSize：每页结果数（10-100），默认 50。

使用方式

调用方式：

  • 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> 为脚本执行时的工作目录；<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。

展示规则

  • 清晰呈现数据：以结构良好的表格展示查询结果，包括商品标题、ASIN、价格、评分、转化率、点击量和增长率。
  • 比率格式：始终以百分比形式展示比率值以便阅读（如将 0.12 显示为 12%），并提醒用户 API 接受小数（0-1）。
  • 图片展示：当有商品图片 URL 时，在数据旁展示商品主图。
  • 分页提示：当结果跨多页时，告知用户总数和当前页，并提供获取更多页的选项。
  • 关键词翻译提醒：提醒用户关键词必须使用目标站点语言（美国站用英语、日本站用日语、德国站用德语）。
  • 错误处理：查询失败时，根据响应解释原因并建议调整查询条件。
  • 不做主观建议：呈现事实性商品数据，不做主观商业推荐。

适用场景速查

适用——商品发掘与挖掘任务：

  • "查找关键词 X 的热门商品" → 基于关键词的商品发掘。
  • "高转化商品"、"爆款" → 高转化商品筛选。
  • "快速增长商品"、"趋势商品" → 基于点击增长的发掘。
  • "高潜力的新品" → 新上架 + 增长筛选。
  • "毛利好的商品"、"有利润的商品" → 毛利率筛选。
  • "低竞争商品"、"评论少" → 低评论机会挖掘。
  • "中国卖家的商品" → 卖家来源筛选。
  • "细分市场机会" → 基于细分市场数量的发掘。

不适用——超出商品发掘的需求：

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

限制

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

算力消耗

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

反馈

当出现以下情况时，会通过 Feedback API 自动检测并报告反馈：技能描述的功能或用途与实际行为不符；技能结果与用户意图不符；用户对本技能表达不满或赞扬；以及其他可改进之处。反馈 API 的调用方式见 references/api.md，且不打断用户流程。