avito-mcp-ru
API de negocio de Avito en tu asistente de IA: 64 métodos para anuncios, estadísticas, mensajería de compradores, pedidos de Avito Delivery, carga masiva y reseñas, con una clase de seguridad en cada método.
Documentación
avito-mcp-ru
API de Avito para asistentes de IA: anuncios y estadísticas, chats con compradores, pedidos y Avito Delivery, carga automática, promoción, reseñas. El catálogo se ejecuta mediante el servidor.
El paquete levanta un solo servidor, Avito, y nada más. El servidor, el catálogo y el
núcleo vienen como dependencia de marketplaces-mcp-ru:
aquí están el nombre, el punto de entrada y la documentación para un solo marketplace.
Instalación
El primer lanzamiento en PyPI se publica con la etiqueta v0.5.3, hasta entonces el paquete se instala directamente desde el repositorio:
uvx --from git+https://github.com/ilyautov/avito-mcp-ru avito-mcp-ru
Después del lanzamiento, la línea es más corta:
uvx avito-mcp-ru
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"avito": {
"command": "uvx",
"args": ["--from", "git+https://github.com/ilyautov/avito-mcp-ru", "avito-mcp-ru"],
"env": { "AVITO_CLIENT_ID": "...", "AVITO_CLIENT_SECRET": "..." }
}
}
}
La tercera vía, si el agente admite habilidades: él mismo instalará el servidor y configurará el cliente.
npx skills add ilyautov/avito-mcp-ru
Claves
Dónde obtener el par. En avito.ru: Para negocios, sección Integraciones, apartado API. Allí se emiten client_id y client_secret. El host de solicitudes es api.avito.ru.
Cómo se convierte en token. El par se cambia por un access-token mediante OAuth2, con una vida útil limitada. El servidor renueva el token automáticamente; no es necesario reemitir nada manualmente.
Dónde se guarda todo. En ~/.marketplace-mcp/cabinets.json con permisos chmod 600, localmente.
| variable | secreto | qué es |
|---|---|---|
AVITO_CLIENT_ID | sí | client_id de la sección Para negocios → Integraciones → API. |
AVITO_CLIENT_SECRET | sí | client_secret de allí mismo, se cambia por un token mediante OAuth2. |
Las claves no tienen que estar en el entorno: el servidor admite cuentas y las guarda en
~/.marketplace-mcp/cabinets.json con permisos 600, fuera del repositorio. Se pueden conectar tantas
tiendas como sea necesario, y el cambio se hace directamente desde el chat.
Mapa de métodos
El catálogo está en la dependencia como avito_mcp/endpoints.yaml:
64 métodos, de los cuales 40 son de lectura, 22 de escritura y 2 irreversibles.
El servidor ejecuta exactamente ese archivo, por lo que la tabla no puede divergir del código.
| tema | métodos | lectura | escritura | irreversibles |
|---|---|---|---|---|
| Mensajería (chats con compradores) | 13 | 5 | 7 | 1 |
| Carga automática (subida de anuncios por archivo) | 12 | 10 | 2 | 0 |
| Pedidos y Avito Delivery | 12 | 6 | 6 | 0 |
| Anuncios y estadísticas | 11 | 7 | 4 | 0 |
| Promoción de anuncios (publicidad) | 7 | 6 | 1 | 0 |
| Calificación y reseñas | 4 | 2 | 1 | 1 |
| Usuario, saldo y operaciones | 3 | 3 | 0 | 0 |
| Restos en anuncios | 2 | 1 | 1 | 0 |
Análisis detallado con parámetros y límites: https://marketplaces-mcp-ru.aifrontier.tech/avito-api.html
Qué preguntar en el chat
- muéstrame las estadísticas de los anuncios de la semana
- qué pedidos de Avito Delivery están en curso
- recopila los mensajes no leídos del mensajero
- actualiza los restos de los anuncios
Errores frecuentes
401 después de que todo funcionaba. El token de Avito tiene una vida limitada. Si la solicitud va fuera del servidor, con tu propio código, el token debe renovarse; a través del servidor esto ocurre solo.
403 en un método que está en la documentación. En Avito, el acceso a las secciones se otorga mediante solicitud y no es igual para todas las cuentas. La mensajería y Avito Delivery no están disponibles para todos los negocios.
Error en el nombre del campo. El catálogo se compiló a partir de documentos oficiales; aún no se ha hecho una ejecución en vivo en cuentas reales. describe_method mostrará el esquema, call_raw permitirá corregir la solicitud en el momento.
En qué se diferencia de marketplaces-mcp-ru
En nada, salvo en la composición. marketplaces-mcp-ru instala cuatro marketplaces a la vez y los mantiene
bajo un solo servidor; avito-mcp-ru instala uno solo. El código es común: una corrección en el núcleo llega
aquí mediante una actualización de dependencia, no copiando.
| necesidad | paquete |
|---|---|
| solo Avito | avito-mcp-ru |
| los cuatro marketplaces | marketplaces-mcp-ru |
Quién lo hizo
Ilya Utov, laboratorio AI Frontier. Sobre cómo están construidos estos instrumentos por dentro, escribo en Telegram y LinkedIn.
Al lado están business-mcp-ru (hh.ru, VK, Diadoc, SBIS, Chestny Znak), moysklad-mcp-ru y humanizer-ru.
Todos los proyectos en una lista, clasificados por propósito: ilyautov.github.io.
Licencia
MIT, ver LICENSE.