linkfox-seerfar-ozon-keyword-mining

Seerfar Ozon 关键词挖掘

此技能会在 Seerfar 分析数据库中围绕种子关键词挖掘 Ozon 市场关键词，并根据丰富的表现指标筛选发现的词条，包括搜索量、30 天增长、商品／卖家／竞品数量、平均价格、相关性、标题密度、加购转化率等。每个挖掘出的关键词都附带完整的市场概况（市场空间、退货／取消率、热门商品、中文翻译），可作为拓展 Ozon 关键词、发掘长尾词和分析种子词机会的起点。

核心概念

以种子词为起点，而非浏览市场：与市场关键词搜索不同，此端点要求提供 keyword（种子词），并返回与该种子词相关的词条，每个词条均附有市场指标。你可以从已有目标词向外拓展。

相关性是挖掘信号：relevancy 用于评估挖掘出的词条与种子词的关联程度（种子词本身的 relevancy 为 100，相关词的排名则较低）；titleDensity 反映该词条在商品标题中的出现密度。每一行都会填充这两个字段；按 relevancy 降序排序，可确保拓展结果切合主题。

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

匹配模式：matchType 控制种子 keyword（以及 includeKeywords）的匹配方式：0 表示精确匹配，1 表示模糊匹配。选择模糊匹配可扩大拓展范围，选择精确匹配则可缩小范围。

不支持日期或类别选择器：此端点不接受 searchDate 或 categories。如需按月比较或按类别浏览，请改用市场关键词搜索技能。

参数

参数	类型	必填	描述
keyword	string	是	种子关键词；挖掘将围绕该词展开（maxLength 1000）。
page	object	是	分页 {page, pageSize, orders[]}。page 从 1 开始（默认值为 1），pageSize 默认值为 20。orders[] = {field, direction}，其中 direction 为 DESC／ASC。
matchType	integer	否	关键词匹配模式：0 精确匹配，1 模糊匹配。
includeKeywords	array	否	必须出现的词条（最多 1000 个）；用于缩小拓展范围。
excludeKeywords	array	否	要排除的词条（最多 1000 个）；用于移除不相关的拓展结果。
wordCount	{min,max}	否	关键词字数／字符数范围。
searchVolume	{min,max}	否	月搜索量范围。
searchChange30	{min,max}	否	30 天搜索变化范围。
productViews	{min,max}	否	商品浏览量范围。
products	{min,max}	否	商品数量范围。
sellers	{min,max}	否	卖家数量范围。
price	{min,max}	否	平均价格范围。
marketSpace	{min,max}	否	市场空间范围。
conversionSharing	{min,max}	否	转化集中度范围。
relevancy	{min,max}	否	与种子词的相关性范围。
uniqQueriesWCa	{min,max}	否	加购次数范围。
ca	{min,max}	否	加购转化率范围。
titleDensity	{min,max}	否	标题密度范围。
adRivalCount	{min,max}	否	广告竞品数量范围。
uId	string	否	用户 ID。
memberId	string	否	会员 ID（数据归属）。

所有范围筛选器均为 {min, max} 对象；可以提供一个或两个边界。keyword 和 page 均为必填项。

调用方式

• API 端点：POST /seerfar/ozon/keywordMining（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/seerfar_ozon_keyword_mining.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带有 24h 本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时，先向用户说明会产生额外消耗。

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-seerfar-ozon-keyword-mining-<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. 围绕种子词扩展（按搜索量排序）

{"keyword": "платье", "page": {"page": 1, "pageSize": 10, "orders": [{"field": "searchVolume", "direction": "DESC"}]}}

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

