AI Cross Border Ecommerce Agent Toolkit — скилл

Семь рабочих процессов для продавца на Shopee и Mercado Livre: анализ категории, цены, карточка, изображения, видео, реклама и отзывы

  • 977 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл запускает скрипты Python на ваших выгрузках по категории, рекламе и отзывам и читает эти файлы
  • В выгрузках бывают данные магазина и покупателей, поэтому такие файлы не стоит передавать без нужды
Все причины и проверки

heqiangdiao-wq/ai-cross-border-ecommerce-agent-toolkit

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/ai-cross-border-ecommerce-agent-toolkit

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл запускает скрипты Python на ваших выгрузках по категории, рекламе и отзывам и читает эти файлы
  • В выгрузках бывают данные магазина и покупателей, поэтому такие файлы не стоит передавать без нужды

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл превращает регламент кросс-граничной торговли в семь процессов, которые агент выполняет по шагам. Корневой SKILL.md работает как маршрутизатор: по запросу пользователя он открывает нужный подмодуль, у каждого подмодуля свои правила, промпты, шаблоны ввода и пример на реальном товаре. Первые два модуля считают. Анализ категории разбирает выгрузку площадки скриптами: емкость рынка, концентрацию продавцов, ценовые пояса и комплектацию. Стратегия товара рассчитывает чистую маржу, цену безубыточности и запас под купоны для каждого SKU, а модель цен подставляет комиссии пяти площадок. Цифры агент не угадывает: если поля в выгрузке нет, он сообщает об этом и просит данные. Дальше идут карточка, изображения и видео. Для карточки скрипты измеряют длину заголовка и сверяют параметры с таблицей характеристик, для главного изображения проверяют пиксели, для видео проверяют длительность и субтитры. Замыкают процесс разбор рекламной воронки по четырем типам и анализ отзывов по восьми причинам. Их выводы возвращаются в карточку и изображения, после чего правки проверяют повторно. Покупательские тексты пишутся на бразильском португальском.

Для кого. Для продавцов и менеджеров маркетплейсов, которые ведут магазины на Shopee Бразилия и Mercado Livre и хотят получать от агента стабильный результат по регламенту.

Подходит, если

  • Перед запуском товара нужно оценить категорию по выгрузке: емкость, концентрацию продавцов и ценовые пояса
  • Нужно рассчитать цену и структуру SKU с учетом комиссии площадки, купонов и целевой маржи
  • Нужно написать заголовок и описание на португальском с проверкой длины и соответствия параметров таблице характеристик
  • Реклама сливает бюджет, и вы хотите диагностику воронки с границей рентабельности и приоритетами действий
  • Накопились негативные отзывы, и их нужно разложить по причинам и превратить в правки карточки

Не подходит, если

  • Нужны действия в кабинете продавца: набор не меняет цены и бюджеты, он выдает список действий для вашего решения
  • Нужны накрутка заказов, провокация отзывов или ложные жалобы на конкурентов: такие запросы набор отклоняет
  • Нужен сбор данных с площадки: выгрузки по категории, рекламе и отзывам вы приносите сами
  • Нужно готовое изображение или видео: набор составляет план и промпты, рисуют и монтируют другие инструменты

Пример запроса к агенту

Разбери категорию электросамокатов по этой выгрузке: емкость, концентрацию продавцов и ценовые пояса, потом предложи цену для SKU с комиссией Shopee

Ограничения

Набор заточен под Shopee Бразилия и Mercado Livre. Для Amazon, TikTok Shop и Shopify адаптированы только поля. Правила площадок взяты на момент написания, перед публикацией их нужно сверить в кабинете продавца. Модель цен не включает бразильские налоги, ставку добавляете вы.

Выгрузки по категории, рекламе и отзывам даете вы, сбора данных в наборе нет. Изображения и видео набор не создает. Он готовит план и промпты. Действия в кабинете и смену цен и бюджетов он не выполняет.

