yandex-market-mcp-ru
API de Yandex Market Partner en tu asistente de IA: 165 métodos para pedidos, devoluciones, productos, precios, tarifas, informes y reseñas, con una clase de seguridad en cada método.
Documentación
yandex-market-mcp-ru
API de Yandex Market (Partner API) para asistentes de IA: pedidos y devoluciones, productos y tarjetas, precios y tarifas, informes, reseñas y chats. El catálogo se ejecuta mediante el servidor.
El paquete levanta un solo servidor, Yandex Market, 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 paquete está en PyPI, por lo que la línea es una sola:
uvx yandex-market-mcp-ru
Si necesitas la rama main en lugar de la versión estable:
uvx --from git+https://github.com/ilyautov/yandex-market-mcp-ru yandex-market-mcp-ru
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"ym": {
"command": "uvx",
"args": ["yandex-market-mcp-ru"],
"env": { "YANDEX_MARKET_API_KEY": "..." }
}
}
}
La tercera vía, si el agente admite habilidades: él mismo instalará el servidor y configurará el cliente.
npx skills add ilyautov/yandex-market-mcp-ru
Claves
Dónde obtener la Api-Key. Panel del socio partner.market.yandex.ru, sección Configuración, apartado Acceso a la API. La clave se envía en el encabezado Api-Key, el host es api.partner.market.yandex.ru.
El negocio y la campaña son identificadores distintos. Parte de los métodos se dirige mediante el identificador del negocio, parte mediante el número de campaña (tienda). Sustituir uno por otro no produce un error de acceso, sino una respuesta vacía, lo que confunde aún más.
Dónde se guarda. En ~/.marketplace-mcp/cabinets.json con permisos chmod 600, localmente.
| variable | secreto | qué es |
|---|---|---|
YANDEX_MARKET_API_KEY | sí | Clave API del panel del socio, sección Configuración → API. |
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 se necesite, y el cambio se hace directamente desde el chat.
Mapa de métodos
El catálogo está en la dependencia como yandex_mcp/endpoints.yaml:
165 métodos, de los cuales 109 son de lectura, 49 de escritura y 7 irreversibles.
El servidor ejecuta exactamente ese archivo, por lo que la tabla no puede diferir del código.
| tema | métodos | lectura | escritura | irreversibles |
|---|---|---|---|---|
| Pedidos, devoluciones y no entregados | 38 | 19 | 19 | 0 |
| Informes | 27 | 27 | 0 | 0 |
| Productos y tarjetas | 22 | 11 | 8 | 3 |
| Envíos, suministros y almacenes | 21 | 15 | 6 | 0 |
| Reseñas, preguntas y chats | 18 | 11 | 6 | 1 |
| Recogida en tienda y regiones de entrega | 15 | 10 | 3 | 2 |
| Precios, tarifas y cuarentena | 10 | 6 | 4 | 0 |
| Promoción y publicidad | 8 | 4 | 3 | 1 |
| Panel y funciones auxiliares | 6 | 6 | 0 | 0 |
Análisis detallado con parámetros y límites: https://marketplaces-mcp-ru.aifrontier.tech/yandex-market-api.html
Qué preguntar en el chat
- muéstrame los pedidos de Yandex Market de la semana
- cuál es mi índice de calidad y qué lo está bajando
- genera un informe de ventas del mes
- muéstrame los productos en cuarentena de precios
Errores frecuentes
Respuesta vacía en lugar de datos. Lo más común es confundir el identificador del negocio con el número de campaña. No habrá error de acceso; la respuesta llegará correcta pero vacía.
Error en el nombre del campo. El catálogo de métodos se generó a partir del documento OpenAPI oficial, pero aún no se ha probado en vivo con cuentas reales. Es posible que haya imprecisiones en los nombres de los campos. describe_method mostrará el esquema, call_raw permitirá corregir la solicitud en el momento.
El método no se encuentra por su nombre. Busca por tema, no por nombre: pregúntale al agente «qué sabes hacer con Yandex Market», te mostrará las secciones y elegirá el método él mismo.
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; yandex-market-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 código.
| necesidad | paquete |
|---|---|
| solo Yandex Market | yandex-market-mcp-ru |
| los cuatro marketplaces | marketplaces-mcp-ru |
Quién lo hizo
Ilya Utov, laboratorio AI Frontier. Sobre cómo funcionan estas herramientas por dentro, escribo en Telegram y LinkedIn.
También están disponibles business-mcp-ru (hh.ru, VK, Diadoc, SBIS, Chestny Znak), moysklad-mcp-ru y humanizer-ru.
Todos los proyectos en una sola lista, organizados por propósito: ilyautov.github.io.
Licencia
MIT, ver LICENSE.