{"keyword": "телефон", "page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}, "searchVolume": {"min": 10000}, "sellers": {"max": 50}}

3. 结合相关性和标题密度，保持扩展结果切题

{"keyword": "наушники", "page": {"page": 1, "pageSize": 20, "orders": [{"field": "relevancy", "direction": "DESC"}]}, "relevancy": {"min": 50}}

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

{"keyword": "часы", "page": {"page": 1, "pageSize": 20}, "includeKeywords": ["женские"], "excludeKeywords": ["ремень"], "matchType": 1}

如何构建查询

1. 始终以种子 keyword 开头：该参数必填，用于定义扩展中心。在 Ozon 上查询时请使用俄语。
2. 以 page.orders 开头：按关注的指标排序（按人气排序用 searchVolume DESC，按相关性排序用 relevancy DESC，按竞争较低排序用 sellers ASC）。
3. 叠加范围筛选条件以寻找机会：结合较高的 searchVolume 下限和较低的 sellers 上限，找出蓝海扩展；添加 relevancy / titleDensity 范围，确保结果与种子词相关。
4. 使用 includeKeywords / excludeKeywords 引导扩展：强制加入必需的修饰词并剔除无关词，无需运行第二次查询。

展示规则

1. 仅展示数据：以清晰的表格展示挖掘到的关键词指标，不提供主观建议。
2. 关键词列置前：依次展示 query / queryCn（中文翻译）、searchVolume、count30GrowthRate、productCount、sellers、avgPrice；展示 relevancy，以体现与种子词的接近程度（种子词本身为 100）。
3. 俄语关键词：保留原始 query；若有中文翻译，则由 queryCn 字段提供。
4. 平台标签：同时存在 Ozon 和 Wildberries 行时，展示 platform（0/1），以便用户区分。
5. 大型结果集：当 total 较大时，展示靠前的行，并提醒用户可通过下文的大型响应模式保存完整响应，或使用 page.page 继续翻页。
6. 错误处理：当 code 不是 200（或 errcode 不是 200）时，根据 msg / errmsg 说明原因，并建议调整种子关键词或筛选条件。

重要限制

• 必须提供 keyword + page：缺少任一项的请求都会被拒绝。
• 没有日期选择器：不存在 searchDate；无法在此选择数据月份。需要按月份限定的数据时，请使用市场关键词搜索技能。
• 没有类别选择器：不接受将 categories 作为输入；每个返回的关键词都包含一个 categories ID 数组，可在客户端进行分组或筛选。
• 不会返回 dimension / categoryInfos：两者都在架构中定义并显示为 columns，但此端点的真实 data[*] 行不会填充它们。（同系列的市场关键词搜索端点会填充 categoryInfos——不要假设两者行为一致。）
• 嵌套字段：products[*]（Top 商品）是结构化且对决策有用的数据——子字段见 references/api.md。（categoryInfos[*] 为保证架构完整性而记录，但此端点不会返回；dimension / columns 的含义不明确或仅部分填充。）

用户表达与场景快速参考

适用 — 基于种子词扩展 Ozon 关键词：

用户表达	场景
“围绕 XX 词挖一下 Ozon 相关词”	种子关键词扩展
“Ozon 长尾词挖掘 / 拓展某个词的长尾”	围绕种子词挖掘长尾词
“Ozon 某词的蓝海拓展词、低竞争高搜索”	蓝海扩展（搜索量高、卖家少）
“Ozon 跟 XX 相关的词有哪些、相关度高的”	按相关度排序的扩展
“Ozon 某词拓展，但排除/必须包含某些词”	按要求包含/排除词语的扩展

不适用 — 需求超出基于种子词的关键词挖掘：

• 不提供种子词，浏览/排名整个市场的热门关键词 → 使用 Seerfar Ozon 市场关键词搜索技能。
• 查询特定 SKU 的价格/销量/库存 → 使用 Seerfar Ozon 商品级数据源。
• 查询特定卖家的商品目录 → 使用 Seerfar Ozon 卖家/店铺级数据源。
• 按月或按类别浏览关键词 → 使用市场关键词搜索技能（支持 searchDate / categories）。

边界判断：如果用户想要从种子词向外扩展，并根据市场指标对相关词排序，请从这里开始。如果用户想要浏览整个市场的关键词（没有种子词），或按月份/类别筛选，则转到市场关键词搜索技能。

算力消耗规则

消耗 23 算力。

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

反馈：

在以下任一情况适用时，通过 Feedback API 自动检测并提交反馈：

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

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

---

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