linkfox-seerfar-ozon-product-report-search — Claude Code skill
linkfox-seerfar-ozon-product-report-search — a skill for Claude Code and Codex that filters Ozon listings via Seerfar by sales and conversion metrics. It outputs SKU-level reports and saves the full JSON locally.
MIT 231 installs ★ 125 updated 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a claude-codeWhat linkfox-seerfar-ozon-product-report-search does
The skill searches Ozon products by sales volume and ruble revenue. You can also filter by price and rating, or narrow results by brand, FBO fulfillment, and launch date. Each row tracks one SKU. Category rollups and keyword volumes belong to other tools.
Requests run through scripts/seerfar_ozon_product_report_search.py, with raw endpoint rules documented in references/api.md. Full payloads always save to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ instead of /tmp. When a response exceeds 8 KB, standard output shows a summary and the first 3 records. Pass --inline to print the entire JSON. A local cache keeps identical requests for 24 hours.
You need Python and either LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY set in the environment. Missing keys or an empty balance trigger 401 or 402 responses. Each live query deducts 12 compute units from your LinkFox account. Empty results never trigger automatic retries with changed filters, preventing accidental spend.
What it helps with
- Filter Ozon bestsellers by monthly sales volume and price cap
- Spot new listings from the past 30 days sorted by sales growth rate
- Pull SKU-level metrics for specific competitor product IDs into local JSON
- Compare FBO items within a category by cart conversion and return rates
Example prompts for the agent
- Find Ozon products priced under 500 RUB with at least 5000 monthly sales and sort by sales.
- List new Ozon items launched in the last 30 days ordered by sales growth rate.
- Pull the product report for Ozon SKU 2107989735 and save the full JSON locally.
How to install linkfox-seerfar-ozon-product-report-search
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a claude-code2Manually: put the files in place
~/.claude/skills/linkfox-seerfar-ozon-product-report-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linkfox-seerfar-ozon-product-report-search/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a codex2Manually: put the files in place
.agents/skills/linkfox-seerfar-ozon-product-report-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a cursor2Manually: put the files in place
.cursor/skills/linkfox-seerfar-ozon-product-report-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-seerfar-ozon-product-report-search2Manually: put the files in place
.github/skills/linkfox-seerfar-ozon-product-report-search/SKILL.md1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-seerfar-ozon-product-report-searchManually: put the files in place
.devin/skills/linkfox-seerfar-ozon-product-report-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about linkfox-seerfar-ozon-product-report-search
How do I install linkfox-seerfar-ozon-product-report-search in Claude Code?
Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-seerfar-ozon-product-report-search -a claude-code in your terminal. That places the skill at ~/.claude/skills/linkfox-seerfar-ozon-product-report-search/SKILL.md.
What does linkfox-seerfar-ozon-product-report-search do?
It queries Seerfar for SKU-level Ozon product reports filtered by sales, ruble revenue, price, conversion, and ratings. The full JSON response saves to your working directory while chat receives a table or summary.
What is required to run the skill, and how much does a query cost?
The bundled script requires Python and an API key in LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY. Each live API call consumes 12 compute units, and identical parameter queries stay cached locally for 24 hours.
Source text
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