skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
linkfox-ai/linkfox-skills231 installs

linkfox-sorftime-amazon-product-query

基于 Sorftime 数据搜索和筛选亚马逊商品,覆盖 14 个站点,支持按相似 ASIN、类目、品牌、卖家、ABA 关键词、标题属性、价格、销量、季节性等条件发现和对比商品,并回看历史月份快照。适用于选品探索、竞品发现、类目研究、新品筛选和卖家商品组合研究,无需明确提及 Sorftime。不适用于单个 ASIN 的详细历史趋势、ABA 搜索量或搜索词排名、广告策略、评论正文分析或专利商标核查。

How do I install this agent skill?

npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-query
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides Amazon product research capabilities and includes a setup process for authentication and billing. It carries a low risk of indirect prompt injection from processing third-party data and suggests standard but permanent environment configuration for API keys.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Sorftime 亚马逊产品搜索

适用范围

适用

按多种条件发现、筛选和比较亚马逊商品,或将历史月份快照与当前数据进行对照。 用户说“竞品分析”或“市场调研”时,若需要从类目、品牌、卖家或其他条件出发寻找商品,使用本技能。

场景速查

用户表达查询场景
找一下这个类目下卖得好的产品类目探索。
Anker 品牌有哪些热销产品品牌商品组合研究。
这个 ASIN 的竞品有哪些相似商品发现。
帮我找一些季节性产品按旺季月份寻找商品。
新品中月销量超过 500 的有哪些新品与销量组合筛选。
去年双十一这个类目的价格快照历史月份快照对比。
这个卖家还卖了什么产品按卖家名称或 ID 查商品组合。
帮我筛选利润率高于 30% 的 FBA 产品先查配送条件,再按已返回的利润指标整理。
月销量 1000 以上,评分 4 星以上的产品多条件组合筛选。
标题包含 wireless charger 的产品标题或属性匹配。
用 ABA 关键词 Power Bank 找产品按 ABA 关键词寻找商品。

边界

  • 单个 ASIN 的销量、价格、BSR 历史趋势转交 Sorftime 商品详情技能;相似 ASIN 搜索用于发现竞品。
  • ABA 搜索量或搜索词排名转交 ABA 数据探索技能。
  • 广告或 PPC 策略、评论正文分析、专利或商标核查不属于本技能范围。

前置条件

确定查询目标与站点,准备用户提供的 ASIN、类目编号、品牌、卖家或筛选条件。构造请求前阅读 references/api.md,核对查询模式、条件格式与历史回看支持范围。

查询流程

  1. 确定用户要发现哪些商品,以及是否需要历史快照。未指定站点时采用接口定义中的默认站点约定。
  2. 根据单一目标或组合条件选择查询方式,按 references/api.md 构造条件;核对单位、范围表达和组合条件的字段大小写。
  3. 调用前说明动态算力成本,并由用户决定是否继续;同一参数优先复用已有结果或本地缓存。
  4. 发起查询并查看摘要,按需读取已保存文件中的商品数据;仅在用户明确要求时翻页。失败或空结果时先解释原因,后续查询遵守成本约束。
  5. 需要历史对照时,先核对站点支持范围,在用户已决定承担额外消耗的范围内,分别查询历史月份与当前数据,再对照价格、排名及销量。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/sorftime_product_search.py '<JSON 参数>' [--inline]。
  • 成本约束:本工具按 Sorftime 内部查询次数 × 6 消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sorftime-amazon-product-query-<timestamp>.json。<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp,当前目录不可写时应报错。
  • 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
  • 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

消耗算力 = Sorftime 内部查询次数 × 6。不同查询条件可能需要不同次数,具体次数由 Sorftime 决定。

本服务按倍数动态计费,单次可能消耗大量算力;必须在调用前提醒用户,并由用户决定是否继续。

声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

解决认证和算力问题

出现以下情况时,按 references/onboarding.md 的指引处理:

  • 未配置接口密钥:LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
  • 响应状态码为 401 或 402。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 理解查询能力:支持多维度单条件或 AND 组合查询。历史快照用于比较不同月份的商品状态,不等同于单个 ASIN 的连续趋势曲线。
  • 明确数据覆盖:可查看商品基本资料、图片与变体,价格和利润,销量和销售额,BSR 与类目排名,评分、上架信息、Buybox 卖家与配送,以及 A+、视频和品牌店标记。完整字段及计算口径见 references/api.md。
  • 清晰展示数据:用表格展示查询结果,不附加主观商业建议;价格、销售额和利润注明站点币种,排名说明数值越小越好。
  • 说明估算口径:销量与销售额不可估算时展示“无法预估”,避免把占位值解释为实际负销量;具体取值约定见接口定义。
  • 利润筛选:依据返回的利润指标整理已取得的商品;服务端支持的筛选条件以接口定义为准,不添加未定义参数,也不把单页结果推断为全市场结果。
  • 说明分页情况:结果较多时先展示重点和本次返回范围,再提醒用户可以继续查看;分页上限见接口定义,后续调用遵守成本约束。
  • 解释失败:按接口文档判断响应,结合 msg、errmsg 或脚本保留的错误信息解释原因,建议用户核对查询条件;不得自动连续试探。

使用示例

发现竞品或浏览品牌、类目、卖家

用户:找这个 ASIN 的相似产品,再看看指定品牌或卖家有哪些商品。

根据用户指定目标逐项构造查询,展示匹配商品及返回范围。常见条件格式与示例见 references/api.md。

寻找新品、季节性商品或低价高销量商品

用户:找新品中销量较高的 FBA 商品,或者寻找第四季度旺季产品。

确定用户需要的条件组合,核对条件与单位后查询,按返回数据列出商品,不自动扩展筛选条件。

对比历史与当前数据

用户:对比这个类目去年十一月与现在的价格和销量。

核对历史回看支持范围,说明两次查询的动态消耗,在用户决定继续后获取两个时间口径的数据并列表对照。

使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。


更多优质、专业的跨境电商技能,请访问 LinkFox Skill。

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/linkfox-ai/linkfox-skills/linkfox-sorftime-amazon-product-query">View linkfox-sorftime-amazon-product-query on skillZs</a>