核心用法
Seerfar Ozon Keyword Mining 是一款专为俄罗斯电商平台 Ozon（及 Wildberries）设计的种子词驱动型关键词挖掘工具。用户提供一个种子关键词后，系统围绕该核心词进行智能拓展，返回大量相关关键词及其完整的市场画像数据。
核心调用模式为 POST 请求至 /seerfar/ozon/keywordMining 端点，必需参数仅两项：keyword（种子词，最大 1000 字符）和 page（分页与排序配置）。支持通过 matchType 控制匹配精度（0 精确/1 模糊），并可叠加丰富的筛选维度：搜索量范围（searchVolume）、30 日增长率（searchChange30）、商品数（products）、卖家数（sellers）、均价区间（price）、相关度（relevancy）、标题密度（titleDensity）、加购转化率（ca）等，实现从海量词库中精准定位高价值机会词。
典型应用场景包括：① 围绕种子词拓展长尾关键词，按搜索量降序发现流量入口；② 构建"高搜索量+低卖家数"组合筛选，挖掘蓝海市场机会；③ 通过 relevancy 和 titleDensity 双重约束，确保拓展词与核心业务高度相关；④ 利用 includeKeywords/excludeKeywords 精确控制词向量方向。
显著优点
数据维度丰富：每个挖掘词附带 15+ 项核心指标，包括月搜索热度、30 日增长趋势、市场空间、竞品/卖家数量、平均客单价、加购转化率、Top 商品列表及中文翻译，形成完整的竞争情报视图。
智能相关度评分：独创的 relevancy 机制（种子词自评为 100，关联词逐级递减）让用户直观判断拓展词与核心业务的语义距离，避免拓展偏离主题。
双平台覆盖：单一接口同时返回 Ozon（platform=0）和 Wildberries（platform=1）数据，便于跨平台选品决策，尽管当前以 Ozon 数据为主。
灵活的精细化筛选：支持 12 组数值范围筛选器 + 2 组关键词包含/排除规则，可构建复杂的选词策略，如"搜索量>5000 且卖家数<30 且相关度>60"的精准蓝海定位。
本地化友好：返回字段包含 queryCn 中文翻译，降低俄语运营团队的认知门槛。
潜在缺点与局限性
无时间维度选择：接口不接受 searchDate 参数，无法按月份筛选历史数据或进行趋势对比，需配合市场关键词搜索技能实现时序分析。
无类目前置筛选：不支持按商品类目预过滤，只能在返回结果后通过 categories 字段客户端二次分组，类目明确的场景效率受限。
字段完整性差异：dimension、categoryInfos 等字段在 schema 中定义但实际数据行中未填充，与同类端点存在行为差异，需以实际返回为准。
成本与调用限制：每次调用消耗积分，同一会话同参数组合默认仅执行一次（24 小时本地缓存），深度挖掘需多次翻页或调整参数时成本累积明显，且禁止自动试探性重试。
俄语输入依赖：种子词需使用俄语（如"платье"连衣裙）才能获得最佳拓展效果，中文或英文种子的匹配质量未明确保障。
适合的目标群体
Ozon/Wildberries 跨境卖家：需要系统性拓展关键词库、优化 Listing 搜索覆盖的电商运营人员。
选品与 market research 团队：通过"高搜索+低竞争"指标组合发现蓝海细分市场，指导采购与备货决策。
广告投放优化师：挖掘高转化潜力词，优化 PPC 广告关键词矩阵与出价策略。
跨境电商数据分析师：需要批量获取结构化市场情报，构建内部选词系统或 BI 报表。
中小卖家起步者：以种子词为起点快速了解细分市场的竞争格局与价格带分布。
常规使用风险
性能与响应风险：数据量较大时（total 数千级）单次响应体可能超过 8KB，脚本将切换为摘要输出模式，完整数据需落盘后二次读取，实时交互体验下降。
数据时效性风险：无明确数据更新频率说明，市场变化快速时（如季节性品类）返回指标可能存在滞后。
翻译准确性风险：queryCn 为系统翻译字段，存在语义偏差可能，关键决策建议核对俄语原文。
积分消耗累积：复杂筛选策略往往需要多轮试探（调整阈值、翻页浏览），积分消耗不可预估上限，需建立调用成本意识。
平台政策合规：挖掘的高热度词若涉及品牌词或受限类目，需自行完成 Ozon 平台的合规性审查，工具仅提供数据参考。
本地化路径依赖：输出文件默认写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/ 目录，容器或受限环境需确保目录可写权限，否则执行失败。