listingbureau-mcp

Name: Listing Bureau - Amazon Organic Ranking
Author: listingbureau

Кампании по органическому ранжированию для товаров на Amazon, управляемые через вашего ИИ-ассистента.

Единственный MCP-сервер для Amazon, сфокусированный на ранжировании. Создавайте кампании, настраивайте расписание, отслеживайте позиции по ключевым словам и мониторьте динамику ранга прямо из Claude, Cursor или любого другого MCP-совместимого клиента.

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

🚀 Что он делает

Этот MCP-сервер подключает вашего ИИ-ассистента к инфраструктуре ранжирования на Amazon от Listing Bureau. Три типа сигналов способствуют улучшению органического ранга:

Search-Find-Buy (SFB) сигнализирует алгоритму A10, что реальные покупатели искали ключевое слово, нашли товар и купили его
Add-to-Cart (ATC) формирует сигналы о намерении совершить покупку и добавить товар в корзину
Page Views (PGV) генерируют поведение просмотра на уровне сессии, что поддерживает органическое обнаружение

Ваш ассистент берет на себя весь рабочий процесс: создание проекта для любого ASIN и ключевого слова, настройка ежедневного расписания кампании, оценка затрат перед запуском и получение отчетов о позициях для отслеживания динамики.

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

Claude Desktop (в один клик)

Скачайте расширение для рабочего стола и дважды щелкните для установки. Claude Desktop запросит ваш API-ключ.

Скачать listingbureau-mcp.mcpb (требуется Claude Desktop 4.0+)

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "listingbureau": {
      "command": "npx",
      "args": ["-y", "listingbureau-mcp"],
      "env": {
        "LB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Установите плагин из маркетплейса:

/plugin install listingbureau@claude-plugins-official

Это установит MCP-сервер и навык методологии кампаний. Установите LB_API_KEY в переменные окружения оболочки перед запуском Claude Code.

claude mcp add listingbureau -e LB_API_KEY=your-api-key -- npx -y listingbureau-mcp

Cursor

После нажатия замените your-api-key-here на ваш реальный API-ключ в диалоговом окне перед подтверждением.

Добавьте в .cursor/mcp.json (для проекта) или ~/.cursor/mcp.json (глобально):

{
  "mcpServers": {
    "listingbureau": {
      "command": "npx",
      "args": ["-y", "listingbureau-mcp"],
      "env": {
        "LB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Любой MCP-клиент

Запустите сервер через npx и настройте клиент для подключения через stdio:

npx -y listingbureau-mcp

Установите LB_API_KEY в качестве переменной окружения. См. спецификацию MCP для настройки конкретного клиента.

🔑 Получить API-ключ

Создайте аккаунт на listingbureau.com. Ваш API-ключ находится в панели управления в разделе Settings.

⚙️ Переменные окружения

Переменная	Обязательно	По умолчанию	Описание
`LB_API_KEY`	Да	-	API-ключ Listing Bureau
`LB_BASE_URL`	Нет	`https://listingbureau.com`	Базовый URL API (переопределите для staging/dev)

🔧 Инструменты

21 инструмент в 7 категориях.

📂 Проекты (6 инструментов)

Инструмент	Описание
`lb_projects_list`	Список проектов с фильтрами по региону/активности
`lb_projects_create`	Создание нового проекта Amazon (ASIN + ключевое слово + регион)
`lb_projects_get`	Получение деталей проекта (расписание, услуги, данные SERP)
`lb_projects_update`	Обновление проекта (пауза/возобновление)
`lb_projects_archive`	Архивация (мягкое удаление) проекта
`lb_projects_get_stats`	Получение ежедневной статистики (SFB, ATC, PGV, SERP, ARA, BR, SQR)

📅 Расписание (3 инструмента)

Инструмент	Описание
`lb_schedule_get`	Получение текущего ежедневного расписания
`lb_schedule_set`	Установка полного ежедневного расписания (заменяет существующее)
`lb_schedule_quick_set`	Быстрая установка равномерных ежедневных объемов

💲 Оценка стоимости (1 инструмент)

Инструмент	Описание
`lb_estimate_cost`	Оценка стоимости кампании перед запуском. Вычисляет общую стоимость, средние дневные показатели и устойчивость кошелька.

💰 Кошелек (3 инструмента)

Инструмент	Описание
`lb_wallet_get_balance`	Получение баланса кошелька (кредиты и USD)
`lb_wallet_get_transactions`	Получение истории транзакций (с пагинацией)
`lb_wallet_topup`	Генерация ссылки Stripe для пополнения баланса кошелька

📦 Заказы (3 инструмента)

Инструмент	Описание
`lb_orders_list`	Список заказов (с пагинацией, сначала новые)
`lb_orders_get`	Получение деталей заказа
`lb_orders_report_issue`	Сообщение о проблеме с заказом

👤 Аккаунт (4 инструмента)

Инструмент	Описание
`lb_account_get`	Получение информации об аккаунте (email, имя, статус, баланс)
`lb_account_update_profile`	Обновление профиля (first_name, last_name, company)
`lb_account_get_service_rates`	Получение текущих тарифов на услуги
`lb_account_get_subscription`	Получение информации о подписке (план, комиссия, скидка)

💬 Обратная связь (1 инструмент)

Инструмент	Описание
`lb_feedback_submit`	Отправка отзыва, запроса на функцию или предложения (10-5000 символов)

🧠 Навык методологии кампаний

MCP-сервер поставляется с сопутствующим навыком в skills/amazon-product-ranking/, который предоставляет пошаговый рабочий процесс кампании из 9 этапов. Навык обучает ИИ эффективно использовать инструменты: оценка товара, анализ конкуренции, выбор профиля воронки, графики наращивания, прогнозы затрат/ROI, выполнение и мониторинг.

Claude Code (плагин): Плагин Claude Code включает этот навык автоматически. Установите через /plugin install listingbureau@claude-plugins-official.

Claude Code (вручную): Скопируйте или создайте символическую ссылку на папку skills/amazon-product-ranking/ в вашу директорию .claude/skills/.

Другие платформы: Инструкции сервера автоматически ссылаются на этот навык. ИИ может прочитать методологию по ссылке на GitHub, включенной в инструкции.

🛠️ Разработка

npm install
npm run build
npm run dev    # watch mode
npm test

🔗 Ссылки

📄 Лицензия

MIT

Listing Bureau - Amazon Organic Ranking