linkfox-wb-seerfar-ozon
Ozon 市场、关键词、商品、店铺和类目数据选品分析能力,支持发现机会、筛选商品、反查流量词与深度评估。
SKILL.mdskills/linkfox-wb-seerfar-ozon/SKILL.md
GitHub[!IMPORTANT] 本 Skill 必须依赖 MCP “LinkFox”。如未安装该MCP,请明确通知用户: 请先安装 LinkFox 连接器:
- 在 WorkBuddy 左侧找到 “专家·技能·连接器” → “连接器”;
- 搜索关键词 “LinkFox”,并安装连接器 “LinkFox”(注意:是 linkfox,不是 linkfox-product-selection),按指引完成登录授权;
- 返回 WorkBuddy 重试。
LinkFox Ozon选品(LinkFox Ozon Product Research)
面向 Ozon 选品、关键词研究和竞品拆解,输出可核验的市场指标、商品列表、店铺/类目汇总以及单品趋势数据。能力覆盖 7 个子能力、7 个 API/operation,关联 tool_key=seerfar_ozon:linkfox-seerfar-ozon-market-keyword-search、linkfox-seerfar-ozon-keyword-mining、linkfox-seerfar-ozon-keyword-back-search、linkfox-seerfar-ozon-shop-search、linkfox-seerfar-ozon-category-search、linkfox-seerfar-ozon-product-detail-search、linkfox-seerfar-ozon-product-report-search。
MCP 调用
| 项 | 固定值 |
|---|---|
| MCP server | LinkFox |
| 唯一工具 | proxy_call |
toolName allowlist |
seerfar/ozon/marketKeywordSearch、seerfar/ozon/keywordMining、seerfar/ozon/keywordBackSearch、seerfar/ozon/shopSearch、seerfar/ozon/categorySearch、seerfar/ozon/productDetailSearch、seerfar/ozon/productReportSearch |
| 调用结构 | {"toolName":"<精确 endpoint>","arguments":{...}};原请求体直接作为 arguments |
toolName必须从 allowlist 选择,精确匹配且区分大小写。- WorkBuddy 自动注入 MCP Authorization;MCP 配置、文档和
arguments中不得增加headers、API Key、token、JWT、手机号或其他凭证。 - 禁止 curl、
urllib、requests、httpx或其他 HTTP 方式直连工具网关;MCP 或proxy_call缺失时停止,不得静默 fallback。 - 同一任务内相同
toolName + arguments不得重复调用;收费调用失败、空结果或结果不理想时不得自动重试或改条件探测。 - 先检查 MCP 连接、schema 和
isError,再读取 text/structured content;text 为 JSON 字符串时只解析一次。随后检查下游errcode、errorCode、code、errmsg或msg,最后读取业务字段。 - 新 MCP 链路不提供旧脚本的 24 小时缓存、JSON 落盘或 stdout 摘要;仅保留非敏感调用摘要和状态用于结果追溯。
能力边界
能力范围
- 市场热词与市场画像:按搜索热度、30 天增长、商品/竞品/卖家数、价格、销量、市场空间和转化集中度筛选市场关键词;使用
linkfox-seerfar-ozon-market-keyword-search和seerfar/ozon/marketKeywordSearch。 - 种子词拓展与长尾挖掘:围绕一个俄语或其他用户提供的种子词发现相关词,并按相关度、标题密度、搜索量、竞争和加购转化筛选;使用
linkfox-seerfar-ozon-keyword-mining和seerfar/ozon/keywordMining。 - SKU 关键词反查:从最多 20 个商品 SKU 反查自然搜索词、广告搜索词及每个词的自然排名、广告排名、曝光和转化;使用
linkfox-seerfar-ozon-keyword-back-search和seerfar/ozon/keywordBackSearch。 - 店铺商品与卖家结构:按卖家/店铺 ID 分页查看商品销量、价格、评分、配送方式、卖家类型及店铺汇总;使用
linkfox-seerfar-ozon-shop-search和seerfar/ozon/shopSearch。 - 类目容量与商品排行:按类目 ID 获取类目总销量、总销售额、均价、评分、季节性和商品列表,可按历史月份及配送方式查看;使用
linkfox-seerfar-ozon-category-search和seerfar/ozon/categorySearch。 - 单品深度评估:按单个 SKU 查看价格、评分、销量、销售额、库存、类目排名、每日销量趋势、品牌、卖家、配送方式和上架时长;使用
linkfox-seerfar-ozon-product-detail-search和seerfar/ozon/productDetailSearch。 - 商品报表筛选:按销量、销售额及增长、转化、价格、评分、评论、毛利率、退货取消率、品牌、卖家、配送方式、上架时间和标签筛选商品;使用
linkfox-seerfar-ozon-product-report-search和seerfar/ozon/productReportSearch。 - 结果追溯:新 MCP 链路不承诺旧脚本的摘要、缓存或落盘;按需展示必要字段,并记录非敏感调用摘要和状态。
边界与限制
- 所有查询由 WorkBuddy 自动授权,并按接口消耗积分;同一任务内相同
toolName + arguments只调用一次。失败或空结果不得自动换词、改筛选条件、翻页或重试探测,继续调用前先提醒用户并由用户决定。 - 数据以 Ozon 为主;关键词类结果可能带
platform=1的 Wildberries 行,接口没有平台入参选择器,需按返回的platform客户端区分。商品、店铺和类目查询不应据此推断为其他平台数据。 page是列表查询必需对象;店铺和类目pageSize最大为 20;市场关键词、关键词挖掘和反查的列表也应使用分页与排序。类目 ID、店铺 ID、SKU 必须使用 Seerfar 可识别的标识,不能用人类可读名称替代。- 关键词市场搜索必须传
page;关键词挖掘必须传keyword与page;关键词反查必须传skuIds、hasVariant与page;店铺必须传id与page;类目必须传categoryId与page;单品详情必须传sku;商品报表必须传page。 - 关键词市场搜索用于全市场关键词浏览,可选
searchDate和categories;关键词挖掘用于围绕种子词拓展,不支持searchDate、categories;关键词反查用于 SKU→关键词,不接受种子keyword,历史时间使用historyDate。 - 店铺/类目列表是分页视图,
total不等于完整店铺/类目规模时以hasNextPage继续判断;商品详情是单 SKU 查询,不能批量;商品报表的skus最多 10 个。 - 销量、销售额、库存、转化、毛利率、排名和趋势属于 Seerfar 数据或模型估计,不等同于 Ozon 官方后台数据;部分字段会因商品类型、平台卖家或上游数据缺失而不返回。
- 不提供 Ozon 账号操作、上架、订单、库存写入、广告投放、物流履约、供应链执行或其他平台运营动作;不保证选品成功,也不替用户做未经数据支持的收益或竞争结论。
工具选择指南
| 需求 / 用户说 | 默认推荐 | 何时换用其他 |
|---|---|---|
| “Ozon 热词有哪些”“按搜索量/卖家数找蓝海词” | linkfox-seerfar-ozon-market-keyword-search |
已有种子词并要相关词改用关键词挖掘;已有 SKU 并要流量词改用关键词反查 |
| “围绕这个俄语词找长尾词/相关词” | linkfox-seerfar-ozon-keyword-mining |
不提供种子、要看全市场词改用市场热词;要反查某商品排名词改用关键词反查 |
| “这个 SKU 排在哪些自然词/广告词下” | linkfox-seerfar-ozon-keyword-back-search |
要商品销量/库存/趋势改用单品详情;要按多个指标筛商品改用商品报表 |
| “这个店铺卖什么、爆品是什么、店铺总销量多少” | linkfox-seerfar-ozon-shop-search |
只有店铺名或商品名时先通过商品/列表结果取得 sellerId;要类目规模改用类目查询 |
| “这个 Ozon 类目有多大、类目热销商品/价格带是什么” | linkfox-seerfar-ozon-category-search |
只有类目名称时先解析 categoryId;要店铺维度改用店铺查询 |
| “查看一个 SKU 的详情、库存、排名或销量趋势” | linkfox-seerfar-ozon-product-detail-search |
要一次筛选多个商品或按指标排名改用商品报表;要该商品的关键词改用关键词反查 |
| “按销量、价格、评分、毛利率筛 Ozon 商品/找爆款” | linkfox-seerfar-ozon-product-report-search |
要单 SKU 的日趋势改用单品详情;要类目级汇总改用类目查询;要店铺全目录改用店铺查询 |
选择时先判断用户要查的实体是关键词、SKU、店铺还是类目,再判断是发现/筛选、反查还是深度详情;同时检查必填 ID、时间窗口、排序字段和列表上限。多个选择都能满足时,说明各自的出入参、数据粒度与额外调用成本,让用户决定是否继续。
业务需求路由速查
| 子能力 | 业务能力 | reference / API reference | toolName |
本地辅助 |
|---|---|---|---|---|
linkfox-seerfar-ozon-market-keyword-search |
全市场热词筛选与关键词市场画像 | references/linkfox-seerfar-ozon-market-keyword-search.md / references/linkfox-seerfar-ozon-market-keyword-search-api.md |
seerfar/ozon/marketKeywordSearch |
无 |
linkfox-seerfar-ozon-keyword-mining |
围绕种子词挖掘相关词与长尾词 | references/linkfox-seerfar-ozon-keyword-mining.md / references/linkfox-seerfar-ozon-keyword-mining-api.md |
seerfar/ozon/keywordMining |
无 |
linkfox-seerfar-ozon-keyword-back-search |
按 SKU 反查自然词、广告词和排名指标 | references/linkfox-seerfar-ozon-keyword-back-search.md / references/linkfox-seerfar-ozon-keyword-back-search-api.md |
seerfar/ozon/keywordBackSearch |
无 |
linkfox-seerfar-ozon-shop-search |
店铺商品目录、卖家类型与店铺汇总 | references/linkfox-seerfar-ozon-shop-search.md / references/linkfox-seerfar-ozon-shop-search-api.md |
seerfar/ozon/shopSearch |
无 |
linkfox-seerfar-ozon-category-search |
类目容量、季节性与类目商品排行 | references/linkfox-seerfar-ozon-category-search.md / references/linkfox-seerfar-ozon-category-search-api.md |
seerfar/ozon/categorySearch |
无 |
linkfox-seerfar-ozon-product-detail-search |
单 SKU 详情、销量趋势、库存与排名 | references/linkfox-seerfar-ozon-product-detail-search.md / references/linkfox-seerfar-ozon-product-detail-search-api.md |
seerfar/ozon/productDetailSearch |
无 |
linkfox-seerfar-ozon-product-report-search |
多指标商品报表筛选与商品级排名 | references/linkfox-seerfar-ozon-product-report-search.md / references/linkfox-seerfar-ozon-product-report-search-api.md |
seerfar/ozon/productReportSearch |
无 |
每个 reference 文件都包含对应能力说明、边界、参数和使用规则;同名 -api.md 文件保留完整请求参数、响应字段、错误码、MCP 与响应示例。
调用方式
- 按【业务需求路由速查】选择一个 reference 和对应的精确
toolName。 - 从 reference 请求参数表构造
arguments,原请求对象直接传入,不增加传输层字段。 - 使用
proxy_call调用一次;相同参数不重复收费调用,失败后不猜测其他toolName。 - 按 MCP 外层、代理内容、下游业务错误、业务字段的顺序解析。完整 schema、错误码、响应示例及独立 Feedback API 见同名
-api.md。
使用示例
以下示例均为真实 arguments 形状。执行前确认必要 ID 和积分预算;每个响应都可能包含 costToken。
1. 全市场热词与蓝海筛选
{
"page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]},
"searchVolume": {"min": 10000},
"sellers": {"max": 50}
}
使用 toolName=seerfar/ozon/marketKeywordSearch 调用 proxy_call。重点读取 data[].query/queryCn、searchVolume、count30GrowthRate、productCount、sellers、avgPrice、marketSpace 和 products[];platform=0/1 分别标注 Ozon/Wildberries。该接口必须有 page,不能用人类可读类目名代替 categories。
2. 围绕种子词挖掘长尾词
{
"keyword": "телефон",
"page": {"page": 1, "pageSize": 20, "orders": [{"field": "relevancy", "direction": "DESC"}]},
"matchType": 1,
"includeKeywords": ["женские"],
"excludeKeywords": ["ремень"],
"searchVolume": {"min": 1000},
"sellers": {"max": 50}
}
使用 toolName=seerfar/ozon/keywordMining 调用 proxy_call。读取 query/queryCn、relevancy、titleDensity、wordCount 和市场指标;该接口必须有 keyword 与 page,不支持 searchDate、categories,不能当作全市场热词浏览接口。
3. 反查 SKU 的自然词或广告词
{
"skuIds": [4380710124],
"hasVariant": 1,
"type": ["0"],
"naturalRank": {"max": 10},
"page": {"page": 1, "pageSize": 20, "orders": [{"field": "searchVolume", "direction": "DESC"}]}
}
使用 toolName=seerfar/ozon/keywordBackSearch 调用 proxy_call。读取 query/queryCn、搜索市场指标以及 dimension.type、dimension.naturalRank、dimension.exposure、dimension.conversion;type:["0"] 为自然词,type:["1"] 为广告词。skuIds 最多 20 个,skuIds、hasVariant、page 均必填。
4. 店铺商品结构与爆品
{
"id": 1362816,
"page": {"page": 1, "pageSize": 20, "orders": [{"field": "sales", "direction": "DESC"}]}
}
使用 toolName=seerfar/ozon/shopSearch 调用 proxy_call。先展示店铺级 totalSales、totalRevenue、productCount、dailySales、rating 与配送分布,再展示商品的 sku、price、sales、reviewRating、sellerType、fulfillment。pageSize 最大为 20;负店铺 ID 可能代表 Ozon 自营,returnCancellationRate 缺失时显示 -。
5. 类目容量与历史月份
{
"categoryId": "15621032_15621049_115951147",
"date": "2026-02",
"fulfillment": "FBO",
"page": {"page": 1, "pageSize": 20, "orders": [{"field": "revenue", "direction": "DESC"}]}
}
使用 toolName=seerfar/ozon/categorySearch 调用 proxy_call。先读取 categoryInfo、totalSales、totalRevenue、avgPrice、rating、seasonalityAmplitude、seasonalityCoef 与日期范围,再列商品字段;fulfillment 必须是单个字符串,不是数组,categoryId 必须是 Seerfar 层级 ID。
6. 单 SKU 详情与销量趋势
{
"sku": "175924376",
"dateRange": "past_90_days"
}
使用 toolName=seerfar/ozon/productDetailSearch 调用 proxy_call。读取 title、sku、price、reviewRating、totalSales、dailySales、totalRevenue、stock、categoryRanks、salesTrendVOList、sellerName、brandName 和 fulfillment;趋势按峰值、方向和窗口概括,完整日序列按当前 MCP 响应读取。该接口每次只查一个 SKU,销量/销售额是所选窗口的模型估计。
7. 多指标商品报表筛选
{
"page": {"page": 1, "pageSize": 20, "orders": [{"field": "sales", "direction": "DESC"}]},
"monthlySales": {"min": 5000},
"price": {"max": 500},
"convToCartPdp": {"min": 1},
"returnCancellationRate": {"max": 10},
"fulfillment": ["FBO"]
}
使用 toolName=seerfar/ozon/productReportSearch 调用 proxy_call。读取 sku/title/price/sales/revenue/reviewRating/reviewCount/brandName/sellerName/fulfillment 及增长、转化、毛利和退货指标;data 与 products 是同一组商品,别把别名字段重复计数。skus 若使用,单次最多 10 个。
展示规则
- 客观呈现:用表格或分区清楚展示原始指标、查询条件、时间窗口、
total、costToken和接口状态;不要把数据直接包装成保证收益或确定性选品结论。 - 标注粒度与来源:明确当前结果是关键词、商品、店铺或类目粒度,并标注对应端点/Seerfar 数据来源;连续查询时逐项标明来源与时间窗口。
- 保留俄语与平台信息:关键词优先展示
query原文并在有值时附queryCn;关键词结果同时展示platform(0=Ozon,1=Wildberries)。反查同时展示dimension.type(0=自然,1=广告)及排名/曝光/转化。 - 货币和单位:
price、revenue、totalRevenue等按接口标注俄罗斯卢布₽;销量为件,评分按 0–5,比例/增长率带%或明确 0–1 比例,重量为 g、体积为 L。 - 避免别名重复:商品报表中
productId=sku、monthlySalesUnits=sales、monthlySalesRevenue=revenue、rating=reviewRating、brand=brandName、productPageUrl=productUrl;类目/店铺也优先选一套原始字段展示。 - 汇总与分页:店铺/类目先展示全局汇总,再展示当前页商品;
hasNextPage=true时提示可通过page.page继续,且pageSize不超过 20。大结果只展示必要行和计数,不要把完整数组直接塞入上下文。 - 时间和趋势:市场关键词
searchDate、反查historyDate、类目date、详情dateRange的语义不同,展示时写明真实数据窗口;单品salesTrendVOList概括峰值和方向,sales:0表示无销量而非缺失。 - 缺失值与空结果:schema 定义但响应缺失的字段显示
-或N/A;店铺/类目/详情的total=0空结果应提示 ID 可能错误,不要误报系统故障。店铺sellerType是本土/跨境标识,而类目顶层sellerType是配送方式计数映射,不能混淆。 - 接口错误:当
code不是"200"或errcode不是200时,透传msg/errmsg的原因并给出针对性修正;参数错误检查必填字段、ID、日期格式和枚举值,1002检查页大小,1003等限流错误等待后再由用户决定是否重试。 - 认证、费用和免责声明:401/402 或余额相关提示按下节处理;展示
costToken,在用户频繁翻页或多 SKU/多条件查询前提醒费用;Seerfar 指标是数据分析参考,不等于 Ozon 官方后台或商业保证。
解决认证和积分问题
- MCP 或
proxy_call缺失:停止业务调用,按references/onboarding.md配置并重载客户端,不使用 HTTP fallback。 - MCP 连接 401:提示重新登录 WorkBuddy、重载连接或联系管理员;不得要求用户填写 Authorization。
- 代理成功后的下游 401:按 WorkBuddy 自动授权或下游业务认证失败处理,不在
arguments中传凭证。 - 下游 402 或积分不足:引导用户访问 https://agent.linkfox.com/;不自动选套餐、下单、支付或轮询。
403和其他错误按对应 API reference 处理,不归错类。
积分消耗说明
用户会因积分消耗而支付费用。请充分评估:当需要高频调用本技能,或用户对积分消耗量预期不足时,务必提醒用户,由用户决定是否继续。