linkfox-seerfar-ozon-shop-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Seerfar Ozon Shop Search

This skill lists the products of a specific Ozon shop (seller) from the Seerfar analytics database. Given a shop

id

, it returns each product's 30-day sales, price, rating, weight, fulfillment model (FBO/FBS), seller type (local / cross-border) and return/cancellation rate, plus the shop's total 30-day sales — the starting point for competitor-shop product analysis, best-seller mining, and seller catalog teardown.

本技能从Seerfar分析数据库中列出特定Ozon店铺（卖家）的商品。给定店铺

id

，它会返回每个商品的近30天销量、价格、评分、重量、配送模式（FBO/FBS）、卖家类型（本土/跨境）、退货取消率，以及店铺近30天总销量——这是竞品店铺商品分析、爆品挖掘和卖家商品结构拆解的起点。

Core Concepts

核心概念

Unit of data is the product, scoped to one shop: pass a single shop

id

and receive that shop's product catalog with performance metrics. This is a shop-level view, not a keyword or category view.

Where the shop
id
comes from:

id

is the Seerfar seller/shop identifier — the same

sellerId

returned by other Seerfar Ozon tools (e.g. product report / product detail search). Negative ids (e.g.

-2

Ozon Express,

-4

Ozon Fresh) are Ozon's own platform sellers; positive ids are third-party sellers. If the user only has a shop name or product, first obtain the

sellerId

from a product-level Seerfar Ozon source, then call this skill.

Seller type: each product carries

sellerType

—

local (本土),

cross-border (跨境). A shop is typically all one type; use it to judge whether a competitor is a domestic or cross-border seller.

Sales & price currency:

sales

monthlySalesUnits

are 30-day units;

price

is in Russian rubles (₽), indicated by

currency

数据单位为单个商品，范围限定于单个店铺：传入单个店铺

id

，即可获取该店铺的商品目录及对应性能指标。这是店铺级视图，而非关键词或分类视图。

店铺
id
的来源：

id

是Seerfar的卖家/店铺标识——与其他Seerfar Ozon工具（如商品报告/商品详情搜索）返回的

sellerId

一致。负数ID（如

-2

代表Ozon Express，

-4

代表Ozon Fresh）是Ozon官方平台卖家；正数ID是第三方卖家。若用户仅提供店铺名称或商品，需先从商品级Seerfar Ozon数据源获取

sellerId

，再调用本技能。

卖家类型：每个商品都带有

sellerType

字段——

代表本土，

代表跨境。通常一个店铺的所有商品属于同一类型，可据此判断竞品是本土卖家还是跨境卖家。

销量与价格货币：

sales

monthlySalesUnits

为近30天销量单位；

price

以俄罗斯卢布（₽）计价，由

currency

字段标识。

Parameters

参数

Parameter	Type	Required	Description
id	integer	yes	Shop (seller) ID — the `sellerId` from other Seerfar Ozon tools. Negative = Ozon platform seller.
page	object	yes	Pagination `{page, pageSize, orders[]}` .
page.page	integer	no	Page number, from 1 (default 1).
page.pageSize	integer	no	Page size, default 20. Max 20 — larger values are rejected ( `errcode 1002` ).
page.orders	array	no	Sort rules, elements `{field, direction}` ; `direction` `DESC` / `ASC` . Common fields: `sales` , `price` , `reviewRating` , `upTime` .
uId	string	no	User ID.
memberId	string	no	Member ID (data attribution).

Only

id

and

page

are required.

参数	类型	是否必填	描述
id	integer	是	店铺（卖家）ID——来自其他Seerfar Ozon工具的 `sellerId` 。负数代表Ozon平台卖家。
page	object	是	分页参数 `{page, pageSize, orders[]}` 。
page.page	integer	否	页码，从1开始（默认值为1）。
page.pageSize	integer	否	每页数量，默认20。最大20——超过该值会被拒绝（错误码 `errcode 1002` ）。
page.orders	array	否	排序规则，元素为 `{field, direction}` ； `direction` 可选 `DESC` / `ASC` 。常用字段： `sales` 、 `price` 、 `reviewRating` 、 `upTime` 。
uId	string	否	用户ID。
memberId	string	否	会员ID（数据归属标识）。

