linkfox-sorftime-amazon-product-detail — скилл для Claude Code
Скилл linkfox-sorftime-amazon-product-detail для Claude Code и Codex выгружает данные о товаре на Amazon по коду ASIN через Sorftime. Собирает историю продаж, динамику BSR, комиссии FBA и цены на 14 региональных сайтах площадки.
MIT 233 установок ★ 125 обновлён 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a claude-codeЧто делает linkfox-sorftime-amazon-product-detail
Скилл принимает конкретный ASIN и запрашивает через Sorftime метрики карточки: дневную и месячную выручку, структуру затрат с комиссиями FBA, распределение отзывов, продавца Buybox и связи между родительскими и дочерними вариациями. История изменения цен и категорийного рейтинга BSR доступна с 2021 года.
Выполнение запускается напрямую или через скрипт python scripts/sorftime_product_detail.py '<JSON>'. Ответ сохраняется в локальный JSON-файл в каталоге проекта и кэшируется на 24 часа, а в консоль выводится сводка, если ответ превышает 8 КБ. Без ключа LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY запросы вернут ошибку авторизации 401. Каждый вызов списывает вычислительные токены сервиса по формуле «число внутренних обращений × 6», поэтому агент запрашивает подтверждение перед началом платного сбора истории.
Какие задачи решает
- проверить историю продаж и колебания цен по конкретному ASIN
- рассчитать чистую прибыль с учётом комиссий и тарифов FBA
- отследить динамику позиций товара в BSR по категориям
- сравнить показатели нескольких товаров в рамках одного регионального сайта
Примеры запросов агенту
- Проверь данные и динамику продаж для B00FLYWNYQ на американском Amazon
- Сравни комиссии FBA и маржинальность для B0088PUEPK и B00U26V4VQ
- Покажи историю рейтинга BSR товара B0CVM8TXHP в Германии с июня 2024 года
Как установить linkfox-sorftime-amazon-product-detail
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a claude-code2Вручную: положить файлы
~/.claude/skills/linkfox-sorftime-amazon-product-detail/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/linkfox-sorftime-amazon-product-detail/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a codex2Вручную: положить файлы
.agents/skills/linkfox-sorftime-amazon-product-detail/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a cursor2Вручную: положить файлы
.cursor/skills/linkfox-sorftime-amazon-product-detail/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-sorftime-amazon-product-detail2Вручную: положить файлы
.github/skills/linkfox-sorftime-amazon-product-detail/SKILL.md1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a gemini-cli2Командой платформы
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-sorftime-amazon-product-detailВручную: положить файлы
.devin/skills/linkfox-sorftime-amazon-product-detail/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о linkfox-sorftime-amazon-product-detail
Как установить linkfox-sorftime-amazon-product-detail в Claude Code?
Выполните команду npx skills add linkfox-ai/linkfox-skills --skill linkfox-sorftime-amazon-product-detail -a claude-code.
Что делает linkfox-sorftime-amazon-product-detail?
Скилл извлекает из Sorftime аналитику по заданному коду ASIN: графики продаж, срез BSR, вариации, цены со скидками и расчёт FBA.
Что требуется для работы скилла?
Нужен ключ в переменной окружения LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY и доступный Python для запуска локального скрипта.
Исходный текст
SKILL.md · MIT
--- name: linkfox-sorftime-amazon-product-detail description: 基于 Sorftime 数据按 ASIN 查询亚马逊商品详情与历史趋势,覆盖 14 个站点,提供销量与销售额、价格与促销、多级 BSR、变体、评分、卖家、利润和 FBA 费用信息。适用于指定商品查询、趋势回顾及多商品对比,无需明确提及 Sorftime。不适用于跨市场搜品筛选、ABA 搜索词排名、广告策略、评论正文分析或专利商标检查。 --- # Sorftime 亚马逊商品详情与趋势 ## 适用范围 ### 适用 用户已有具体 ASIN,希望查看商品资料、经营指标或历史变化时使用。用户说“产品分析”或“竞品对比”且实际需要查询指定 ASIN 的详情和趋势时,也适用。 **场景速查** | 用户表达 | 查询场景 | |----------|----------| | 查一下这个 ASIN 的销量走势 | 日销量、月销量与销售额趋势。 | | 这个产品最近价格变化如何 | 售价、原价与促销历史。 | | 帮我看看这个产品的利润空间 | 利润金额、利润率与费用构成。 | | 这个 ASIN 的 BSR 排名趋势 | 大类及小类排名历史。 | | 对比一下这几个 ASIN 的数据 | 同站点多商品对比。 | | 这个产品的 FBA 费用是多少 | FBA 费用及配送、仓储明细。 | | 产品上架多久了,评分怎么样 | 上架时间、在售天数、评分及星级占比。 | | 这个产品还在售吗 | 在售或下架状态。 | | 这个产品有没有 Deal 促销记录 | Deal 历史与其他促销。 | | 看看这个产品的变体信息 | 父子 ASIN、变体数及属性。 | ### 边界 按类目、品牌或卖家发现和筛选商品时,使用 Sorftime 商品搜索技能。ABA 搜索词排名使用对应 ABA 数据技能;广告策略、评论正文分析和专利商标检查不在本技能范围。 ## 前置条件 先确定待查商品的 ASIN 和目标站点。站点选择、默认值及趋势范围约定见 `references/api.md`。 ## 查询流程 1. 判断用户需要指定商品详情还是跨市场发现商品,确认 ASIN 与站点;按 `references/api.md` 准备查询。 2. 根据目标选择仅查资料或包含趋势;历史分析按用户需要确定日期范围,多商品对比优先在同站点批量查询,具体限制见接口参考。 3. 调用前说明动态计费方式及本次范围可能带来的额外消耗,由用户决定是否继续;复用已有结果与本地缓存。 4. 查询后先判断公共响应状态,再判断业务结果;失败时根据返回消息解释原因,后续调用遵守成本约束。 5. 从保存的数据按需提取指标,用表格展示商品对比或趋势关键日期,遵守下方展示建议。 ## 执行方式 - **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。 - **脚本调用(推荐)**:`python scripts/sorftime_product_detail.py '<JSON 参数>' [--inline]`。 - **成本约束**:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。 ### 输出策略 - 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sorftime-amazon-product-detail-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。 - 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。 - 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。 - 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。 先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。 ## 执行规则 ### 算力消耗预估 按动态规则计费:消耗算力 = Sorftime 内部查询次数 × 6。不同查询条件所需的内部查询次数可能不同,由 Sorftime 决定;趋势范围的额外计费约定见 `references/api.md`。 > **重要**:本技能的服务按倍数动态计算,可能一次性消耗大量算力,必须提醒用户,由用户决定是否继续。 **声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。 用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。 ### 解决认证和算力问题 出现以下情况时,按 `references/onboarding.md` 的指引处理: - 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。 - 响应状态码为 `401` 或 `402`。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。 ### 约束与建议 - **理解数据范围**:本技能提供单商品资料及时间序列,历史趋势可追溯至 2021 年,实际以返回数据为准。可展示基本资料与主图/A+ 图片、父子变体、价格与利润、官方月销量、类目排名、评分分布、Buybox 卖家、Listing 特征和促销;完整字段定义见 `references/api.md`。 - **清晰展示数据**:只呈现查询所得数据,用表格说明指标,不附加主观经营建议;注明站点、日期范围和更新时间。 - **解释排名**:展示 BSR 时提醒用户数值越小排名越靠前,并区分大类和小类。 - **区分金额口径**:展示趋势金额时按当地货币单位换算,美元美分转换为美元;区分扣除 Coupon 后的当前售价与未扣 Coupon 的售价趋势,具体单位和特殊值见接口参考。 - **解释无法预估的数据**:销量或销售额不可用时标为“无法预估”,不要把缺失值当成零销量。非标准类目情形见接口参考。 - **展示趋势关键点**:先按接口参考的交错格式还原日期和值,用可读的表格呈现,避免直接输出原始数组。 - **说明在售状态**:商品下架或不可售时明确告知用户。 - **解释错误**:结合接口参考及实际返回的消息说明失败原因,可建议核对查询条件;再次调用前说明额外消耗。 ## 使用示例 ### 快速查看商品 用户:查一下 B00FLYWNYQ 的商品资料和近期走势。 未指定站点时按接口参考采用默认站点;说明费用后查询,展示资料与近期趋势。 ### 长区间趋势与 BSR 历史 用户:查看这个美国站商品 2025 年第一季度的销量趋势,或这个德国站商品 2024 年 6 月至 2025 年 1 月的 BSR 历史。 按用户指定站点和日期范围准备查询,说明趋势范围对应的额外费用后执行,按日期展示关键数据。 ### 多商品对比或仅查资料 用户:对比 B0088PUEPK、B00U26V4VQ、B0CVM8TXHP;只需要基本资料时不查趋势。 按接口参考批量查询,按需关闭趋势以减少消耗、缩短响应时间,用表格比较已有数据。 ## 使用反馈 当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。 --- 更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。
© linkfox-ai · MIT · linkfox-ai/linkfox-skills