В папке docs лежит оригинальный внутренний регламент на 38 страниц без правок. В нем описаны приемы, которые площадки запрещают, а модули их не реализуют. Статус проекта: бета-версия, в описании репозитория значится 0.3, в SKILL.md 0.4.0.

Как отключить. Удалите папку набора из каталога скиллов агента и откройте новую сессию. Файлов вне этой папки скилл не создает, результаты лежат там, куда вы сохранили выгрузки и тексты.

Частые вопросы

Какие площадки поддерживает набор?

Shopee и Mercado Livre поддержаны полностью: лимиты заголовков, правила главных изображений и тексты на португальском. Для Amazon, TikTok Shop и Shopify адаптированы поля, но подробных правил нет.

Нужен ли ключ API?

Нет. Ключ и подключение к площадкам не нужны: достаточно текстовых файлов набора и выгрузок, которые вы приносите. Для скриптов нужен Python, скрипт ad_metrics использует только стандартную библиотеку.

Что считают скрипты, а что делает агент?

Скрипты считают концентрацию рынка, ценовые пояса, чистую маржу, цену безубыточности, длину заголовков и статистику отзывов. Агент трактует результат и пишет тексты. Правило набора: все, что можно посчитать, не оставляют на догадку модели.

Как работает замкнутый цикл?

Диагностика рекламы и разбор отзывов указывают, какая часть карточки или изображений подводит. Агент правит только эту часть, потом идет повторная проверка. Если результата нет, набор возвращает к диагностике и не усиливает то же действие.

Что с запрещенными приемами площадок?

Накрутка заказов, провокация отзывов, ложные жалобы и завышение параметров не реализованы. В документе Compliance Guard даны допустимые замены, а список невыполненных пунктов регламента ведется отдельно.

Как поставить набор в Claude Code?

Склонируйте репозиторий командой git clone и положите папку в ~/.claude/skills. Корневой SKILL.md маршрутизирует запросы к подмодулям, поэтому ставить подмодули по отдельности не нужно.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

E-commerce Visual Copywriting

ecommerce-visual-copywriting

Скилл превращает данные о товаре в план главных фото, карточки и A+ с текстом на картинках, промптами для генерации и проверкой заявлений

СкиллМинимальный доступ1 тыс.Звезды репозитория

Набор агентских скиллов для партнерского маркетинга: поиск программ, разбор трендов, статьи и посты, лендинги и аналитика

ПлагинРасширенный доступ767Звезды репозитория

Девять скиллов для выхода на зарубежный рынок: реклама Meta, Google и TikTok, письма, UGC, соцсети и стратегия на 90 дней.

ПлагинМинимальный доступ173Звезды репозитория
Выбор редакции

Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов

СкиллМинимальный доступ58,8 тыс.Звезды репозитория

Скилл и CLI clipcat помогают продавцу TikTok Shop находить продающие ролики и выпускать похожие со своим товаром

СкиллШирокий доступ457Звезды репозитория

Marketing & SEO Skills

Marketing & SEO Skills for AI Agents

Библиотека из сотен маркетинговых и SEO-скиллов для агента: контент, типы страниц, каналы, реклама и стратегии

СкиллМинимальный доступ1,1 тыс.Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
AI Cross Border Ecommerce Agent Toolkit (эта карточка)нет977
Агенты clawEC для кроссбордерной торговлинет72агенты для Amazon, TikTok, Shopee и Ozon с акцентом на подбор товара
LinkFox Skillsнет119153 навыка поверх платного API LinkFox, данные берутся из сервиса
Ozon Product Card Studio: исследование карточекнет0готовит карточки для Ozon по анализу конкурентов

Коротко о README

Описание на китайском объясняет, что набор состоит из методики, промптов, шаблонов и примеров и не приложение и не сервис. Дальше идут таблица семи модулей с версиями, схема цепочки от анализа категории до разбора отзывов, структура папок и список поддерживаемых площадок. В конце даны принципы проекта, оговорки о соответствии правилам площадок и дорожная карта до версии 1.0.

