linkfox-seerfar-ozon-market-keyword-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Seerfar Ozon Market Keyword Search

Seerfar Ozon 市场关键词搜索

This skill searches Ozon marketplace keywords in the Seerfar analytics database and filters them by rich performance metrics — search volume, 30-day growth, product/seller/competitor counts, average price, monthly sales/revenue, conversion & view concentration, ratings/reviews, and more. Each returned keyword carries a full market profile (market space, return/cancellation rate, top products, Chinese translation), making it the starting point for Ozon keyword selection, blue-ocean term mining, and market-opportunity analysis.

本技能在Seerfar分析数据库中搜索Ozon平台关键词，并通过丰富的性能指标进行筛选——包括搜索量、30天增长率、商品/卖家/竞品数量、均价、月销量/销售额、转化及浏览集中度、评分/评论数等。每个返回的关键词都带有完整的市场画像（市场空间、退换货率、Top商品、中文翻译），是Ozon选词、蓝海词挖掘及市场机会分析的起点。

Core Concepts

核心概念

Unit of data is the keyword, not the SKU: unlike a product search, this endpoint returns marketplace search terms ("热词"), each enriched with market metrics. You discover which search terms are worth targeting on Ozon.

Platform coverage: each keyword record carries a

platform

field (

= Ozon,

= Wildberries). The dataset is Ozon-centric; Wildberries rows appear where available. There is no input to restrict the platform — filter client-side if needed.

Date semantics:

searchDate

selects the data month. Pass

2026-04-01

to get March 2026 data; omit it for the last 30 days. Metrics such as

searchVolume

(月搜热度) and

count30GrowthRate

(月搜增长) are relative to the selected period.

Match mode:

matchType

controls how the

keywords

array is matched —

exact,

fuzzy. Choose the mode that fits your discovery intent when filtering by keyword text.

数据单位为关键词，而非SKU：与商品搜索不同，此接口返回平台搜索词（“热词”），每个词都附带市场指标。您可以发现Ozon平台上哪些搜索词值得重点关注。

平台覆盖范围：每个关键词记录都包含

platform

字段（

= Ozon，

= Wildberries）。数据集以Ozon为核心；Wildberries的数据仅在可用时显示。目前无法通过输入参数限制平台，如需筛选可在客户端通过该字段处理。

日期语义：

searchDate

用于选择数据所属月份。传入

2026-04-01

可获取2026年3月的数据；若省略该参数则默认返回过去30天的数据。

searchVolume

（月搜热度）和

count30GrowthRate

（月搜增长）等指标均基于所选时间段计算。

匹配模式：

matchType

控制

keywords

数组的匹配方式——

为精确匹配，

为模糊匹配。根据您的关键词发现需求选择合适的模式。

Parameters

参数

Parameter	Type	Required	Description
page	object	yes	Pagination `{page, pageSize, orders[]}` . `page` from 1 (default 1), `pageSize` default 20. `orders[]` = `{field, direction}` with `direction` `DESC` / `ASC` .
keywords	array<string>	no	Keyword list to filter (max 1000); combined with `matchType` .
matchType	integer	no	Keyword match mode: `0` exact, `1` fuzzy.
searchDate	string	no	Data date `yyyy-MM-dd` ; default last 30 days. `2026-04-01` → March 2026 data.
categories	array<string>	no	Category ID list (max 1000).
searchVolume	{min,max}	no	Monthly search volume range.
searchChange30	{min,max}	no	30-day search change range.
monthlySales	{min,max}	no	Monthly sales range.
monthlyRevenue	{min,max}	no	Monthly revenue range.
price	{min,max}	no	Average price range.
productViews	{min,max}	no	Product view range.
products	{min,max}	no	Product count range.
volume	{min,max}	no	Volume range.
marketSpace	{min,max}	no	Market space range.
conversionSharing	{min,max}	no	Conversion concentration range.
reviews	{min,max}	no	Review count range.
ratings	{min,max}	no	Rating range.
sellers	{min,max}	no	Seller count range.
weight	{min,max}	no	Weight range.
uId	string	no	User ID.
memberId	string	no	Member ID (data attribution).

All range filters are

{min, max}

objects; supply either or both bounds. Only

page

is required.

