Community Скиллы Российские сервисы

Ozon Listing Copilot

Codex
Открыть источник ↗ GitHub ↗
Установка 
git clone (см. README)

Описание

ozon-listing-copilot — два скилла для Codex, собирающие карточку товара Ozon: вход — фото товара и проверенные факты о нём, выход — готовый заголовок, описание на 3 000–4 000 знаков и теги, структура под требования площадки — без запрещённых приёмов и воды. Помогает продавцу быстро делать карточки на основе реальных характеристик товара, а не общих шаблонов.

Что умеет:
— писать заголовки и описания под Ozon;
— собирать теги из фактов о товаре;
— держать требуемый объём текста;
— работать в паре скиллов Codex.

Полная документация ниже — автоматически из репозитория yangsuiyuan75-afk/ozon-listing-copilot (ветка main). Оригинальные материалы проекта распространяются на условиях его лицензии.

Ozon Listing Copilot

面向俄罗斯 Ozon 市场的 Codex Skill 组合。它将商品图片与已确认的商品信息转换为符合平台规则的俄语 Listing：包含标题、3000–4000 字符详情描述、精准标签，以及按图片映射的俄语卖点文案。

本仓库包含两个需要配套安装的 Skill：

  • ozon-local-listing-optimization（仓库根目录）：Ozon 商品信息收集、图片分析、俄语文案和 Listing 生成流程。
  • anysearch/：实时公开网页检索工具，用于查找当前 Ozon 规则、俄语关键词、同义词、长尾词和使用场景词。

能做什么

  • 从商品主图、详情图和卖点图中提取可核实的信息。
  • 在开始外部检索前向用户确认商品型号、规格、材质、适用对象和禁用表述。
  • 通过 AnySearch 取得当前公开的 Ozon 规则与俄语市场语言信号。
  • 使用 Yandex Search API 的 Wordstat 数据验证关键词频次。
  • 输出一个自然、合规的俄语标题，完整的俄语详情描述，精确的 Ozon 标签，以及不重复的图片对应文案。

前置条件

  • Codex 已启用本地 Skills。
  • Python 3 可用（用于 scripts/wordstat_api.py）；AnySearch 也可使用 Python、Node.js 或 PowerShell 运行。
  • 可选：AnySearch API Key。未配置时可以匿名访问，但额度较低。
  • 若要获取 Wordstat 数值，必须拥有 Yandex Search API 的 OAuth Token 和 Cloud Folder ID。

安装

将本仓库克隆到本地后，把两个目录安装成同级 Skills。以下示例适用于 Windows PowerShell：

git clone https://github.com/yangsuiyuan75-afk/Ozon-Listing-Copilot.git

$repo = "<克隆目录>\\Ozon-Listing-Copilot"
$skills = "$env:USERPROFILE\\.codex\\skills"
Copy-Item -Recurse -Force "$repo\\anysearch" "$skills\\anysearch"
Copy-Item -Recurse -Force "$repo\\*" "$skills\\ozon-local-listing-optimization" -Exclude anysearch

安装后目录应为：

~/.codex/skills/
├── anysearch/
└── ozon-local-listing-optimization/

Ozon Skill 会把 anysearch 作为同级依赖查找，因此不要把它嵌套在 ozon-local-listing-optimization 目录中。

配置

在 Ozon Skill 目录中复制示例配置并填写真实凭据：

Copy-Item .env.example .env

.env 的内容：

YANDEX_SEARCH_API_KEY=<Yandex OAuth Token>
YANDEX_CLOUD_FOLDER_ID=<Yandex Cloud Folder ID>

AnySearch 的 API Key 为可选项。需要更高检索额度时，在 anysearch/.env 中设置：

ANYSEARCH_API_KEY=<your_api_key>

.env、runtime.conf 和 Python 缓存文件均已被 Git 忽略，切勿提交真实凭据。

使用方式

在 Codex 中提供商品图片和基础资料，然后调用：

使用 $ozon-local-listing-optimization 优化这款商品的 Ozon Listing。

Skill 会先整理信息并等待确认；只有在你明确确认资料完整后，才会进行 AnySearch 和 Wordstat 调研并生成最终 Listing。

仓库结构

.
├── SKILL.md                         # Ozon Skill 指令
├── agents/openai.yaml               # Codex 入口配置
├── references/research-and-rules.md # 调研规则与证据要求
├── scripts/wordstat_api.py          # Yandex Wordstat API 查询脚本
├── scripts/validate_listing.py      # Listing 校验脚本
├── .env.example                     # Yandex 凭据模板
└── anysearch/                       # 随仓库提供的检索依赖

安全与数据

  • 不要在聊天、截图或 Git 提交中暴露 API Key、OAuth Token 或 Cloud Folder ID。
  • AnySearch 会将搜索查询和待提取的公开 URL 发送至其服务；请勿用于密码、个人信息或商业机密。
  • Keyword 频次只以 Yandex API 返回的数据为准；AnySearch 搜索结果仅用于定性发现与验证。