Бейдж для README

Исходный SKILL.md

---
name: sop-ecom-toolkit
description: >-
  跨境电商运营 AI 工具箱总入口(Shopee 巴西站 / Mercado Livre 专精,PT-BR)。
  覆盖 7 条工作流:市场调研、产品策略与定价、Listing 文案、商品图(9 图框架)、
  短视频物料、广告诊断、评论分析,以及"诊断→回改→复测"闭环。
  当用户要"看类目 / 定价 / 写标题 / 写详情页 / 做主图 / 做详情图 / 9 张图 /
  做视频 / 分镜 / 配音字幕 / 广告诊断 / ROAS / ACOS / 差评分析 / 卖点提炼 /
  优化转化"时使用。中文「做图 / 做视频 / 看类目 / 算价格 / 分析评论」同样触发。
  NOT for 账号操作、刷单测评等平台禁止行为、纯 Excel 透视。
allowed-tools:
  - Bash(python *)
  - Read
  - Write
metadata:
  version: 0.4.0
  category: e-commerce/operations
  license: MIT
---

# AI Cross Border Ecommerce Agent Toolkit(总入口)

本文件夹是**伞形 Skill**:先按下面的路由表判断用户要做哪件事,
**再打开对应子模块的 SKILL.md 严格照做**——子模块里有各自的规则卡、
算术脚本与底线约束,本文件只负责路由,不替代子模块的细节。

## 全局三条底线(任何子模块都继承)

1. **不编数据** —— 输入缺字段报 `[INPUT_MISSING]` 并列出可用列,不许猜;
   指标一律跑 `scripts/` 下的脚本,Agent 不心算
2. **合规优先** —— 刷单/诱导评价/虚假宣传/恶意举报等平台禁止行为不做
   (见 `docs/03_Compliance_Guard.md`、`docs/05_SOP_Gap_Register.md`)
3. **买家可见文本 = 目标市场母语(PT-BR)**,内部备注用中文;
   所有数字必须溯源到 `spec_table`

## 路由表

| 用户要做的事 | 打开哪个子模块 |
|---|---|
| 看类目 / 市场容量 / 集中度 / 价格带 / 配置机会 | [Agents/01_Market_Research_Agent/SKILL.md](Agents/01_Market_Research_Agent/SKILL.md) |
| 定价 / SKU 结构 / 优惠券额度 / 目标毛利反算 | [Agents/02_Product_Strategy_Agent/SKILL.md](Agents/02_Product_Strategy_Agent/SKILL.md) |
| 标题 / 详情页 / 卖点提炼 / 关键词分类 / 合规扫描 | [Agents/03_Listing_Creative_Agent/SKILL.md](Agents/03_Listing_Creative_Agent/SKILL.md) |
| 主图 / 白底图 / 场景图 / 9 张图 / 图合规检查 | [Agents/04_Product_Image_Agent/SKILL.md](Agents/04_Product_Image_Agent/SKILL.md) |
| 视频 / 分镜 / AI 视频 Prompt / 配音 / 字幕 | [Agents/05_Product_Video_Agent/SKILL.md](Agents/05_Product_Video_Agent/SKILL.md) |
| 广告诊断 / ROAS / 盈亏线 / 预算动作 | [Agents/06_Advertising_Optimization_Agent/SKILL.md](Agents/06_Advertising_Optimization_Agent/SKILL.md) |
| 差评归因 / 评论统计 / 卖点排行 / 修补文案 | [Agents/07_Review_Analysis_Agent/SKILL.md](Agents/07_Review_Analysis_Agent/SKILL.md) |

**跨模块闭环**(用户在做完整运营时提醒他这条链路):

Сообщить о проблеме

Foxx AIAI Cross Border Ecommerce Agent Toolkit
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.