avito-mcp (artemk1337)
avito-mcp
MCP-сервер на Go для Avito Business API: профиль, свои объявления, смена цены, чаты и отправка сообщений покупателям
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Ключи Avito API открывают профиль, объявления и переписку с покупателями
- Агент меняет цены и отправляет сообщения покупателям от имени продавца
Установка
- Работает в
- Сервисы
Ручная установка
go build -o avito-mcp ./cmd/avito-mcpЗатем укажите путь к бинарнику в конфигурации MCP-клиента и задайте переменные Avito API.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Ключи Avito API открывают профиль, объявления и переписку с покупателями
- Агент меняет цены и отправляет сообщения покупателям от имени продавца
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер на Go 1.27.1 работает по stdio и подключает агента к официальному Avito Business API продавца. Читать можно профиль с идентификатором аккаунта (`get_profile`), свои объявления с фильтрами и пагинацией (`list_items`) и одно объявление по номеру (`get_item`). Менять можно цену инструментом `update_item_price`. Для переписки есть `list_chats`, `get_chat`, `list_messages`, `send_message` и `mark_chat_read`. Идентификатор аккаунта для чатов агент передает аргументом `user_id`, сервер сам его не подставляет. Авторизация идет через OAuth2 Client Credentials по `AVITO_CLIENT_ID` и `AVITO_CLIENT_SECRET` либо готовым токеном `AVITO_ACCESS_TOKEN`. Ключи создают в кабинете продавца: «Настройки», «Avito API», «Регистрация нового приложения». Методы взяты из копии OpenAPI каталога Avito. Без ключей сервер запускается и показывает инструменты, но запросы возвращают ошибку. Для Codex Desktop на macOS в README описаны передача переменных через `env_vars` и скрипт `scripts/run-with-env-file.sh`.
Для кого. Продавцам и магазинам на Авито, которые хотят вести объявления и переписку с покупателями через агента на официальном API.
Подходит, если
- Цены на группу своих объявлений меняются фразой агенту, а не вручную в кабинете
- Непрочитанные чаты разбираются, и агент готовит ответы покупателям
- Список активных объявлений выгружается с фильтрами и пагинацией
- Ключи Avito API уже получены, а нужен MCP на готовом API вместо парсинга сайта
Не подходит, если
- Покупателю нужен поиск чужих объявлений: Business API работает со своим аккаунтом продавца
- Для чатов нет подходящей подписки или ключа основного аккаунта
- Нужны объявления сотрудников: метод `list_items` их не возвращает
Пример запроса к агенту
Покажи мои активные объявления и в каждом уменьши цену на 5 процентов, но сначала назови список и новые цены.MCP
- Транспорт
- stdio
- Авторизация
- OAuth
Переменные окружения
AVITO_CLIENT_ID- Идентификатор приложения Avito API.
AVITO_CLIENT_SECRETсекрет- Секрет приложения Avito API.
AVITO_ACCESS_TOKENсекрет- Готовый токен, имеет приоритет над парой ключей.
AVITO_PROFILE_ID- Идентификатор аккаунта для аргумента `user_id` у инструментов чатов.
Ограничения
Нужны Go 1.27.1 для сборки командой `go build -o avito-mcp ./cmd/avito-mcp`, ключи Avito API из кабинета продавца и, для чатов, подходящая подписка с ключом основного аккаунта. `AVITO_PROFILE_ID` задает идентификатор аккаунта для аргумента `user_id`, сервер сам его не подставляет.
Avito разрешает до 25 вызовов `list_items` в минуту, метод не возвращает объявления сотрудников. Codex, открытый из Dock или Finder, обычно не видит переменные из `~/.zshrc`, поэтому передавайте их через `env_vars` или файл с правами 0600. Файл с ключами не добавляйте в Git.
Как отключить. Удалите запись `avito` из конфигурации MCP-клиента и отзовите приложение в настройках Avito API.
Частые вопросы
Как собрать и подключить avito-mcp?
Выполните `go build -o avito-mcp ./cmd/avito-mcp`, задайте `AVITO_CLIENT_ID` и `AVITO_CLIENT_SECRET` и пропишите путь к бинарнику в конфигурации MCP-клиента.
Где взять ключи Avito API?
В кабинете продавца: «Настройки», затем «Avito API» и «Регистрация нового приложения». Для чатов нужна подходящая подписка.
Что делает сервер без ключей?
Запускается и показывает список инструментов, но каждый запрос к Avito возвращает ошибку, пока авторизация не настроена.
Какие инструменты меняют данные?
`update_item_price` меняет цену объявления, `send_message` отправляет сообщение в чат, `mark_chat_read` помечает чат прочитанным. Остальные только читают.
Можно ли готовый токен вместо ключей?
Да, задайте `AVITO_ACCESS_TOKEN`. Если заданы оба варианта, используется готовый токен.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Авито — все инструментыMCP-сервер для аккаунта продавца на Авито: чаты с покупателями, объявления, статистика, продвижение и заказы с режимом только чтения
Avito MCP Server: поиск, чаты и объявления Авито
avito-mcp-server
MCP-сервер на Python с Playwright для работы агента на Авито от вашего аккаунта: поиск, карточки, переписка с продавцами и публикация объявлений
avito-mcp (oleg909902)
avito-mcp
MCP-сервер для Авито через запущенный Chrome по CDP: поиск, объявления, фото, мессенджер, заказы Доставки и закрытие своих объявлений
MCP для API Авито с поддержкой до девяти кабинетов, честным списком того, что API не умеет менять, и деплоем на Railway
MCP для Авито Мессенджера и объявлений
Avito MCP Server
Компактный MCP для Авито Мессенджера и объявлений с автоопределением user_id, обходом SSL для корпоративных прокси и интерактивным deploy.sh
Однорыночная поставка ядра marketplaces-mcp-ru только под Авито: 64 метода API, каталог методов вместо сотни отдельных инструментов
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| avito-mcp (artemk1337) (эта карточка) | нет | OAuth | 0 | |
| avito-mcp | нет | API-ключ | 26 | другой сервер Авито, этот работает через официальный Business API на Go |
| MCP для личного аккаунта Авито без API-ключей | нет | не нужна | 2 | сервер личного кабинета без смены цены и чатов через API |
Коротко о README
Документация охватывает сборку, получение ключей, пример конфигурации MCP-клиента, настройку Codex Desktop на macOS с переменными окружения и файлом, таблицу инструментов, ограничения по лимитам и запуск тестов командой `go test ./...`.