linkfox-seerfar-ozon-product-report-search — скилл для Claude Code
Скилл linkfox-seerfar-ozon-product-report-search для Claude Code и Codex подбирает товары на Ozon через Seerfar по продажам и конверсии. Возвращает отчёт по конкретным SKU и сохраняет JSON в локальную папку.
MIT 231 установок ★ 125 обновлён 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a claude-codeЧто делает linkfox-seerfar-ozon-product-report-search
Скилл фильтрует товары на Ozon по объёму продаж и выручке в рублях. Ещё можно отбирать карточки по цене и рейтингу, а также по конверсии в корзину, проценту возвратов и дате появления. Отчёт строится строго по отдельным SKU. Сводки по категориям и ключевые слова здесь недоступны.
Запросы выполняет скрипт scripts/seerfar_ozon_product_report_search.py, а правила API лежат в references/api.md. Ответы всегда сохраняются в <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/, но не в /tmp. При объёме свыше 8 KB в консоль попадает лишь сводка и первые 3 записи. Флаг --inline выводит весь JSON. Локальный кэш хранит данные 24 часа.
Для запуска нужен Python и переменная LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY. Без ключа или баланса сервер вернёт ошибку 401 или 402. Каждый запрос к API тратит 12 единиц вычислений LinkFox. Поэтому агент не перезапускает поиск с другими фильтрами при пустой выдаче, чтобы не сжигать баланс.
Какие задачи решает
- подобрать ходовые товары на Ozon по объёму продаж и потолку цены
- отследить новинки последних 30 дней с быстрым ростом заказов
- проверить продажи и рейтинг выбранных SKU конкурентов
- выгрузить отчёт по FBO-позициям выбранного бренда в рублях
Примеры запросов агенту
- Найди на Ozon товары до 500 рублей с продажами от 5000 в месяц и покажи отчёт по SKU.
- Отбери новинки на Ozon за последние 30 дней и отсортируй их по темпу роста продаж.
- Выгрузи показатели по SKU 2107989735 с разбивкой по выручке, рейтингу и возвратам.
Как установить linkfox-seerfar-ozon-product-report-search
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a claude-code2Вручную: положить файлы
~/.claude/skills/linkfox-seerfar-ozon-product-report-search/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/linkfox-seerfar-ozon-product-report-search/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a codex2Вручную: положить файлы
.agents/skills/linkfox-seerfar-ozon-product-report-search/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a cursor2Вручную: положить файлы
.cursor/skills/linkfox-seerfar-ozon-product-report-search/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-seerfar-ozon-product-report-search2Вручную: положить файлы
.github/skills/linkfox-seerfar-ozon-product-report-search/SKILL.md1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a gemini-cli2Командой платформы
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-seerfar-ozon-product-report-searchВручную: положить файлы
.devin/skills/linkfox-seerfar-ozon-product-report-search/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о linkfox-seerfar-ozon-product-report-search
Как установить linkfox-seerfar-ozon-product-report-search в Claude Code?
Выполните в терминале npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a claude-code. Скилл сохранится в ~/.claude/skills/linkfox-seerfar-ozon-product-report-search/SKILL.md.
Что делает linkfox-seerfar-ozon-product-report-search?
Скилл запрашивает у Seerfar отчёты по отдельным товарам Ozon с фильтрацией по продажам, выручке в рублях, цене, конверсии и рейтингу. Полный ответ сохраняется в рабочую папку в формате JSON, а в чат выводится таблица или сводка.
Что нужно для работы скилла и сколько стоит один запрос?
Для работы скрипта нужен Python и ключ API в переменной LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY. Один живой запрос к Seerfar списывает 12 единиц вычислений, а одинаковые запросы в рамках сессии кэшируются локально на 24 часа.
Исходный текст
SKILL.md · MIT
---
name: linkfox-seerfar-ozon-product-report-search
description: 按销量、销售额、增长率、价格、转化率、评分、评论数、品牌、卖家、配送方式、上架时间及利润物流指标筛选 Ozon 商品,返回商品级完整报表。适用于 Ozon 选品、竞品商品分析、热销和上升商品挖掘、价格带及转化带筛选,也可查询指定 SKU 的报表,无需明确提及 Seerfar。不适用于关键词市场数据、关键词挖掘、单店完整目录、类目汇总或其他平台研究。
---
# Seerfar Ozon 商品报表搜索
## 适用范围
### 适用
按多维指标筛选 Ozon 商品并查看商品级报表。每条记录对应一个 SKU,涵盖销量、销售额、损失销售额、转化率、评价、品牌、卖家、配送与上架时间等指标。
**场景速查**
| 用户表达 | 查询场景 |
|----------|----------|
| Ozon 选品,按销量和销售额筛选商品 | 商品筛选:组合指标范围并排序。 |
| 找 Ozon 热销商品或畅销品 | 畅销挖掘:结合畅销标签与销量排序。 |
| 找 Ozon 上升商品或新品爆款 | 新品研究:结合上架时间与增长排序。 |
| 找高转化、低退货商品 | 转化质量:结合购物车转化率与退货取消率。 |
| 看某品牌或卖家的商品表现 | 品牌或卖家筛选:比较商品报表。 |
| 查这几个 SKU 的报表 | 指定商品:查看命中商品的指标。 |
### 边界
- 关键词及搜索量市场数据转交 Seerfar Ozon 市场关键词搜索技能;种子词扩展转交关键词挖掘技能。
- 单店完整目录转交店铺搜索技能;类目商品及类目汇总转交类目搜索技能。
- 商品反查流量词转交关键词反查技能;其他平台数据不在本技能范围内。
## 前置条件
先明确筛选目的与统计区间;使用类目筛选时,从上游类目搜索数据取得编号。请求准备与使用限制见 `references/api.md`。
## 查询流程
1. 明确要查畅销、上升、价格带、转化质量,还是指定品牌、卖家或商品,按 `references/api.md` 准备请求。
2. 先选择核心排序指标:畅销看销量、上升看增长率、低价带看价格、高评分看评价;结合类目、品牌或卖家收窄范围,避免在数千万商品中无序翻页。
3. 按目的叠加范围筛选,例如销量下限与价格上限,或购物车转化率下限与退货取消率上限;研究新品需求时,结合上架时间与畅销标签。
4. 选择当前统计期或历史月份,执行一次查询;先看摘要,再按需读取已保存数据。失败、空结果和后续分页均遵守成本约束。
5. 用商品表格展示命中结果、统计区间及返回范围;错误时按接口文档解释原因,不自动连续改参试探。
## 执行方式
- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/seerfar_ozon_product_report_search.py '<JSON 参数>' [--inline]`。
- **成本约束**:每次接口请求消耗 12 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。
### 输出策略
- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-product-report-search-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。
- 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。
- 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
## 执行规则
### 算力消耗预估
12 算力 / 次
**声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
### 解决认证和算力问题
出现以下情况时,按 `references/onboarding.md` 的指引处理:
- 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。
- 响应状态码为 `401` 或 `402`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
### 约束与建议
- **商品级数据**:本技能返回商品报表,不能将商品行解释为关键词或类目整体数据。
- **只展示数据**:用清晰表格呈现指标,不附加主观开发建议。优先展示标题、SKU、价格、销量、销售额、评分、评论数,再展示品牌、卖家和配送方式。
- **标明币种**:价格、销售额和损失销售额以俄罗斯卢布(₽)展示,避免误读量级。
- **避免重复展示**:优先使用统一字段;原始字段与统一字段的六组对应关系见接口文档,不将别名当作独立指标。
- **说明返回范围**:展示本次商品行和匹配总数。结果较多时先展示前列商品,完整数据已保存,后续分页应说明额外消耗。
- **说明数据口径**:销量和销售额对应所选统计期;日期约定、匹配总数及重复数组的含义见接口文档。
- **解释异常**:按接口文档的公共响应规则判断结果,根据 `msg` / `errmsg` 解释原因;限流后等待再处理,不自行连续重试。
## 使用示例
### 当前畅销商品:按销量降序
```json
{"page": {"page": 1, "pageSize": 10, "orders": [{"field": "sales", "direction": "DESC"}]}}
```
### 高销量、低价格商品
```json
{"page": {"page": 1, "pageSize": 20, "orders": [{"field": "sales", "direction": "DESC"}]}, "monthlySales": {"min": 5000}, "price": {"max": 500}}
```
### 类目中的 FBO 畅销商品
```json
{"page": {"page": 1, "pageSize": 20, "orders": [{"field": "revenue", "direction": "DESC"}]}, "categoryIds": ["15621031_200000933_93182"], "fulfillment": ["FBO"], "labels": [2]}
```
### 近 30 天上架的商品:按增长率降序
```json
{"page": {"page": 1, "pageSize": 20, "orders": [{"field": "salesRate", "direction": "DESC"}]}, "creationDate": 1}
```
### 查询指定 SKU
```json
{"page": {"page": 1, "pageSize": 10}, "skus": [2107989735]}
```
## 使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。
---
更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。
© linkfox-ai · MIT · linkfox-ai/linkfox-skills