linkfox-seerfar-ozon-keyword-back-search

Seerfar Ozon 关键词反向查询

此技能可在 Seerfar 分析数据库中，根据一组商品 SKU ID反向查询 Ozon 搜索关键词：传入最多 20 个 SKU（自己的商品或竞品均可），即可获取这些商品出现过的搜索词——自然搜索词和/或广告搜索词，并为每个搜索词补充完整的市场概况（搜索量、30 天增长率、商品/卖家/竞品数量、平均价格、转化集中度、热门商品，以及 dimension 对象中的各搜索词自然/广告渠道、自然排名、曝光量和转化数据）。这是 Ozon 关键词反向查询、商品标题优化和竞品流量词发现的起点。

核心概念

由 SKU 驱动，而非由关键词驱动：与关键词挖掘（从种子词扩展）或市场关键词搜索（浏览整个市场）不同，此端点接收 skuIds，返回这些特定商品排名所对应的搜索词。查询方向是商品 → 关键词（反向查询）。

必须设置 hasVariant：每次请求都必须声明是否排除变体——0 表示保留变体，1 表示排除变体。如果要获取去重后的父商品关键词覆盖情况，请选择 1。

自然搜索词与广告搜索词：type 用于筛选搜索词渠道——["0"] 仅返回自然搜索词，["1"] 仅返回广告搜索词；省略则返回两者。可结合 naturalRank / adRank 范围筛选项来筛选排名。

反向查询指标位于 dimension 中：每个返回的搜索词都包含一个 dimension 对象，其中包含反向查询专属指标——type（0 表示自然搜索，1 表示广告）、naturalRank（该 SKU 在此搜索词下的自然排名）、exposure（曝光份额，范围为 0–1）、conversion（转化率，范围为 0–1）和 x（不透明的位置指示值）。输入筛选项 type / naturalRank / adRank / exposure / conversion 会根据相同的逐搜索词指标进行筛选。注意：架构中定义了 relevancy，但此端点不会返回该字段。

平台覆盖范围：每条关键词记录都包含一个 platform 字段（0 = Ozon，1 = Wildberries）。数据集以 Ozon 为主；有可用数据时也会包含 Wildberries 记录。没有输入参数可限制平台范围——如有需要，请在客户端进行筛选。

匹配模式：matchType 用于控制 includeKeywords / excludeKeywords 的匹配方式——0 表示精确匹配，1 表示模糊匹配。

参数

参数	类型	必填	描述
skuIds	array	是	反向查询 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	否	搜索词渠道筛选：0 自然流量，1 广告流量；省略时表示两者都包含。
historyDate	string	否	历史月份 yyyy-MM（例如 2026-02）；省略时表示当前周期。
includeKeywords	array	否	必须出现的词（最多 1000 个）。
excludeKeywords	array	否	要排除的词（最多 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 进入上下文。

解决认证和算力问题

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

异常情况

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

使用示例

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

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

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

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

3. 仅查询广告搜索词，并设置广告排名下限

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

4. 使用包含/排除列表缩小范围

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

如何构建查询

1. 始终先提供 skuIds + hasVariant：两者都是必填项，用于定义反向查询目标。使用真实的 Ozon SKU ID（与 Seerfar Ozon 商品／店铺／类目技能返回的 ID 相同）。
2. 优先使用 page.orders：按你关注的指标排序（流量权重用 searchVolume DESC，竞争较低用 sellers ASC，上升趋势用 count30GrowthRate DESC）。
3. 使用 type 区分自然流量和广告：传入 ["0"] 或 ["1"]，分别用于商品列表优化（自然流量）或广告分析，然后限定 naturalRank / adRank，筛选排名位置——这些筛选条件针对每行 dimension 中显示的值。
4. 使用 includeKeywords / excludeKeywords 引导结果：纳入必需的修饰词并排除无关结果，无需执行第二次查询。

显示规则

1. 只呈现数据：将反向查询得到的关键词指标以清晰的表格展示，不提供主观建议。
2. 关键词列放在前面：依次显示 query / queryCn（中文翻译），然后是 searchVolume、count30GrowthRate、productCount、sellers、avgPrice；显示 dimension.naturalRank 和 dimension.type（自然流量／广告），说明该 SKU 在每个词下的排名。
3. 俄语关键词：保留原始 query；如果有中文翻译，queryCn 字段会提供译文。
4. 渠道标签：省略 type 且结果中同时包含自然流量和广告行时，显示 dimension.type（0 为自然流量／1 为广告）和 dimension.naturalRank，以便用户区分。
5. 结果集较大时：当 total 较大时，展示排名靠前的行，并提醒用户可使用下方的大型响应模式保存完整响应，或通过 page.page 继续翻页。
6. 错误处理：当 code 不是 200（或 errcode 不是 200）时，根据 msg / errmsg 说明原因，并建议调整 SKU 列表或筛选条件。

重要限制

• 必须提供 skuIds + hasVariant + page：缺少其中任一项的请求都会被拒绝。
• skuIds 上限为 20：传入超过 20 个时，请求会被拒绝或截断。
• 不支持关键词种子：此端点没有 keyword 参数——它执行的是反向查询（SKU → 关键词），而非扩展查询（关键词 → 关键词）。如需从种子词进行扩展，请使用关键词挖掘技能。
• 不接受 searchDate / categories 输入：仅支持 historyDate（历史月份）；没有类目筛选条件。按月份或类目浏览时，请使用市场关键词搜索技能。
• 嵌套字段：products[*]（Top 商品）和 dimension（每个词的反向搜索指标：type、naturalRank、exposure、conversion、x）均为结构化且有助于决策的数据——子字段请参阅 references/api.md。categoryInfos 在架构／列定义中有说明，但此端点不会在 data[*] 中返回该字段（与关键词挖掘同类技能相同；市场关键词搜索同类技能会返回该字段——不要假定两者一致）。relevancy 同样在架构中有定义，但不会返回。

用户表达与场景快速参考

适用 — 基于 SKU 的 Ozon 关键词反查：

用户说法	场景
“反查这个 Ozon 商品 / SKU 的关键词”	反查 SKU 的关键词
“这个 Ozon 链接有哪些搜索词带来流量”	挖掘商品页的流量词
“Ozon 竞品 SKU 的出单词 / 流量词”	挖掘竞品流量词
“Ozon 某商品的自然词 / 广告词”	拆分自然词与广告词
“Ozon 关键词反查、按 SKU 反查关键词”	通用关键词反查

不适用 — 需求超出基于 SKU 的关键词反查：

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

边界判断：如果用户有一个商品 / SKU（自有或竞品），并想知道它的排名搜索词，请从此处开始。如果用户想要浏览市场（没有 SKU）或从种子关键词扩展，则分别转至市场关键词搜索技能或关键词挖掘技能。

算力消耗规则

消耗 23 算力。

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

反馈：

在以下任一情况出现时，通过 Feedback API 自动检测并报告反馈：

1. 此技能描述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户表达对这项技能的不满或赞扬
4. 你认为有任何可以改进之处

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

---

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