skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
linkfox-ai/linkfox-skills453 installs

linkfox-mpstats-ozon-product-search

按俄语关键词或 SKU 列表在 MPSTATS 数据库中搜索、反查 Ozon 俄罗斯站商品,获取商品编号、标题、品牌、卖家、商品链接和图片。适用于 Ozon 选品发现、批量 SKU 身份核对和竞品研究的起点,无需明确提及 MPSTATS。不适用于价格、销量、收入、评分、库存、周转、排名或趋势分析,也不适用于 Wildberries 等其他平台。

How do I install this agent skill?

npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-mpstats-ozon-product-search
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill facilitates product searching and SKU lookups on Ozon via the MPSTATS database. It uses official LinkFox vendor tools and scripts for API communication, including integrated onboarding for credential management. No malicious behaviors or unauthorized data access were detected.

  • Socketpass

    No alerts

  • Snykfail

    Risk: CRITICAL · 2 issues

What does this agent skill do?

MPSTATS Ozon 商品搜索与反查

适用范围

适用

按关键词发现 Ozon 商品,或通过已有 SKU 列表核对商品身份,为后续商品、品牌、类目和卖家研究提供线索。

场景速查

用户表达查询场景
帮我在 Ozon 找运动鞋或耳机关键词发现:展示商品、品牌和卖家。
我有一批 Ozon SKU,查一下名称批量反查:核对商品身份。
把这个中文词翻成俄语,再搜索 Ozon跨语言发现:说明翻译后的检索词。

边界

  • 需要单个或一批 SKU 的价格、销量、收入、评分、库存等指标时,使用 linkfox-mpstats-ozon-product-detail;需要单品时间序列时,使用 linkfox-mpstats-ozon-product-trend。
  • 已确定品牌、卖家或类目并要查看该维度商品及指标时,直接使用 linkfox-mpstats-ozon-brand-products、linkfox-mpstats-ozon-seller-products 或 linkfox-mpstats-ozon-category-products。品牌查询使用品牌展示名,卖家查询使用卖家 ID;类目查询需已知类目路径,本技能不负责类目树导航。
  • Wildberries 及其他非 Ozon 平台不属于本技能范围。

前置条件

先明确检索目标:区分发现商品、核对 SKU 与指标深查,收集用户的关键词或已有商品编号。请求要求与日期约定见 references/api.md。

检索与下钻流程

  1. 确认用户要查找或识别 Ozon 商品;已知研究维度且只需要指标时,按边界直接转交对应技能。
  2. 准备检索词或商品编号;中文、英文检索词先翻成俄语并说明译词。按 references/api.md 核对输入和统计窗口。
  3. 在已说明算力消耗的任务范围内检索一次,先查看摘要,按需读取已保存文件。
  4. 展示商品身份信息与本次实际返回范围。后续需要指标时,从结果中选取商品编号交给详情或趋势技能;按品牌、卖家、类目研究时交给对应维度技能。
  5. 空结果或异常按 references/api.md 解释,保留已有数据;调整条件及后续调用遵守成本约束。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/mpstats_ozon_product_search.py '<JSON 参数>' [--inline]。
  • 成本约束:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-mpstats-ozon-product-search-<timestamp>.json。<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp,当前目录不可写时应报错。
  • 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
  • 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

按动态规则计费:消耗算力 = 12;商品列表为空时消耗 0 算力 (限时)。

声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

解决认证和算力问题

出现以下情况时,按 references/onboarding.md 的指引处理:

  • 未配置接口密钥:LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
  • 响应状态码为 401 或 402。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 区分商品身份与经营指标:本技能用于身份解析。缺少经营指标不是偶发漏值,不能靠换日期重查补齐;需要指标时转交详情或维度商品技能。完整响应契约见 references/api.md。
  • 清晰展示身份信息:表格优先展示 productId、title、brand、sellerName,以 productPageUrl 和 imageUrl 作为辅助列。不得增加或编造价格、销量、评分、库存、周转、排名等列,也不得从身份信息推估这些指标。
  • 保留俄语原文:保留商品原始俄语标题;用户需要时另附中文或英文翻译。
  • 说明结果范围:区分命中总数与本次实际返回条数;命中数更大时按接口参考建议收窄检索范围,不承诺可继续翻页或取得全部命中商品。
  • 利用已有数据:同一请求优先复用缓存,按需读取已保存结果;缓存位置、禁用选项和运行约定见 references/api.md。
  • 解释错误原因:结合原始消息说明问题,按接口参考建议补充或修正输入;不要为排错自动连续发起收费请求。

使用示例

俄语关键词搜索:运动鞋

{"keyword": "кроссовки"}

SKU 批量反查

{"productIds": [1786874757, 151623766, 142257239]}

指定统计窗口:T 恤

{"keyword": "футболка", "startDate": "2025-02-01", "endDate": "2025-02-28"}

使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。


更多优质、专业的跨境电商技能,请访问 LinkFox Skill。

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/linkfox-ai/linkfox-skills/linkfox-mpstats-ozon-product-search">View linkfox-mpstats-ozon-product-search on skillZs</a>