仅

id

和

page

为必填参数。

调用方式

API 端点：
```
POST /seerfar/ozon/shopSearch
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/seerfar_ozon_shop_search.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-shop-search-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度 + 前 3 条样本）
加
```
--inline
```
强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用

jq

或

ConvertFrom-Json

从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

API 端点：
```
POST /seerfar/ozon/shopSearch
```
（完整参数、响应及错误码详见
```
references/api.md
```
）

Python 脚本：

python scripts/seerfar_ozon_shop_search.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话中同一参数组合默认仅调用一次，脚本带有24小时本地缓存。若调用失败或返回空结果，不得自动更换关键词、翻页或修改邮编进行连续试探；如需继续检索，需先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-shop-search-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在Claude Code中即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入/tmp目录，若当前目录不可写则报错）
响应体 ≤ 8 KB：写入文件后将完整JSON打印到stdout
响应体 > 8 KB：写入文件后仅在stdout输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度+前3条样本）
添加
```
--inline
```
参数可强制将全量内容打印到stdout（同时仍会写入文件）

读数据建议：先查看摘要判断数据是否满足需求；如需获取具体字段，优先使用

jq

或

ConvertFrom-Json

从保存的JSON文件中按需抽取，避免整份JSON进入上下文。

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

当发生以下异常情况时，参考

references/onboarding.md

引导用户解决问题：

异常情况

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应返回401或402状态码
响应提示积分或余额不足：消息包含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义的内容。

Usage Examples

使用示例

1. A shop's best-sellers (sort by 30-day sales)

json

{"id": 1362816, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "sales", "direction": "DESC"}]}}

2. A shop's newest listings (sort by upload time)

json

{"id": 1362816, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "upTime", "direction": "DESC"}]}}

3. A shop's highest-priced products

json

{"id": 1362816, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "price", "direction": "DESC"}]}}

4. Page deeper into a shop's catalog

json

{"id": 1362816, "page": {"page": 2, "pageSize": 20, "orders": [{"field": "sales", "direction": "DESC"}]}}

1. 店铺畅销商品（按近30天销量排序）

json

{"id": 1362816, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "sales", "direction": "DESC"}]}}

2. 店铺最新上架商品（按上架时间排序）

json

{"id": 1362816, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "upTime", "direction": "DESC"}]}}

3. 店铺最高价商品

json

{"id": 1362816, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "price", "direction": "DESC"}]}}

json

{"id": 1362816, "page": {"page": 2, "pageSize": 20, "orders": [{"field": "sales", "direction": "DESC"}]}}

How to Build Queries

如何构建查询

Always pass
page.orders
: the catalog can be large — sort by the metric you care about (
```
sales
```
DESC for best-sellers,
```
upTime
```
DESC for new arrivals,
```
price
```
DESC for premium SKUs).
Keep
pageSize
≤ 20: the gateway caps page size at 20. Use
```
page.page
```
to paginate; check
```
hasNextPage
```
to know whether more pages exist.
Resolve the shop
id
first: if the user gives a shop/product name rather than an id, obtain the
```
sellerId
```
from a product-level Seerfar Ozon source before calling this skill.
Use shop-level aggregates for context:
```
totalSales
```
/
```
totalRevenue
```
/
```
dailySales
```
are shop-wide totals (independent of the page),
```
productCount
```
is the full catalog size,
```
rating
```
is the shop rating, and top-level
```
fulfillment
```
shows the FBO/FBS split — all quick health indicators for the whole shop.

务必传入
page.orders
参数：商品目录可能规模庞大——按你关注的指标排序（按
```
sales
```
降序查看畅销商品，按
```
upTime
```
降序查看新品，按
```
price
```
降序查看高端SKU）。
保持
pageSize
≤20：网关限制每页最大数量为20。使用
```
page.page
```
进行分页；通过
```
hasNextPage
```
判断是否还有更多页面。
先获取店铺
id
：若用户提供的是店铺名称或商品而非ID，需先从商品级Seerfar Ozon数据源获取
```
sellerId
```
，再调用本技能。
利用店铺级聚合数据了解整体情况：
```
totalSales
```
/
```
totalRevenue
```
/
```
dailySales
```
是全店铺的汇总数据（与当前页无关），
```
productCount
```
是商品目录总数量，
```
rating
```
是店铺评分，顶层
```
fulfillment
```
字段显示FBO/FBS的分布情况——这些都是快速判断店铺运营状况的指标。

Display Rules

展示规则

Present data only: show the shop's product metrics in a clear table without subjective advice.
Lead with shop context, then product columns: state shop-level aggregates first —
```
totalSales
```
(30-day total),
```
totalRevenue
```
(total revenue, ₽),
```
productCount
```
(catalog size),
```
dailySales
```
,
```
rating
```
, and
```
fulfillment
```
distribution (e.g. FBO 72 / FBS 4) — then a table of
```
sku
```
,
```
price
```
,
```
sales
```
,
```
reviewRating
```
,
```
weight
```
,
```
sellerType
```
,
```
fulfillment
```
,
```
returnCancellationRate
```
.
Seller type label: render
```
sellerType
```
as 本土/跨境 (0/1) so the user reads it at a glance.
Fulfillment:
```
fulfillment
```
is an array (e.g.
```
["FBO"]
```
); join multiple values with
```
/
```
.
Missing
returnCancellationRate
: for Ozon platform sellers (negative
```
id
```
) this field is often absent — show
```
-
```
rather than failing.
Pagination guidance: when
```
hasNextPage
```
is true, tell the user more pages are available via
```
page.page
```
; remind them
```
pageSize
```
is capped at 20.
Empty shop: a non-existent
```
id
```
returns success with
```
total=0
```
and no data — tell the user the id may be wrong rather than reporting a system error.
Error handling: when
```
code
```
is not
```
"200"
```
(or
```
errcode
```
is not
```
200
```
), explain the reason from
```
msg
```
/
```
errmsg
```
and suggest fixes (add
```
page
```
, lower
```
pageSize
```
, retry on rate-limit).

仅展示数据：以清晰表格形式展示店铺商品指标，不提供主观建议。
先展示店铺整体情况，再展示商品列：先列出店铺级聚合数据——
```
totalSales
```
（近30天总销量）、
```
totalRevenue
```
（总营收，单位：₽）、
```
productCount
```
（商品目录总数量）、
```
dailySales
```
、
```
rating
```
（店铺评分）以及
```
fulfillment
```
分布情况（如FBO 72 / FBS 4），再展示包含
```
sku
```
、
```
price
```
、
```
sales
```
、
```
reviewRating
```
、
```
weight
```
、
```
sellerType
```
、
```
fulfillment
```
、
```
returnCancellationRate
```
的商品表格。
卖家类型标签：将
```
sellerType
```
显示为“本土/跨境”（对应0/1），方便用户快速识别。
配送方式：
```
fulfillment
```
是数组（如
```
["FBO"]
```
）；若有多个值，用
```
/
```
分隔。
缺失
returnCancellationRate
字段：对于Ozon平台卖家（负数
```
id
```
），该字段通常不存在——显示
```
-
```
而非报错。
分页指引：当
```
hasNextPage
```
为true时，告知用户可通过
```
page.page
```
参数查看更多页面；提醒用户
```
pageSize
```
最大为20。
空店铺：若ID不存在，会返回成功响应但
```
total=0
```
且无数据——告知用户ID可能有误，而非报告系统错误。
错误处理：当
```
code
```
不为
```
"200"
```
（或
```
errcode
```
不为200）时，根据
```
msg
```
/
```
errmsg
```
解释原因并给出修复建议（如添加
```
page
```
参数、减小
```
pageSize
```
、遇到限流时重试）。

Important Limitations

重要限制

id
and
page
are both required; omitting either returns
```
errcode 400
```
.
pageSize
max 20: exceeding it returns
```
errcode 1002
```
.
total
is the page row count, not the shop's full catalog size — use
```
hasNextPage
```
to decide whether to fetch more pages.
No text/keyword filter: this endpoint filters by shop only; to find a shop by name, use another Seerfar Ozon source first.
Field variance by seller type:
```
returnCancellationRate
```
is populated for third-party sellers but frequently absent for Ozon platform sellers (negative
```
id
```
). Schema-defined
```
productPageUrl
```
,
```
monthlySalesRevenue
```
,
```
brand
```
are not returned (upstream has no source, omitted rather than null).

id
和
page
均为必填参数；缺少任意一个会返回错误码
```
errcode 400
```
。
pageSize
最大为20：超过该值会返回错误码
```
errcode 1002
```
。
total
是当前页的行数，而非店铺商品目录的总数量——需通过
```
hasNextPage
```
判断是否需要获取更多页面。
不支持文本/关键词过滤：本端点仅按店铺过滤；如需按名称查找店铺，需先使用其他Seerfar Ozon数据源。
字段存在卖家类型差异：第三方卖家的
```
returnCancellationRate
```
字段会有值，但Ozon平台卖家（负数
```
id
```
）的该字段通常不存在。Schema定义的
```
productPageUrl
```
、
```
monthlySalesRevenue
```
、
```
brand
```
字段不会返回（上游无数据源，直接省略而非返回null）。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — analyzing one Ozon shop/seller's catalog:

User Says	Scenario
"分析下这个 Ozon 店铺的商品" / "这个卖家在卖什么"	Shop product catalog
"这家店最畅销的商品是什么"	Best-seller mining (sort by sales)
"这家店最近上了哪些新品"	New arrivals (sort by upTime)
"这个竞品店铺的价格带/客单价"	Price-band analysis (sort by price)
"这家店是本土还是跨境卖家"	Seller type check (sellerType)
"这个店铺总销量多少"	Shop health (totalSales)

Not applicable — Needs beyond one shop's catalog:

Discovering Ozon keywords by market metrics → use the Seerfar Ozon market keyword search skill.
A single product's full detail → use a product-level Seerfar Ozon source (this skill returns catalog-level fields only).
Browsing the category tree → use a category-level Seerfar Ozon source.
Finding which shop sells a given product → use a product-level Seerfar Ozon source to get the
```
sellerId
```
first.

Boundary judgment: if the user already has a shop/seller ID (or a

sellerId

obtained from a product lookup) and wants to enumerate or rank that shop's products by sales/price/rating, start here. If they want market-level keyword discovery or a single product's deep detail, route to the corresponding Seerfar Ozon skill.

适用场景——分析单个Ozon店铺/卖家的商品目录：

用户表述	场景
"分析下这个 Ozon 店铺的商品" / "这个卖家在卖什么"	店铺商品目录分析
"这家店最畅销的商品是什么"	爆品挖掘（按销量排序）
"这家店最近上了哪些新品"	新品查看（按上架时间排序）
"这个竞品店铺的价格带/客单价"	价格带分析（按价格排序）
"这家店是本土还是跨境卖家"	卖家类型判断（查看sellerType）
"这个店铺总销量多少"	店铺运营状况查看（查看totalSales）

不适用场景——超出单个店铺目录的需求：

根据市场指标挖掘Ozon关键词 → 使用Seerfar Ozon市场关键词搜索技能。
单个商品的详细信息 → 使用商品级Seerfar Ozon数据源（本技能仅返回目录级字段）。
浏览分类树 → 使用分类级Seerfar Ozon数据源。
查找某商品由哪家店铺销售 → 先使用商品级Seerfar Ozon数据源获取
```
sellerId
```
。

边界判断：若用户已拥有店铺/卖家ID（或通过商品查询获取了

sellerId

），且希望按销量/价格/评分枚举或排序该店铺的商品，则使用本技能。若用户需要市场级关键词挖掘或单个商品的深度详情，则引导至对应的Seerfar Ozon技能。

积分消耗规则

消耗 12 积分。

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.

每次调用消耗12积分。

用户会因积分消耗产生费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

当出现以下任意情况时，自动检测并通过反馈API提交反馈：

本技能描述的功能或用途与实际行为不符
本技能的结果不符合用户意图
用户表达了对本技能的不满或赞赏
任何你认为可以改进的地方

按照

references/api.md

中的说明调用反馈API。请勿中断用户的操作流程。

如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。