Авито MCP

elchin92/avito-mcp· Проверено 12.11.2026· 26на GitHub

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

Как подключить

Что сделать до подключения

Node.js 22.12 или новее

Аккаунт Авито с доступом к API

Client_id, Client_secret, Profile_id

на странице API аккаунта Авито: avito.ru/professionals/api; Profile_id — числовой

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'Client_id=<Client_id>' --env 'Client_secret=<Client_secret>' --env 'Profile_id=<Profile_id>' --env AVITO_MCP_MODE=read_only --transport stdio avito \
  -- npx -y avito-mcp@2

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.avito]
command = "npx"
args = ["-y", "avito-mcp@2"]

[mcp_servers.avito.env]
Client_id = "<Client_id>"
Client_secret = "<Client_secret>"
Profile_id = "<Profile_id>"
AVITO_MCP_MODE = "read_only"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "avito": {
      "command": "npx",
      "args": ["-y", "avito-mcp@2"],
      "env": {
        "Client_id": "<Client_id>",
        "Client_secret": "<Client_secret>",
        "Profile_id": "<Profile_id>",
        "AVITO_MCP_MODE": "read_only"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "avito": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "avito-mcp@2"],
      "env": {
        "Client_id": "<Client_id>",
        "Client_secret": "<Client_secret>",
        "Profile_id": "<Profile_id>",
        "AVITO_MCP_MODE": "read_only"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "avito": {
      "command": "npx",
      "args": ["-y", "avito-mcp@2"],
      "env": {
        "Client_id": "<Client_id>",
        "Client_secret": "<Client_secret>",
        "Profile_id": "<Profile_id>",
        "AVITO_MCP_MODE": "read_only"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "avito": {
      "command": "npx",
      "args": ["-y", "avito-mcp@2"],
      "env": {
        "Client_id": "<Client_id>",
        "Client_secret": "<Client_secret>",
        "Profile_id": "<Profile_id>",
        "AVITO_MCP_MODE": "read_only"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "avito": {
        "type": "local",
        "command": ["npx", "-y", "avito-mcp@2"],
        "environment": {
          "Client_id": "<Client_id>",
          "Client_secret": "<Client_secret>",
          "Profile_id": "<Profile_id>",
          "AVITO_MCP_MODE": "read_only"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "avito": {
      "command": "npx",
      "args": ["-y", "avito-mcp@2"],
      "env": {
        "Client_id": "<Client_id>",
        "Client_secret": "<Client_secret>",
        "Profile_id": "<Profile_id>",
        "AVITO_MCP_MODE": "read_only"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "avito": {
      "command": "npx",
      "args": ["-y", "avito-mcp@2"],
      "env": {
        "Client_id": "<Client_id>",
        "Client_secret": "<Client_secret>",
        "Profile_id": "<Profile_id>",
        "AVITO_MCP_MODE": "read_only"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

user_get_user_balanceпоказывает баланс

items_get_items_infoперечисляет объявления

items_get_item_infoчитает объявление

items_post_item_stats_shallowпоказывает просмотры и контакты

items_post_account_spendingsпоказывает расходы по дням

items_update_priceменяет цену объявления

items_put_item_vasподключает платные услуги продвижения

stock_update_stocksобновляет остатки

messenger_get_chats_v2перечисляет чаты

messenger_get_messages_v3читает переписку

messenger_post_send_messageотправляет сообщение

messenger_chat_readотмечает чат прочитанным

meta_confirm_actionподтверждает отложенное действие

meta_cancel_actionотменяет отложенное действие

Показано 14 из 148.

Что попросить агента

«Через Avito покажи мой баланс и первую страницу активных объявлений. Ничего не меняй»Прочитает баланс через user_get_user_balance и список объявлений через items_get_items_info

«Составь утренний отчёт Avito за вчера: баланс, активные объявления, просмотры, контакты и расходы»Вызовет user_get_user_balance и items_get_items_info, статистику по ID пачками до 200 возьмёт через items_post_item_stats_shallow, расходы — через items_post_account_spendings

«Разбери до 20 непрочитанных чатов: суть, следующий шаг и черновик ответа. Ничего не отправляй»Получит непрочитанные чаты через messenger_get_chats_v2, переписку — через messenger_get_messages_v3, данные объявления — через items_get_item_info

«Покажи цену объявления <ID> и подготовь изменение на <1400> рублей, только предпросмотр»Прочитает объявление через items_get_item_info и вызовет items_update_price с dryRun: true; рабочий запрос уйдёт после вашего одобрения и meta_confirm_action

Для каких задач

Собрать утренний отчёт: баланс, активность объявлений и расходы с датами

Разобрать непрочитанные чаты по приоритету и набросать ответы

Поменять цену объявления через предпросмотр и подтверждение

Посмотреть статусы доставки, трек-номера и коды маркировки заказов

Подготовить продвижение: ставки CPA, прогнозы и платные услуги

Ограничения

Без AVITO_MCP_MODE сервер стартует в режиме full_access; в read_only видно 80 инструментов

Подтверждение из двух вызовов агент может пройти сам, это не доказывает согласия человека; для настоящего контроля нужны подтверждения в клиенте

API аукциона, автостратегии, Автотеки, вакансий, отчётов по недвижимости и посуточной аренды в сервер не входят

Автоответы и отчёты по расписанию сервер сам не запускает: нужен отдельный агент или планировщик

Если не работает

Сервера нет в клиенте или ошибка ENOENT

Проверьте node --version и npx --version: нужен Node 22.12+. Если у клиента другой PATH, укажите абсолютный путь к исполняемому файлу и перезапустите клиент.

Первый запуск не успевает завершиться

Скачайте пакет заранее командой npx -y avito-mcp@2 --version или увеличьте время ожидания в клиенте.

Avito возвращает 401

Проверьте, что ID клиента, секрет и профиль относятся к нужному аккаунту, и вызовите meta_auth_status с probe: true.

Avito возвращает 429

Посмотрите retryAfter и meta_get_rate_limits, подождите и сократите число одновременных запросов.

Ответ OUTCOME_UNKNOWN после изменения

Запрос ушёл, но ответ потерян, и изменение могло выполниться: до повтора проверьте реальный заказ, сообщение или объявление.

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

Можно попробовать без аккаунта Авито?

Да: npx -y avito-mcp@2 --demo запускает демо на вымышленных 53 объявлениях и 2 непрочитанных чатах. Запросов в Авито оно не шлёт и ключей не требует.

Как не дать агенту ничего менять?

Оставьте в конфиге AVITO_MCP_MODE=read_only. Есть ещё режим guarded и списки AVITO_MCP_ALLOW_TOOLS и AVITO_MCP_DENY_TOOLS, а dryRun: true показывает запрос без отправки.

Агент может сам отвечать покупателям?

Он готовит черновики и отправляет сообщение отдельным подтверждённым действием. Автоответы по входящим событиям требуют внешнего агента: сервер только принимает вебхуки Авито и складывает события в буфер.

Можно подключить как удалённый сервер?

Да, через Streamable HTTP на своём HTTPS-домене с OAuth 2.1: задайте AVITO_MCP_TRANSPORT=http, AVITO_MCP_HTTP_PUBLIC_URL и AVITO_MCP_OAUTH_OWNER_PASSWORD.

Работает ли сервер из России?

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