linkfox-seerfar-ozon-keyword-back-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Seerfar Ozon Keyword Back-Search

Seerfar Ozon 关键词反查

This skill reverse-looks-up Ozon search keywords by a list of product SKU IDs in the Seerfar analytics database: pass up to 20 SKUs (your own listing or a competitor's) and it returns the search terms those products appear under — organic and/or ad — each enriched with a full market profile (search volume, 30-day growth, product/seller/competitor counts, average price, conversion concentration, top products, plus per-term organic/ad channel, natural rank, exposure, and conversion in the

dimension

object). It is the starting point for Ozon keyword reverse lookup, listing-title optimization, and competitor traffic-word discovery.

本技能通过Seerfar分析数据库，按商品SKU ID列表反向查询Ozon搜索关键词：传入最多20个SKU（自有Listing或竞品Listing），返回这些商品所覆盖的搜索词——自然搜索词和/或广告搜索词，每个关键词都附带完整的市场画像（搜索量、30天增长率、商品/卖家/竞品数量、均价、转化集中度、Top商品，以及

dimension

对象中的单关键词自然/广告渠道、自然排名、曝光量和转化率）。它是Ozon关键词反查、Listing标题优化、竞品流量词挖掘的起点。

Core Concepts

核心概念

SKU-driven, not keyword-driven: unlike keyword mining (expand from a seed term) or market keyword search (browse the whole market), this endpoint takes

skuIds

and returns the search terms those specific products rank for. The direction is product → keywords (reverse).

hasVariant
is required: every request must declare whether to exclude variants —

keep variants,

exclude variants. Pick

when you want de-duplicated keyword coverage for a parent listing.

Natural vs ad terms:

type

filters the search-term channel —

["0"]

organic (自然搜索词) only,

["1"]

ad (广告搜索词) only; omit to get both. Combine with the

naturalRank

adRank

range filters to qualify positioning.

Back-search metrics live in
dimension
: each returned term carries a

dimension

object with the reverse-lookup-specific metrics —

type

(

organic /

ad),

naturalRank

