ESEO — marketplace product cards

面向俄罗斯市场平台（Wildberries、Ozon、Yandex Market）商品列表的 MCP 服务器。工具：score_card — SEO 评分 0–100，并附各因素提示；check_description — 根据市场平台限制检查标题和描述；marketplace_limits — 各市场平台的标题、字数和描述限制；generate_card — 生成现成的商品列表（需要 ESEO API 密钥）。前三个工具无需密钥即可使用。端点：https://eseo.su/api/mcp（Streamable HTTP）。

访问 eseo.su

托管 MCP 服务器

npx add-mcp 'https://eseo.su/api/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

ESEO для разработчиков

REST API и MCP-сервер для генерации и проверки SEO-карточек товаров через AI. Интегрируй ESEO в CMS, ERP, автоматизации и AI-агентов — Claude, ChatGPT, Cursor.

Содержание

Base URL

https://eseo.su/api/v1

Быстрый старт

Три шага: получи ключ → сделай запрос → получи карточку.

# 1. Получи API ключ в настройках → /settings
# 2. Сделай запрос
curl -X POST https://eseo.su/api/v1/generate \
  -H "Authorization: Bearer eseo_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Кроссовки Nike Air Max 90 черные мужские",
    "marketplace": "WB"
  }'

{
  "id": "clxyz1234",
  "marketplace": "WB",
  "title": "Кроссовки Nike Air Max 90 — комфорт и стиль для повседневной носки",
  "description": "Кроссовки Nike Air Max 90 — идеальный выбор для активного образа жизни...",
  "bullets": [
    "Амортизирующая подошва — снижает нагрузку на суставы",
    "Поддержка стопы — стабильность и комфорт",
    "Воздухопроницаемый верх — ноги остаются сухими",
    "Стильный дизайн — подходит для любого образа",
    "Долговечность — высокое качество материалов"
  ],
  "keywords": ["кроссовки nike", "air max 90", "мужские кроссовки"],
  "seoScore": 87,
  "createdAt": "2026-05-05T01:00:00.000Z"
}

Авторизация

Все запросы требуют заголовок Authorization. Ключи создаются в Настройках → Public API. Требуется платный тариф: Профи, Премиум и Бизнес.

Authorization: Bearer eseo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ Храни ключ в переменных окружения. Ключ показывается только при создании.

POST /generate

Генерирует SEO-карточку товара через AI.

Запрос

Поле	Тип	Обязательно	Описание
`input`	string	Да	Название / описание товара (3–500 символов)
`marketplace`	string	Нет	WB \| OZON \| YANDEX_MARKET (default: WB)

JavaScript / TypeScript

const response = await fetch('https://eseo.su/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer eseo_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    input: 'Кроссовки Nike Air Max 90 черные мужские',
    marketplace: 'WB',
  }),
});

// Rate limit info
const remaining = response.headers.get('X-RateLimit-Remaining');
const reset     = response.headers.get('X-RateLimit-Reset');

const card = await response.json();
console.log(card.title);   // SEO-заголовок
console.log(card.seoScore); // 0–100

Python

import requests

response = requests.post(
    'https://eseo.su/api/v1/generate',
    headers={
        'Authorization': 'Bearer eseo_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'input': 'Кроссовки Nike Air Max 90 черные мужские',
        'marketplace': 'WB',
    }
)

card = response.json()
print(card['title'])
print(f"SEO Score: {card['seoScore']}")

Заголовки ответа

Заголовок	Описание
`X-RateLimit-Limit`	Максимум запросов в минуту (10)
`X-RateLimit-Remaining`	Осталось запросов в текущей минуте
`X-RateLimit-Reset`	Unix timestamp сброса счётчика

Ключи API

Управляй ключами через Настройки или API.

# Список ключей
curl https://eseo.su/api/v1/keys \
  -H "Authorization: Bearer eseo_ваш_ключ"

# Создать ключ
curl -X POST https://eseo.su/api/v1/keys \
  -H "Authorization: Bearer eseo_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{"name": "Production"}'

# Удалить ключ
curl -X DELETE https://eseo.su/api/v1/keys/KEY_ID \
  -H "Authorization: Bearer eseo_ваш_ключ"

MCP-сервер для Claude, ChatGPT и Cursor

Подключите ESEO к Claude, ChatGPT, Cursor или своему агенту по протоколу MCP — агент сам проверит карточку и создаст новую. Адрес сервера: https://eseo.su/api/mcp.

Инструмент	Ключ	Что делает
`score_card`	Нет	SEO-балл карточки 0–100 с подсказками по факторам
`check_description`	Нет	Разбор описания: длина, конкретика, переспам, клише
`marketplace_limits`	Нет	Лимиты названия, слова и описания площадки
`generate_card`	Да	Готовая карточка WB, Ozon или Яндекс Маркета

Как подключить MCP-сервер: Claude Code

claude mcp add --transport http eseo https://eseo.su/api/mcp \
  --header "Authorization: Bearer eseo_ваш_ключ"

Cursor и другие клиенты (mcp.json)

{
  "mcpServers": {
    "eseo": {
      "url": "https://eseo.su/api/mcp",
      "headers": { "Authorization": "Bearer eseo_ваш_ключ" }
    }
  }
}

Без ключа работают проверка и лимиты. Для generate_card нужен ключ из Настроек на тарифах Профи, Премиум и Бизнес; лимит общий с REST API — 10 запросов в минуту на ключ.

Claude-skill «Оценка карточки» — бесплатно

Skill учит Claude проверять карточку WB, Ozon, Яндекс Маркета и Авито через наш сервер: балл 0–100, 3–5 главных замечаний и готовые правки в пределах лимитов площадки. Ключ не нужен. Claude Code — распакуйте в ~/.claude/skills/; claude.ai — «Настройки» → «Возможности» → загрузить архив.

Для сравнения: MCP-сервер Helium 10 — на тарифе Diamond или за доплату, Jungle Scout — на тарифе Cobalt (по их сайтам на 19.10.2026). У ESEO проверка карточки по MCP — без ключа и без тарифа.

Ошибки

Код	Статус	Описание
400	Некорректный запрос — проверь поля input и marketplace
401	Неверный или отсутствующий API ключ
403	Требуется платный тариф: Профи, Премиум и Бизнес
429	Превышен лимит (10 req/min). Жди X-RateLimit-Reset
502	Ошибка AI — повтори запрос
503	AI не сконфигурирован (серверная ошибка)

// Формат ошибки
{ "error": "описание ошибки" }

Лимиты

Профи, Премиум и Бизнес

Генераций в день

Без дневного лимита

Rate limit

10/мин

Free

Генераций в день

Нет доступа

Rate limit

—

При исчерпании rate limit — подожди до X-RateLimit-Reset (Unix timestamp). При исчерпании дневного лимита — генерации возобновятся на следующий день в 00:00 UTC.