MCP Авито с блоком Рекламы и поиском по инструментам

avito-mcp (Bakugan's fork)

Личный форк MCP-сервера Авито: те же 148 инструментов upstream плюс чтение статистики Авито Рекламы и поиск нужного инструмента по смыслу

MCP-серверРоссийский стек

timoshinoleg-eng/avito-mcpАвтор:timoshinoleg-eng

Установка

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

npx skillfoxx add mcp/avito-mcp-bakugan-s-fork

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

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

Выполните в терминале

claude mcp add --transport stdio --env 'Client_id=<ваш Client_id>' --env 'Client_secret=<ваш Client_secret>' --env 'Profile_id=<значение Profile_id>' avito-mcp -- npx -y avito-mcp@1.2.0

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "avito-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp@1.2.0"
      ],
      "env": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "avito-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp@1.2.0"
      ],
      "env": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"avito-mcp","type":"stdio","command":"npx","args":["-y","avito-mcp@1.2.0"],"env":{"Client_id":"<ваш Client_id>","Client_secret":"<ваш Client_secret>","Profile_id":"<значение Profile_id>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "avito-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp@1.2.0"
      ],
      "env": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add avito-mcp --env 'Client_id=<ваш Client_id>' --env 'Client_secret=<ваш Client_secret>' --env 'Profile_id=<значение Profile_id>' -- npx -y avito-mcp@1.2.0

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.avito-mcp]
command = "npx"
args = ["-y", "avito-mcp@1.2.0"]
env = { Client_id = "<ваш Client_id>", Client_secret = "<ваш Client_secret>", Profile_id = "<значение Profile_id>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "avito-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp@1.2.0"
      ],
      "env": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "avito-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp@1.2.0"
      ],
      "env": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "avito-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp@1.2.0"
      ],
      "env": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "avito-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp@1.2.0"
      ],
      "env": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "avito-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "avito-mcp@1.2.0"
      ],
      "environment": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "avito-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp@1.2.0"
      ],
      "env": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "avito-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "avito-mcp@1.2.0"
      ],
      "env": {
        "Client_id": "<ваш Client_id>",
        "Client_secret": "<ваш Client_secret>",
        "Profile_id": "<значение Profile_id>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

Client_idсекрет, обязательная: Avito OAuth client_id (from https://www.avito.ru/professionals/api).
Client_secretсекрет, обязательная: Avito OAuth client_secret (from https://www.avito.ru/professionals/api).
Profile_idобязательная: Avito profile id (numeric account id); auto-injected into {user_id}/{userId} path params.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 34e008b.

Текст для агента

Установи сервер из репозитория timoshinoleg-eng/avito-mcp по README (upstream учетные данные Авито обязательны, AVITO_ADS_* нужны только для домена ads), подключи как MCP по stdio или удаленно, при необходимости разреши домен ads через AVITO_MCP_ALLOWED_TOOL_DOMAINS.

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

npm install && npm run build

Стандартная сборка Node/TypeScript-проекта, точную команду запуска смотрите в README и .mcp.json.example.

Проверка безопасности

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

Низкий рискНизкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.

Новые инструменты домена ads только читают баланс и статистику, без создания или оплаты кампаний
Домен ads не регистрируется без явно заданных ключей и не входит в дефолтную политику доступа

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

Что делает

Проект форкнут от elchin92/avito-mcp и добавляет поверх него два домена. Домен ads оборачивает официальный SDK avito-ads и дает 7 инструментов только на чтение: баланс кабинета, список рекламодателей, договоров, кампаний, групп объявлений, креативов и статистика по кампании. Эти инструменты не регистрируются, пока не заданы переменные AVITO_ADS_*, и не входят в стандартную группу read-политики, их нужно явно разрешить через AVITO_MCP_ALLOWED_TOOL_DOMAINS. Домен lookup портирован с Python на TypeScript из скрипта MissiaL/avito-api и добавляет полнотекстовый поиск по описаниям всех 148 инструментов upstream, чтобы агент мог найти нужный по смыслу запроса, а не по точному имени. Операции создания и списания денег в Рекламе сознательно не включены как высокорисковые.

Для кого. Для тех, кто уже пользуется upstream avito-mcp и хочет добавить чтение статистики Авито Рекламы и удобный поиск среди полутора сотен инструментов.

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

Нужны инструменты upstream avito-mcp плюс чтение баланса и статистики рекламных кампаний Авито
148 инструментов трудно перебирать вручную, нужен поиск по смыслу
Устраивает форк энтузиаста без гарантии синка с upstream и без отправки PR туда

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

Нужны только базовые инструменты Авито: проще ставить оригинальный elchin92/avito-mcp
Нужно управлять рекламными кампаниями: создание, оплата и запуск в форк не включены
Важна поддержка и совместимость с релизами upstream: форк синхронизируется вручную по решению автора

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

Найди инструмент, который показывает баланс моего рекламного кабинета Авито, и вызови его

MCP

Транспорт: stdio
Авторизация: API-ключ

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

AVITO_ADS_CLIENT_ID секрет: OAuth client ID отдельного приложения Авито Рекламы, без него домен ads не регистрируется
AVITO_ADS_CLIENT_SECRET секрет: OAuth client secret приложения Авито Рекламы
AVITO_ADS_ACCOUNT_ID: Числовой ID рекламного аккаунта
AVITO_MCP_ALLOWED_TOOL_DOMAINS: Список доменов инструментов, разрешенных к регистрации, например ads,lookup

Ограничения

Это личный форк одного автора для соло-использования, а не поддерживаемый проект: PR в upstream не планируются, синк делается вручную при значимых релизах. Домен ads требует отдельного OAuth-приложения Авито Рекламы (AVITO_ADS_CLIENT_ID и CLIENT_SECRET) вдобавок к учетным данным основного API. Ноль звезд, README на русском описывает только новые домены, за базовыми 148 инструментами нужно смотреть upstream.

Как отключить. Уберите сервер из конфигурации MCP-клиента; чтобы отключить только Рекламу, не задавайте переменные AVITO_ADS_*.

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

Чем это отличается от elchin92/avito-mcp?

Тем же набором из 148 инструментов плюс 7 read-only инструментов Авито Рекламы и полнотекстовым поиском по инструментам (lookup_search).

Можно ли создавать и оплачивать рекламные кампании?

Нет, автор сознательно оставил только чтение: создание, оплата и изменение статусов кампаний не реализованы как высокорисковые.

MCP-серверы

Salesforce DX MCP Server

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483

Скиллы Яндекс.Кит для управления магазином

kit-skills

Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий риск29

YouGile MCP от Indalo

YouGile MCP

Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий риск

MCP-сервер портала Битрикс24

Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий риск

Коротко о README

FORK-NOTES.md подробно фиксирует происхождение форка (upstream elchin92/avito-mcp, часть кода lookup портирована с MissiaL/avito-api), список из 7 новых read-only инструментов домена ads с их SDK-обвязкой, переменные окружения и политику доступа к домену, а также объясняет, почему write-операции Рекламы не включены.

Установка

Проверка безопасности

Что делает

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

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

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

MCP

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

Ограничения

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

Похожие

Salesforce DX MCP Server

Скиллы Яндекс.Кит для управления магазином

YouGile MCP от Indalo

MCP-сервер портала Битрикс24

Коротко о README