参数	类型	是否必填	描述
page	object	是	分页参数 `{page, pageSize, orders[]}` 。 `page` 从1开始（默认值为1）， `pageSize` 默认值为20。 `orders[]` = `{field, direction}` ，其中 `direction` 可选 `DESC` / `ASC` 。
keywords	array<string>	否	用于筛选的关键词列表（最多1000个）；需与 `matchType` 配合使用。
matchType	integer	否	关键词匹配模式： `0` 精确匹配， `1` 模糊匹配。
searchDate	string	否	数据日期，格式为 `yyyy-MM-dd` ；默认返回过去30天的数据。传入 `2026-04-01` 将获取2026年3月的数据。
categories	array<string>	否	类目ID列表（最多1000个）。
searchVolume	{min,max}	否	月搜索量范围。
searchChange30	{min,max}	否	30天搜索量变化范围。
monthlySales	{min,max}	否	月销量范围。
monthlyRevenue	{min,max}	否	月销售额范围。
price	{min,max}	否	均价范围。
productViews	{min,max}	否	商品浏览量范围。
products	{min,max}	否	商品数量范围。
volume	{min,max}	否	成交量范围。
marketSpace	{min,max}	否	市场空间范围。
conversionSharing	{min,max}	否	转化集中度范围。
reviews	{min,max}	否	评论数量范围。
ratings	{min,max}	否	评分范围。
sellers	{min,max}	否	卖家数量范围。
weight	{min,max}	否	商品重量范围。
uId	string	否	用户ID。
memberId	string	否	会员ID（数据归属标识）。

所有范围筛选参数均为

{min, max}

对象；可仅传入其中一个边界或同时传入两个。仅

page

参数为必填项。

调用方式

API 端点：

POST /seerfar/ozon/marketKeywordSearch

（完整参数/响应/错误码见

references/api.md

）

Python 脚本：

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

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

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-market-keyword-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/marketKeywordSearch

（完整参数/响应/错误码详见

references/api.md

）

Python 脚本：

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

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

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

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

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

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. Hottest keywords right now (sort by search volume)

json