(the SKU's natural rank for that term),

exposure

(exposure share, 0–1),

conversion

(conversion rate, 0–1), and

(opaque position indicator). The input filters

type

naturalRank

adRank

exposure

conversion

filter on these same per-term values. Note:

relevancy

is defined in the schema but is not returned by this endpoint.

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.

Match mode:

matchType

controls how

includeKeywords

excludeKeywords

are matched —

exact,

fuzzy.

以SKU为驱动，而非关键词驱动：与关键词挖掘（从种子词拓展）或市场关键词搜索（浏览整个市场）不同，此接口接收

skuIds

参数，返回这些特定商品所排名的搜索词，方向为商品→关键词（反向）。

hasVariant
为必填参数：每个请求必须声明是否排除变体——

保留变体，

排除变体。当你希望获取父Listing去重后的关键词覆盖范围时，请选择

。

自然词 vs 广告词：

type

参数用于筛选搜索词渠道——

["0"]

仅自然搜索词，

["1"]

仅广告搜索词；省略则同时获取两者。可结合

naturalRank

adRank

范围筛选来限定排名位置。

反查指标位于
dimension
中：每个返回的关键词都带有一个

dimension

对象，包含反查专属指标——

type

（

自然搜索 /

广告）、

naturalRank

（该SKU在该关键词下的自然排名）、

exposure

（曝光份额，0–1）、

conversion

（转化率，0–1）和

（不透明位置指示器）。输入参数中的

type

naturalRank

adRank

exposure

conversion

筛选条件基于这些单关键词数值。注意：

relevancy

在 schema 中定义，但本接口不会返回该字段。

平台覆盖：每个关键词记录带有

platform

字段（

=Ozon，

=Wildberries）。数据集以Ozon为核心；Wildberries数据仅在可用时显示。目前没有输入参数可限制平台——如需过滤请在客户端处理。

匹配模式：

matchType

控制

includeKeywords

excludeKeywords

的匹配方式——

精确匹配，

模糊匹配。

Parameters

参数

Parameter	Type	Required	Description
skuIds	array<integer>	yes	Reverse-lookup SKU list, max 20.
hasVariant	integer	yes	Variant exclusion: `0` keep variants, `1` exclude variants.
page	object	yes	Pagination `{page, pageSize, orders[]}` . `page` from 1 (default 1), `pageSize` default 20. `orders[]` = `{field, direction}` with `direction` `DESC` / `ASC` .
matchType	integer	no	Keyword match mode: `0` exact, `1` fuzzy.
type	array<string>	no	Search-term channel filter: `0` organic, `1` ad; omit for both.
historyDate	string	no	Historical month `yyyy-MM` (e.g. `2026-02` ); omit for current period.
includeKeywords	array<string>	no	Terms that must appear (max 1000).
excludeKeywords	array<string>	no	Terms to exclude (max 1000).
searchVolume	{min,max}	no	Monthly search volume range.
searchChange30	{min,max}	no	30-day search change range.
wordCount	{min,max}	no	Keyword word/char count range.
productViews	{min,max}	no	Product view range.
products	{min,max}	no	Product count range.
sellers	{min,max}	no	Seller count range.
marketSpace	{min,max}	no	Market space range.
conversionSharing	{min,max}	no	Conversion concentration range.
uniqQueriesWCa	{min,max}	no	Cart-add count range.
ca	{min,max}	no	Cart-add conversion rate range.
conversion	{min,max}	no	Conversion rate range.
titleDensity	{min,max}	no	Title density range.
adRivalCount	{min,max}	no	Ad competitor count range.
adRank	{min,max}	no	Ad rank range.
naturalRank	{min,max}	no	Natural rank range.
exposure	{min,max}	no	Exposure 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.

skuIds

hasVariant

, and

page

are all required.

参数名	类型	是否必填	描述
skuIds	array<integer>	是	反查SKU列表，最多20个。
hasVariant	integer	是	变体排除设置： `0` 保留变体， `1` 排除变体。
page	object	是	分页参数 `{page, pageSize, orders[]}` 。 `page` 从1开始（默认1）， `pageSize` 默认20。 `orders[]` = `{field, direction}` ，其中 `direction` 为 `DESC` / `ASC` 。
matchType	integer	否	关键词匹配模式： `0` 精确匹配， `1` 模糊匹配。
type	array<string>	否	搜索词渠道筛选： `0` 自然搜索， `1` 广告；省略则同时获取两者。
historyDate	string	否	历史月份（格式 `yyyy-MM` ，例如 `2026-02` ）；省略则使用当前周期数据。
includeKeywords	array<string>	否	必须包含的关键词（最多1000个）。
excludeKeywords	array<string>	否	需要排除的关键词（最多1000个）。
searchVolume	{min,max}	否	月搜索量范围。
searchChange30	{min,max}	否	30天搜索量变化范围。
wordCount	{min,max}	否	关键词字数/字符数范围。
productViews	{min,max}	否	商品浏览量范围。
products	{min,max}	否	商品数量范围。
sellers	{min,max}	否	卖家数量范围。
marketSpace	{min,max}	否	市场空间范围。
conversionSharing	{min,max}	否	转化集中度范围。
uniqQueriesWCa	{min,max}	否	加购次数范围。
ca	{min,max}	否	加购转化率范围。
conversion	{min,max}	否	转化率范围。
titleDensity	{min,max}	否	标题密度范围。
adRivalCount	{min,max}	否	广告竞品数量范围。
adRank	{min,max}	否	广告排名范围。
naturalRank	{min,max}	否	自然排名范围。
exposure	{min,max}	否	曝光量范围。
uId	string	否	用户ID。
memberId	string	否	会员ID（数据归因）。

所有范围筛选参数均为

{min, max}

对象；可提供其中一个或两个边界值。

skuIds

、

hasVariant

和

page

为必填参数。

调用方式

API 端点：

POST /seerfar/ozon/keywordBackSearch

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

references/api.md

）

Python 脚本：

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

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

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-keyword-back-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/keywordBackSearch
```
（完整参数/响应/错误码详见
```
references/api.md
```
）

Python 脚本：

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

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

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-keyword-back-search-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在Claude Code中即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入/tmp目录，若当前目录不可写则报错）
响应体 ≤ 8 KB：写入文件后将完整JSON打印到标准输出（stdout）
响应体 > 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. Reverse-lookup a single SKU's traffic keywords (sort by search volume)

json

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

2. Organic terms where the SKU ranks near the top

json

{"skuIds": [4380710124], "hasVariant": 1, "type": ["0"], "naturalRank": {"max": 10}, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

3. Ad search words only, with an ad-rank floor

json

{"skuIds": [4380710124], "hasVariant": 0, "type": ["1"], "adRank": {"max": 50}, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

4. Narrow with include / exclude lists

json

{"skuIds": [4380710124], "hasVariant": 0, "page": {"page": 1, "pageSize": 20}, "includeKeywords": ["платье"], "excludeKeywords": ["ремень"], "matchType": 1}

1. 反向查询单个SKU的流量关键词（按搜索量排序）

json

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

2. SKU排名靠前的自然搜索词

json

{"skuIds": [4380710124], "hasVariant": 1, "type": ["0"], "naturalRank": {"max": 10}, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

3. 仅广告搜索词，且广告排名低于指定值

json

{"skuIds": [4380710124], "hasVariant": 0, "type": ["1"], "adRank": {"max": 50}, "page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

4. 通过包含/排除关键词缩小范围

json

{"skuIds": [4380710124], "hasVariant": 0, "page": {"page": 1, "pageSize": 20}, "includeKeywords": ["платье"], "excludeKeywords": ["ремень"], "matchType": 1}

How to Build Queries

查询构建指南

Always lead with
skuIds
+
hasVariant
: both are required and define the reverse-lookup target. Use real Ozon SKU IDs (the same IDs returned by Seerfar Ozon product / shop / category skills).
Lead with
page.orders
: sort by the metric you care about (
```
searchVolume
```
DESC for traffic weight,
```
sellers
```
ASC for low competition,
```
count30GrowthRate
```
DESC for rising terms).
Split organic vs ad with
type
: pass
```
["0"]
```
or
```
["1"]
```
to focus a listing-optimization pass (organic) or an ads pass (ad), then bound
```
naturalRank
```
/
```
adRank
```
to qualify positioning — these filter on the values surfaced in each row's
```
dimension
```
.
Use
includeKeywords
/
excludeKeywords
to steer: force in must-have modifiers and strip noise without running a second query.

始终先设置
skuIds
+
hasVariant
：两者均为必填参数，定义了反查目标。请使用真实的Ozon SKU ID（与Seerfar Ozon产品/店铺/分类技能返回的ID一致）。
先设置
page.orders
：按你关注的指标排序（
```
searchVolume
```
DESC用于流量权重排序，
```
sellers
```
ASC用于低竞争排序，
```
count30GrowthRate
```
DESC用于上升趋势词排序）。
用
type
区分自然词和广告词：传入
```
["0"]
```
或
```
["1"]
```
以聚焦Listing优化（自然词）或广告投放（广告词），然后通过
```
naturalRank
```
/
```
adRank
```
限定排名位置——这些筛选条件基于每行
```
dimension
```
中显示的数值。
使用
includeKeywords
/
excludeKeywords
精准定位：强制纳入必备修饰词并剔除无效词，无需执行二次查询。

Display Rules

展示规则

Present data only: show reverse-looked-up keyword metrics in a clear table without subjective advice.
Lead with keyword columns:
```
query
```
/
```
queryCn
```
(Chinese translation), then
```
searchVolume
```
,
```
count30GrowthRate
```
,
```
productCount
```
,
```
sellers
```
,
```
avgPrice
```
; show
```
dimension.naturalRank
```
and
```
dimension.type
```
(organic/ad) to convey how the SKU ranks for each term.
Russian keywords: preserve the original
```
query
```
; the
```
queryCn
```
field provides a Chinese translation when available.
Channel tag: when
```
type
```
is omitted and both organic and ad rows are present, show
```
dimension.type
```
(
```
0
```
organic /
```
1
```
ad) and
```
dimension.naturalRank
```
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 the SKU list or filters.

仅展示数据：以清晰表格形式呈现反查得到的关键词指标，不提供主观建议。
关键词列优先：先展示
```
query
```
/
```
queryCn
```
（中文翻译），再展示
```
searchVolume
```
、
```
count30GrowthRate
```
、
```
productCount
```
、
```
sellers
```
、
```
avgPrice
```
；同时展示
```
dimension.naturalRank
```
和
```
dimension.type
```
（自然/广告）以说明SKU在该关键词下的排名情况。
俄语关键词：保留原始
```
query
```
；
```
queryCn
```
字段提供中文翻译（若可用）。
渠道标签：当省略
```
type
```
参数且同时返回自然词和广告词时，展示
```
dimension.type
```
（
```
0
```
自然搜索 /
```
1
```
广告）和
```
dimension.naturalRank
```
以便用户区分。
大结果集：当
```
total
```
数值较大时，展示前几行数据并提醒用户可通过下方的大响应模式保存完整响应，或通过
```
page.page
```
参数翻页查看更多内容。
错误处理：当
```
code
```
不为
```
200
```
（或
```
errcode
```
不为
```
200
```
）时，根据
```
msg
```
/
```
errmsg
```
解释错误原因，并建议调整SKU列表或筛选条件。

Important Limitations

重要限制

skuIds
+
hasVariant
+
page
required: a payload missing any of these is rejected.
skuIds
capped at 20: pass more than 20 and the request is rejected or truncated.
No keyword seed: this endpoint has no
```
keyword
```
parameter — it is reverse (SKU → keywords), not expansion (keyword → keywords). Use the keyword mining skill to expand from a seed.
No
searchDate
/
categories
input: only
```
historyDate
```
(historical month) is accepted; there is no category filter. Use the market keyword search skill for month- or category-scoped browsing.
Nested fields:
```
products[*]
```
(Top 商品) and
```
dimension
```
(per-term back-search metrics:
```
type
```
,
```
naturalRank
```
,
```
exposure
```
,
```
conversion
```
,
```
x
```
) are structured and decision-useful — see
```
references/api.md
```
for sub-fields.
```
categoryInfos
```
is defined in the schema/columns but is not returned in
```
data[*]
```
on this endpoint (same as the keyword-mining sibling; the market-keyword-search sibling does return it — don't assume parity).
```
relevancy
```
is likewise defined in the schema but not returned.

skuIds
+
hasVariant
+
page
为必填项：缺少其中任何一个参数的请求都会被拒绝。
skuIds
上限为20个：传入超过20个SKU的请求会被拒绝或截断。
无关键词种子参数：此接口没有
```
keyword
```
参数——它是反向查询（SKU→关键词），而非关键词拓展（关键词→关键词）。如需从种子词拓展，请使用关键词挖掘技能。
无
searchDate
/
categories
输入参数：仅接受
```
historyDate
```
（历史月份）参数；无分类筛选功能。如需按月份或分类浏览，请使用市场关键词搜索技能。
嵌套字段：
```
products[*]
```
（Top商品）和
```
dimension
```
（单关键词反查指标：
```
type
```
、
```
naturalRank
```
、
```
exposure
```
、
```
conversion
```
、
```
x
```
）为结构化且具有决策价值的字段——详见
```
references/api.md
```
中的子字段。
```
categoryInfos
```
在schema/列中定义，但本接口的
```
data[*]
```
中不会返回该字段（与关键词挖掘技能一致；市场关键词搜索技能会返回该字段——请勿假设功能一致）。
```
relevancy
```
同样在schema中定义，但不会返回。

User Expression & Scenario Quick Reference

用户表达与场景速查

Applicable — SKU-driven Ozon keyword reverse lookup:

User Says	Scenario
"反查这个 Ozon 商品 / SKU 的关键词"	Reverse keyword lookup for a SKU
"这个 Ozon 链接有哪些搜索词带来流量"	Traffic-word discovery for a listing
"Ozon 竞品 SKU 的出单词 / 流量词"	Competitor traffic-word mining
"Ozon 某商品的自然词 / 广告词"	Organic vs ad term breakdown
"Ozon 关键词反查、按 SKU 反查关键词"	Generic reverse keyword lookup

Not applicable — Needs beyond SKU-driven reverse lookup:

Browse/rank the whole market's hot keywords (no SKU) → use the Seerfar Ozon market keyword search skill.
Expand outward from a seed keyword → use the Seerfar Ozon keyword mining skill.
A specific SKU's price/sales/stock → use a product-level Seerfar Ozon data source.
A specific seller's catalog → use the Seerfar Ozon shop search skill.
Category-tree browsing → use the Seerfar Ozon category search skill.

Boundary judgment: if the user has a product/SKU (own or competitor) and wants the search terms it ranks for, start here. If they want to browse the market (no SKU) or expand from a seed keyword, route to the market keyword search or keyword mining skill respectively.

适用场景 — 以SKU为驱动的Ozon关键词反查：

用户表述	场景
"反查这个Ozon商品/SKU的关键词"	单个SKU的关键词反查
"这个Ozon链接有哪些搜索词带来流量"	Listing流量词挖掘
"Ozon竞品SKU的出单词/流量词"	竞品流量词挖掘
"Ozon某商品的自然词/广告词"	自然词与广告词拆分分析
"Ozon关键词反查、按SKU反查关键词"	通用关键词反查需求

不适用场景 — 超出以SKU为驱动的反查范围：

浏览/排名整个市场的热门关键词（无SKU）→ 使用Seerfar Ozon市场关键词搜索技能。
从种子词拓展关键词 → 使用Seerfar Ozon关键词挖掘技能。
查询特定SKU的价格/销量/库存 → 使用Seerfar Ozon产品级数据源。
查询特定卖家的商品目录 → 使用Seerfar Ozon店铺搜索技能。
分类树浏览 → 使用Seerfar Ozon分类搜索技能。

边界判断：如果用户拥有商品/SKU（自有或竞品）并希望获取其所排名的搜索词，则使用本技能。如果用户希望浏览市场（无SKU）或从种子词拓展关键词，则分别路由至市场关键词搜索或关键词挖掘技能。

积分消耗规则

消耗 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。