mcpField
L
linkfox-mpstats-ozon-seller-products

linkfox-mpstats-ozon-seller-products

github.com/linkfox-ai营销与增长113414 次安装2 周前更新
代码仓库

关于 linkfox-mpstats-ozon-seller-products

该 LinkFox skill 按指定 Ozon 卖家列出其商品 SKU 及销售、收入、价格、评分和库存等指标，供店铺结构审查与竞店比较。支持数值筛选、排序、分页和币种设置。

主要功能

  1. 01按卖家查询商品 SKU
  2. 02销售、收入及库存等指标
  3. 03数值条件筛选与排序
  4. 04分页获取结果
  5. 05可设置币种并纳入 FBS

适用场景

  1. 01盘点店铺商品并按销量排序
  2. 02筛选高周转或潜在断货商品
  3. 03比较两家店铺的商品表现

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-mpstats-ozon-seller-products

安装后在 Claude Code 中输入/linkfox-mpstats-ozon-seller-products确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
onboarding.md
scripts/
mpstats_ozon_seller_products.py
onboarding.py

详细介绍

MPSTATS Ozon 卖家商品

此技能可深入分析指定卖家在 Ozon（俄罗斯）销售的所有商品，返回每个 SKU 的销量、收入、价格、评分、库存、周转、利润损失等数据。适用于店铺结构审计、分析店铺内的畅销商品，以及与竞争对手店铺进行正面对比。

核心概念

使用卖家 ID，而非名称：sellerId 必须是数字字符串，即 Ozon / MPSTATS 用于识别店铺的 sellerId 字段。请勿传入品牌名称、类目路径或人类可读的卖家名称。如果只有卖家名称，请通过 mpstats-ozon-product-search（按卖家筛选）查询 ID，并从结果中读取 sellerId。

筛选器与运算符：与 brand-products 和 category-products 使用相同的数值筛选器 AND 组合模型。请参阅筛选器参考。

货币：默认使用 RUB；可通过 currency / currencyRate 切换为 USD / EUR / CNY 视图。

FBO / FBS：includeFbs: true 会将 FBS 数据计入统计；false 则仅统计 FBO。

参数

参数类型必填描述
sellerIdstring是Ozon 卖家 ID，数字字符串，例如 "3628678"
startDatestring否统计窗口起始日期，YYYY-MM-DD；最新为昨天
endDatestring否统计窗口结束日期，YYYY-MM-DD；最新为昨天
pageinteger否页码，从 1 开始
pageSizeinteger否每页行数，1-100，默认为 100
sortFieldstring否snake_case 列（sales、revenue 等）
sortDirectionstring否asc / desc
currencystring否货币代码，默认为 RUB
currencyRateinteger否非默认货币的自定义汇率
includeFbsboolean否是否包含 FBS 数据
filtersarray否数值筛选器列表

筛选器参考

每个 filters 条目：{"field": "<snake_case>", "op": "<OP>", "value": <num>, "value2": <num?>}。

常见字段：sales、final_price、rating、comments、balance、revenue、days_in_stock、turnover_days、lost_profit、category_position。

运算符：GTE、LTE、GT、LT、EQ、NOT_EQ、BETWEEN（需要 value2）。

调用方式

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

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

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-mpstats-ozon-seller-products-<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. 按销量排名的卖家前 100 款商品

{
  "sellerId": "3628678",
  "sortField": "sales",
  "sortDirection": "desc",
  "pageSize": 100
}

2. 店铺收入前 20 名

{
  "sellerId": "3628678",
  "sortField": "revenue",
  "sortDirection": "desc",
  "pageSize": 20
}

3. 高周转明星商品

{
  "sellerId": "3628678",
  "filters": [
    {"field": "sales", "op": "GTE", "value": 30},
    {"field": "turnover_days", "op": "LTE", "value": 20}
  ],
  "sortField": "revenue",
  "sortDirection": "desc"
}

4. 店铺缺货痛点

{
  "sellerId": "3628678",
  "filters": [{"field": "lost_profit", "op": "GTE", "value": 100000}],
  "sortField": "lost_profit",
  "sortDirection": "desc"
}

5. 换算为 USD 的店铺审计

{
  "sellerId": "3628678",
  "currency": "USD",
  "sortField": "revenue",
  "sortDirection": "desc"
}

展示规则

  1. 紧凑的店铺表格 — 关键列：productId、title、brand、price、monthlySalesUnits、monthlySalesRevenue、rating、balance、turnoverDays、lostProfit、position。
  2. 销售额占比 = 当前卖家查询范围内的占比 — 0-100%；请说明计算基准。
  3. 俄语标题 — 保留原文；用户要求时再翻译。
  4. 货币标注 — 如果进行了换算，请注明 "已按 USD 换算"。
  5. 分页 — 对于拥有数千个 SKU 的店铺，建议先缩小筛选范围，再深入翻页。
  6. 不提供购买建议 — 此技能展示店铺的商品目录，不判断其 SKU 是否值得仿效。

重要限制

  • 仅支持数字卖家 ID — 传入卖家名称无法解析；请先使用 mpstats-ozon-product-search。
  • 页数上限 — 每页最多 100 行。
  • T-1 数据 — endDate 不能是今天或未来日期。
  • 不提供商业建议 — 仅提供数据。
  • 仅限 Ozon — Wildberries 和其他俄罗斯电商平台需使用单独的工具。

用户表达与场景速查

适用 — 按卖家筛选的 Ozon 商品指标：

用户表达场景
"显示卖家 3628678 按销量排序的所有商品"店铺 SKU 映射
"这家 Ozon 店铺销售额最高的商品有哪些"店铺畅销商品分析
"这家店铺有多少 SKU 的周转天数 <20 天"运营健康度筛选
"这家店铺有哪些商品因缺货而损失利润"利润损失扫描
"比较两家 Ozon 店铺的 SKU 数量和销量"店铺对比（调用两次）

不适用 — 需求超出卖家维度的下钻分析：

  • 只知道卖家名称 → 使用 mpstats-ozon-product-search 解析 ID
  • 按品牌下钻 → mpstats-ozon-brand-products
  • 按类目下钻 → mpstats-ozon-category-products
  • 单个 SKU 时间序列 → mpstats-ozon-product-trend
  • Wildberries 和其他俄罗斯电商平台 → 不涵盖

边界判断：当分析维度是特定卖家，且需要该店铺的 SKU 明细表时，使用此技能。若要查询“类目 X 中销量最高的卖家”，应使用类目下钻分析，并在客户端按卖家分组。

算力消耗规则

按动态规则计费：消耗算力 = 12。列表为空返回 0

重要：本技能的服务按倍数动态计算，可能一次性消耗大量算力，必须提醒用户，由用户决定是否继续。

反馈：

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

  1. 此技能所述的功能或用途与实际行为不符
  2. 技能结果不符合用户意图
  3. 用户对本技能表示不满或称赞
  4. 任何你认为可以改进的地方

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

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

评论

支持 Markdown