linkfox-seerfar-ozon-market-keyword-search

Seerfar Ozon Market 关键词搜索

此技能可在 Seerfar 分析数据库中搜索 Ozon 市场关键词，并按丰富的表现指标进行筛选，包括搜索量、30 天增长率、商品／卖家／竞争对手数量、平均价格、月销量／销售额、转化率与浏览量集中度、评分／评论数等。每个返回的关键词都附带完整的市场概况（市场空间、退货／取消率、热门商品、中文翻译），可作为 Ozon 关键词筛选、蓝海词挖掘和市场机会分析的起点。

核心概念

数据单位是关键词，而非 SKU：与商品搜索不同，此端点返回的是市场搜索词（“热词”），每个词都附带市场指标。你可以发现哪些搜索词值得在 Ozon 上投放。

平台覆盖范围：每条关键词记录都包含 platform 字段（0 = Ozon，1 = Wildberries）。数据集以 Ozon 为主；有数据时也会返回 Wildberries 记录。输入参数无法限定平台，需要时可在客户端筛选。

日期含义：searchDate 用于选择数据月份。传入 2026-04-01 可获取 2026 年 3 月的数据；省略该参数则获取最近 30 天的数据。searchVolume（月搜索热度）和 count30GrowthRate（月搜索增长）等指标均相对于所选周期计算。

匹配模式：matchType 用于控制 keywords 数组的匹配方式：0 表示精确匹配，1 表示模糊匹配。按关键词文本筛选时，请根据探索目的选择匹配模式。

参数

参数	类型	必填	说明
page	object	是	分页 {page, pageSize, orders[]}。page 从 1 开始（默认值为 1），pageSize 默认值为 20。orders[] = {field, direction}，其中 direction 为 DESC／ASC。
keywords	array	否	用于筛选的关键词列表（最多 1000 个）；与 matchType 配合使用。
matchType	integer	否	关键词匹配模式：0 精确匹配，1 模糊匹配。
searchDate	string	否	数据日期 yyyy-MM-dd；默认获取最近 30 天的数据。2026-04-01 → 2026 年 3 月的数据。
categories	array	否	类别 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 加载到上下文中。

解决认证和算力问题

发生以下异常情况时，请参照 references/onboarding.md 解决问题：

异常情况

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

使用示例

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

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

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

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

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

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

4. 指定数据月份并设置最低销量

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

如何构建查询

1. 优先设置 page.orders：数据集很大——始终按关注的指标排序（热门词按 searchVolume DESC，上升词按 count30GrowthRate DESC，低竞争词按 sellers ASC）。
2. 组合范围筛选条件以寻找机会：结合较高的 searchVolume 下限和较低的 sellers 上限，筛选蓝海关键词；添加 conversionSharing / marketSpace 范围条件以评估需求。
3. 使用 keywords + matchType 确定细分范围：传入俄语种子词，并设置 matchType: 1（模糊匹配），以列出相关长尾词。
4. 选择合适的 searchDate：省略该参数可查看当前趋势（最近 30 天）；传入明确日期可进行逐月比较。

展示规则

1. 仅展示数据：以清晰的表格展示关键词指标，不提供主观建议。
2. 关键词列优先：先展示 query / queryCn（中文翻译），然后是 searchVolume、count30GrowthRate、productCount、sellers、avgPrice。
3. 俄语关键词：保留原始 query；如果有中文翻译，queryCn 字段会提供该翻译。
4. 平台标签：同时存在 Ozon 和 Wildberries 数据行时，显示 platform（0/1），方便用户区分。
5. 大型结果集：当 total 较大时，展示排名靠前的行，并提醒用户可以使用下方的大响应模式持久化完整响应，或通过 page.page 翻页。
6. 错误处理：当 code 不是 200（或 errcode 不是 200）时，根据 msg / errmsg 说明原因，并建议调整筛选条件。

重要限制

• 必须提供 page：不包含 page 的负载会被拒绝。
• 没有平台选择器：Ozon/Wildberries 的组合由服务端控制；通过 platform 字段在客户端筛选。
• 类目 ID 不透明：categories 需要 Seerfar 类目 ID，而不是人类可读的名称。
• 分页上限：使用 pageSize 和 page 翻页；服务端可能会限制很大的 pageSize 值。
• 嵌套字段：products[*]（Top 商品）和 categoryInfos[*]（类目路径与可跨境标识）采用结构化格式，可辅助决策——子字段参见 references/api.md。dimension / columns 不透明或仅部分填充；relevancy / titleDensity / wordCount 通常缺失。

用户表达与场景速查

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

用户表达	场景
“Ozon 热词 / 热搜词有哪些”	按搜索量查找最热门的关键词
“Ozon 蓝海词、低竞争高搜索的词”	挖掘蓝海词（搜索量高、卖家少）
“Ozon 上升词 / 近期增长快的词”	查找上升关键词（按增长率排序）
“围绕某个俄语词的长尾词”	模糊关键词扩展
“Ozon 某关键词的市场空间/竞品数/卖家数”	关键词市场概况

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

• 特定 SKU 的价格/销量/库存 → 使用商品级 Seerfar Ozon 数据源，而非此关键词端点。
• 特定卖家的商品目录 → 使用卖家/店铺级 Seerfar Ozon 数据源。
• 浏览类目树 → 使用类目级 Seerfar Ozon 数据源。
• 非 Ozon/Wildberries 的电商平台 → 此处不涵盖。

边界判断：如果用户想根据市场指标在 Ozon 上发现并排序搜索词，从这里开始。如果用户已有 SKU / 卖家 / 类目，并想查询其下的实体，则路由到对应的 Seerfar Ozon 数据源。

算力消耗规则

消耗 15 算力。

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

反馈：

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

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

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

---

如需获取更多高质量、专业的跨境电商技能，请设置 LinkFox Skills。