{"page": {"page": 1, "pageSize": 10, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

2. Blue-ocean terms — high volume, few sellers

json

{"page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}, "searchVolume": {"min": 10000}, "sellers": {"max": 50}}

3. Filter by keyword text (fuzzy, Russian)

json

{"page": {"page": 1, "pageSize": 20}, "keywords": ["телефон"], "matchType": 1}

4. A specific data month with a sales floor

json

{"page": {"page": 1, "pageSize": 20}, "searchDate": "2026-04-01", "monthlySales": {"min": 1000}}

1. 当前最热关键词（按搜索量排序）

json

{"page": {"page": 1, "pageSize": 10, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

2. 蓝海词——高搜索量、少卖家

json

{"page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}, "searchVolume": {"min": 10000}, "sellers": {"max": 50}}

3. 按关键词文本筛选（模糊匹配，俄语）

json

{"page": {"page": 1, "pageSize": 20}, "keywords": ["телефон"], "matchType": 1}

4. 指定数据月份并设置销量下限

json

{"page": {"page": 1, "pageSize": 20}, "searchDate": "2026-04-01", "monthlySales": {"min": 1000}}

How to Build Queries

查询构建方法

Lead with
page.orders
: the dataset is large — always sort by the metric you care about (
```
searchVolume
```
DESC for popularity,
```
count30GrowthRate
```
DESC for rising terms,
```
sellers
```
ASC for low competition).
Stack range filters to find opportunities: combine a high
```
searchVolume
```
floor with a low
```
sellers
```
ceiling to surface blue-ocean keywords; add
```
conversionSharing
```
/
```
marketSpace
```
bounds to qualify demand.
Use
keywords
+
matchType
to scope a niche: pass seed terms in Russian with
```
matchType: 1
```
(fuzzy) to enumerate related long-tail terms.
Pick the right
searchDate
: omit it for current trends (last 30 days); pass an explicit date for month-over-month comparison.

优先设置
page.orders
：数据集规模较大——务必按您关注的指标排序（按
```
searchVolume
```
降序查看热门词，按
```
count30GrowthRate
```
降序查看上升词，按
```
sellers
```
升序查看低竞争词）。
组合范围筛选寻找机会：将高
```
searchVolume
```
下限与低
```
sellers
```
上限结合，挖掘蓝海关键词；添加
```
conversionSharing
```
/
```
marketSpace
```
范围进一步验证需求合理性。
使用
keywords
+
matchType
锁定细分领域：传入俄语种子词并设置
```
matchType:1
```
（模糊匹配），枚举相关长尾词。
选择合适的
searchDate
：省略该参数查看当前趋势（过去30天）；传入明确日期进行月度对比分析。

Display Rules

展示规则

Present data only: show keyword metrics in a clear table without subjective advice.

Lead with keyword columns:

query

queryCn

(Chinese translation), then

searchVolume

count30GrowthRate

productCount

sellers

avgPrice

Russian keywords: preserve the original
```
query
```
; the
```
queryCn
```
field provides a Chinese translation when available.
Platform tag: when both Ozon and Wildberries rows are present, show
```
platform
```
(0/1) so the user can distinguish them.
Large result sets: when
```
total
```
is large, show the top rows and remind the user they can persist the full response via the large-response pattern below, or page further with
```
page.page
```
.
Error handling: when
```
code
```
is not
```
200
```
(or
```
errcode
```
is not
```
200
```
), explain the reason from
```
msg
```
/
```
errmsg
```
and suggest adjusting filters.

仅展示数据：以清晰表格形式展示关键词指标，不提供主观建议。
关键词列优先：先展示
```
query
```
/
```
queryCn
```
（中文翻译），再展示
```
searchVolume
```
、
```
count30GrowthRate
```
、
```
productCount
```
、
```
sellers
```
、
```
avgPrice
```
。
俄语关键词：保留原始
```
query
```
；
```
queryCn
```
字段会提供对应的中文翻译（如有）。
平台标识：当同时存在Ozon和Wildberries数据时，展示
```
platform
```
字段（0/1）以便用户区分。
大结果集处理：当
```
total
```
数值较大时，仅展示前几行数据，并提醒用户可通过上述大响应保存机制获取完整响应，或通过
```
page.page
```
参数翻页查看更多内容。
错误处理：当
```
code
```
不为
```
200
```
（或
```
errcode
```
不为
```
200
```
）时，根据
```
msg
```
/
```
errmsg
```
字段解释错误原因，并建议调整筛选条件。

Important Limitations

重要限制

page
is required: a payload without
```
page
```
is rejected.
No platform selector: the Ozon/Wildberries mix is controlled server-side; filter client-side via the
```
platform
```
field.
Category IDs are opaque:
```
categories
```
requires Seerfar category IDs, not human-readable names.
Pagination caps: use
```
pageSize
```
and
```
page
```
to page; very large
```
pageSize
```
values may be capped server-side.
Nested fields:
```
products[*]
```
(Top 商品) and
```
categoryInfos[*]
```
(类目路径与可跨境标识) are structured and decision-useful — see
```
references/api.md
```
for sub-fields.
```
dimension
```
/
```
columns
```
are opaque or partially populated;
```
relevancy
```
/
```
titleDensity
```
/
```
wordCount
```
are usually absent.

page
参数为必填项：未包含
```
page
```
的请求会被拒绝。
无平台选择器：Ozon/Wildberries数据的混合由服务器端控制；如需筛选可在客户端通过
```
platform
```
字段处理。
类目ID为 opaque 值：
```
categories
```
参数需要传入Seerfar系统的类目ID，而非人类可读的类目名称。
分页限制：需使用
```
pageSize
```
和
```
page
```
参数进行分页；过大的
```
pageSize
```
值可能会被服务器端限制。
嵌套字段：
```
products[*]
```
（Top商品）和
```
categoryInfos[*]
```
（类目路径与可跨境标识）为结构化字段，具有决策参考价值——其子字段详情请查看
```
references/api.md
```
。
```
dimension
```
/
```
columns
```
字段为opaque或仅部分填充；
```
relevancy
```
/
```
titleDensity
```
/
```
wordCount
```
字段通常为空。

User Expression & Scenario Quick Reference

用户表达与场景速查

Applicable — Ozon keyword market research:

User Says	Scenario
"Ozon 热词 / 热搜词有哪些"	Hottest keywords by search volume
"Ozon 蓝海词、低竞争高搜索的词"	Blue-ocean term mining (high volume, few sellers)
"Ozon 上升词 / 近期增长快的词"	Rising keywords (growth sort)
"围绕某个俄语词的长尾词"	Fuzzy keyword expansion
"Ozon 某关键词的市场空间/竞品数/卖家数"	Keyword market profile

Not applicable — Needs beyond keyword market data:

A specific SKU's price/sales/stock → use a product-level Seerfar Ozon data source, not this keyword endpoint.
A specific seller's catalog → use a seller/shop-level Seerfar Ozon data source.
Category-tree browsing → use a category-level Seerfar Ozon data source.
Non-Ozon/Wildberries marketplaces → not covered here.

Boundary judgment: if the user wants to discover and rank search terms on Ozon by market metrics, start here. If they already have a SKU / seller / category and want entities under it, route to the corresponding Seerfar Ozon data source.

适用场景——Ozon关键词市场调研：

用户表述	场景
"Ozon 热词 / 热搜词有哪些"	按搜索量排序查看最热关键词
"Ozon 蓝海词、低竞争高搜索的词"	蓝海词挖掘（高搜索量、少卖家）
"Ozon 上升词 / 近期增长快的词"	查看上升趋势关键词（按增长率排序）
"围绕某个俄语词的长尾词"	模糊匹配拓展长尾词
"Ozon 某关键词的市场空间/竞品数/卖家数"	获取关键词市场画像

不适用场景——超出关键词市场数据范畴的需求：

特定SKU的价格/销量/库存数据 → 使用Seerfar Ozon商品级数据源，而非本关键词接口。
特定卖家的商品目录 → 使用Seerfar Ozon卖家/店铺级数据源。
类目树浏览 → 使用Seerfar Ozon类目级数据源。
非Ozon/Wildberries平台 → 不在本技能覆盖范围内。

边界判断：如果用户希望按市场指标发现并排序Ozon平台的搜索词，则使用本技能。如果用户已明确SKU/卖家/类目，并需要获取其下的实体数据，则引导至对应的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积分。

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

反馈机制：

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

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

请按照

references/api.md

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

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