A1 Yandex KIT MCP

Servidor MCP A1 Yandex KIT para la API de comercio electrónico de Yandex KIT: productos, pedidos, descuentos, webhooks.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Asigne tareas de la tienda Yandex KIT al asistente

A1 Yandex KIT Skills β

Compruebe qué requiere atención, ponga el catálogo en orden, procese los pedidos y lance una promoción con una frase común. El asistente lee el estado actual de la tienda, realiza cambios solo bajo una orden precisa y muestra el resultado verificado.

  • Comprueba. Pedidos, catálogo, promociones, webhooks y la preparación de la tienda para abrir.
  • Ejecuta. Actualiza precios y existencias indicados, lanza promociones, trabaja con archivos y documentos.
  • Muestra el resultado. Informa qué cambió, qué se verificó por completo y dónde faltaron datos.

Su primera consulta

¿Qué requiere atención ahora en la tienda? Revisa los pedidos y el catálogo e indica qué datos se pudieron verificar.

Conectar tienda · Ver qué más se puede encargar · Suscribirse al canal de Telegram

Asistente de IA para Yandex KIT

A1 Yandex KIT Skills β permite gestionar la tienda desde una aplicación habitual (Claude, Cursor, Codex y otras). Usted plantea tareas con palabras comunes y el asistente verifica el estado actual de la tienda, encuentra lo que requiere atención y ejecuta comandos.

  • Cuatro escenarios listos. Riesgos operativos y prioridades, errores del catálogo, lanzamiento de promociones y preparación de la tienda para abrir.
  • Por voz o texto. Formule tareas de trabajo en lenguaje natural. Escriba o dicte si la aplicación admite entrada de voz. Si lo desea, puede invocar la habilidad necesaria directamente.
  • Cambios solo bajo orden. Las verificaciones no cambian nada, y el asistente no inventa precios, existencias, plazos ni otros valores comerciales.

Qué sabe hacer el asistente

  1. Operador (a1-yandex-kit-operator) realiza un análisis operativo de la tienda: encuentra todo aquello por lo que se puede perder un pedido, dinero o reputación, clasifica los riesgos por urgencia y forma un plan de acción preciso.
  2. Doctor del catálogo (a1-yandex-kit-catalog-doctor) encuentra errores por los que los productos pierden visibilidad y ventas, y bajo orden del propietario los corrige.
  3. Lanzamiento de promociones (a1-yandex-kit-promo-launcher) convierte las condiciones indicadas en una promoción lista: crea, modifica y lanza descuentos, códigos promocionales y regalos en la tienda.
  4. Verificación de lanzamiento (a1-yandex-kit-launch-check) determina si la tienda está lista para abrir y recibir pedidos: encuentra bloqueadores y enumera todo lo que aún falta confirmar.
  5. Habilidades especializadas. a1-yandex-kit-orders, a1-yandex-kit-catalog, a1-yandex-kit-promotions, a1-yandex-kit-store y a1-yandex-kit-webhooks — para tareas específicas de pedidos, catálogo, promociones, recursos de la tienda y webhooks.
  6. Бинокль ¿No encontró el escenario que necesita? Cuéntenos qué tarea le falta y siga las nuevas funciones.

Ver el funcionamiento en un minuto

Después de la conexión:

Usted: ¿Qué requiere atención ahora en la tienda?

Asistente: Revisé los pedidos disponibles, el catálogo, las promociones y los webhooks. Mostré los riesgos encontrados y marqué por separado las áreas que no se pudieron verificar por completo.

Usted: Exporta los pedidos a CSV con fecha, importe y estado.

Asistente: Preparé la exportación e indiqué su alcance. Si la lista no se obtuvo completa, esto queda marcado en el resultado.

Usted: Sube los precios de todos los productos un 20%.

Asistente: Los precios de los 12 productos se subieron de 999 ₽ a 1 199 ₽. Los precios base y finales se actualizaron y verificaron.

Usted: [adjunta siete archivos PDF]

Aquí hay instrucciones, fichas técnicas y certificados. Los nombres de los archivos no son claros. Analiza a qué productos corresponde cada documento y adjúntalos, por favor.

Asistente: Analicé el contenido de los siete documentos y los relacioné con el catálogo por nombres de modelos y SKU:

  • «Кресло Urban Relax» — instrucciones de montaje y ficha técnica;
  • «Nordic Comfort Lounge Chair» — instrucciones de montaje y especificación de materiales;
  • «Black Force», «Pink Dream» y «Champion Spirit» — declaración de conformidad para cada perfume.

Todas las coincidencias son inequívocas. Adjunté 7 de 7 documentos, les di nombres claros y verifiqué la lista de documentos de cada producto. No hay archivos no reconocidos.

Contenido

Inicio rápido

  1. Abra la terminal e instale el paquete de habilidades:

    npx skills@latest add ztemerbekov/a1-yandex-kit-skills -y

    Para recibir actualizaciones nuevas más adelante, ejecute npx skills update.

  2. Invoque explícitamente el instalador con la habilidad a1-yandex-kit-setup. En Codex la invocación se ve así:

    $a1-yandex-kit-setup

    En otra aplicación, seleccione la habilidad con ese nombre en la lista de comandos.

  3. Siga las preguntas del instalador. Verificará el entorno y el token, conectará la tienda a la aplicación elegida y realizará la primera llamada.

  4. Después del mensaje de conexión exitosa, los escenarios de trabajo se pueden invocar con frases comunes, por voz o texto. Comience con una pregunta simple:

    ¿Cómo está la tienda?

El instalador funciona con Claude Code, Claude Desktop, Cursor, OpenAI Codex y otras aplicaciones. El paquete también se puede instalar a través del marketplace de la aplicación. Si la conexión no se completó, abra la instrucción detallada: allí está la lista completa de plataformas, configuración manual y formas de resolver errores.

Más sobre los escenarios

Elija una tarea conocida y envíe la consulta al asistente. Las formulaciones se pueden cambiar: sustituya sus productos, pedidos, fechas y condiciones. Para una verificación basta con describir qué le interesa; para un cambio, indique el valor necesario o adjunte el archivo del que tomarlo.

Entender qué requiere atención en la tienda

Comienza la jornada laboral, se acumularon pedidos o necesita entender rápidamente el estado de la tienda. Operador (a1-yandex-kit-operator) verificará los datos disponibles y clasificará los riesgos encontrados por urgencia.

Qué puede escribir:

¿Cómo está la tienda? ¿Por dónde empiezo hoy?

No he mirado la tienda en tres días. Revisa los pedidos de este período y muestra qué requiere atención.

Antes del fin de semana revisa pedidos, catálogo y promociones activas. ¿Qué cuestiones hay que resolver primero?

Qué obtendrá: análisis de pedidos, estado del catálogo, promociones y webhooks con datos reales de la tienda. El asistente indicará por separado qué no se pudo verificar.

Poner en orden fichas, precios y existencias

Llegó un suministro, cambió la lista de precios o se acumularon errores en el catálogo. Doctor del catálogo (a1-yandex-kit-catalog-doctor) ayudará a verificar los productos y aplicar los cambios indicados.

Qué puede escribir:

Realiza una auditoría completa del catálogo. Primero muestra los errores que impiden comprar un producto.

Encuentra productos sin fotos y verifica dónde no están completas las características.

Sube los precios de todos los productos un 20%.

Establece el stock del crop-top Summer Breeze en 13 unidades.

Adjunto un archivo con las nuevas existencias. Relaciona los productos por SKU y actualiza las existencias según el archivo. Muestra las filas para las que no hubo coincidencia inequívoca.

Qué obtendrá: lista de errores con indicación de los productos o resultado verificado de los cambios. Para la auditoría, el asistente separará bloqueadores, riesgos y recomendaciones, indicará el alcance y las áreas no verificadas. Los precios y existencias los tomará de su comando o archivo.

Procesar pedidos, obtener enlace de pago y documentos para el envío

Necesita verificar el pago, preparar un informe o entregar los envíos al servicio de mensajería. Estas tareas están disponibles a través de a1-yandex-kit-orders.

Qué puede escribir:

Muestra los pedidos de hoy y sus estados de pago. Oculta nombres, teléfonos y direcciones.

Exporta los pedidos de la semana pasada a CSV: fecha, importe y estado.

Dame el enlace de pago para el pedido 123.

Genera los actos de recepción-transferencia para todas las partes del pedido 123. Si para alguna parte el acto no está disponible, explica por qué.

Qué obtendrá: lista de pedidos, CSV, enlace de pago o enlaces a PDF con actos, según la consulta. Si la exportación está incompleta, el asistente indicará su alcance; si el acto no está disponible, enumerará las partes omitidas del pedido con los motivos.

El enlace de pago el asistente se lo entrega a usted; al comprador lo envía usted. Es permanente e irrevocable, por lo que no lo publique en acceso abierto. Los enlaces a PDF con actos, en cambio, caducan: si el enlace dejó de funcionar, solicite el acto nuevamente.

Agregar fotos, videos y documentos a los productos

El proveedor envió materiales y hay que distribuirlos en las fichas. Las habilidades a1-yandex-kit-catalog y a1-yandex-kit-store ayudan a trabajar con medios y archivos de la tienda.

Qué puede escribir:

Adjunto siete archivos PDF: instrucciones, fichas técnicas y certificados. Analiza a qué productos corresponden y adjunta los documentos a las fichas.

Muestra los archivos cargados, incluidos los documentos, con sus enlaces.

Muestra la lista de videos cargados y sus estados de procesamiento.

Agrega esta foto al producto SKU-42. Conserva las demás fotografías en la ficha.

Qué obtendrá: lista de archivos o resultado de adjuntar materiales con verificación de las fichas. Si con el documento no se puede determinar inequívocamente el producto, el asistente aclarará la correspondencia. Los videos se almacenan por separado y no forman parte de la lista general de archivos; puede solicitarlos con una frase aparte.

Lanzar una promoción o modificar un código promocional activo

Las condiciones de la promoción ya están definidas, solo falta trasladarlas a la tienda. Lanzamiento de promociones (a1-yandex-kit-promo-launcher) crea y modifica descuentos, códigos promocionales y regalos bajo su orden.

Qué puede escribir:

¿Qué promociones están activas ahora? Muestra plazos, productos y condiciones de cada una.

Crea el código promocional SMPT10 «Septiembre 10»: 10% de descuento en todos los productos del 1 al 30 de septiembre de 2026 (hora de Moscú), sin límite de usos. Actívalo de inmediato.

Extiende el código promocional SMPT10 hasta el 7 de octubre de 2026, 23:59 (hora de Moscú). Las demás condiciones consérvalas.

Desactiva el código promocional SMPT10 y verifica que ya no esté activo.

Qué obtendrá: resumen de las promociones activas o una promoción configurada con verificación de las condiciones finales y el estado. Si para el lanzamiento faltan el tamaño del descuento, los productos, el plazo u otra condición obligatoria, el asistente lo aclarará.

Obtener el catálogo para publicidad y CRM

Un especialista en publicidad o un integrador solicita el enlace al feed de productos, el archivo del que el servicio obtiene el catálogo. La habilidad a1-yandex-kit-store encontrará el enlace para la plataforma necesaria.

Qué puede escribir:

Necesito el enlace al catálogo para Yandex Direct. Dame el feed YML de la tienda.

Estoy conectando RetailCRM. Muestra el enlace al feed ICML.

Dame el feed para Yandex Tovar y especifica qué formato es.

Qué obtendrá: enlace permanente al feed necesario: YML para Yandex Direct, ICML para RetailCRM o YML_GOODS para Yandex Tovar. La dirección se conserva al actualizar el contenido. El enlace debe agregarse al servicio correspondiente; obtener el feed por sí solo no lanza publicidad ni configura el CRM.

Encontrar datos de un cliente o preparar una exportación

Se necesita el historial de pedidos de un cliente concreto, una lista para un informe o una corrección en la ficha. Estas tareas están disponibles a través de a1-yandex-kit-orders.

Qué puede escribir:

Muestra los pedidos del cliente con este ID, ocultando sus datos personales.

Exporta los clientes a CSV: ID, nombre y email.

En la ficha del cliente con este ID, reemplaza la nota por «Prefiere recogida en tienda». Conserva los demás campos. Qué obtendrás: los datos solicitados, una exportación con indicación de cobertura o el cambio verificado de la tarjeta. La ocultación de datos personales solo afecta a la respuesta del asistente: la información en la tienda se conserva.

Consultar notificaciones para integraciones

El sistema externo recibe los eventos de la tienda a través de webhooks. La habilidad a1-yandex-kit-webhooks te ayudará a ver las suscripciones, comprobar la dirección receptora o desactivar un webhook concreto.

Qué puedes escribir:

Muestra los webhooks de la tienda: a dónde envían notificaciones, a qué eventos están suscritos y cuál es su estado.

Ejecuta una verificación del webhook con este ID y muestra el resultado. No lo actives.

Desactiva el webhook con este ID. El propio webhook se conserva.

Qué obtendrás: la lista de configuraciones, el resultado de la verificación o la desactivación confirmada. La verificación envía una solicitud de prueba a la dirección del webhook; el asistente la ejecuta bajo tu comando.

Comprobar la tienda antes de abrir

El catálogo está completo y te dispones a recibir los primeros pedidos. La verificación de lanzamiento (a1-yandex-kit-launch-check) te ayudará a encontrar lo que aún impide la apertura.

Qué puedes escribir:

Comprueba si la tienda está lista para abrir. ¿Qué impide empezar a recibir pedidos?

Mañana lanzamos la tienda. Revisa el catálogo y las promociones, y saca las etapas de compra no verificadas a una lista aparte.

¿Qué debo revisar manualmente en pago y entrega antes de abrir?

Qué obtendrás: el estado «no lista», «condicionalmente lista» o «lista» con bloqueadores, riesgos y secciones no verificadas. El asistente revisará el catálogo y las promociones, tendrá en cuenta las confirmaciones de verificación del proceso de pedido y, si la aplicación tiene acceso web, consultará el escaparate público. El proceso de pedido y el pago de un pedido de prueba los verifica el propietario; solo los datos de la API no son suficientes para el estado «lista».

Cómo interactúa el asistente con la tienda

La verificación no cambia nada. Si pides «muestra», «comprueba», «analiza» o «busca», el asistente solo revisará la tienda y mostrará el resultado.

Para un cambio se necesita una orden precisa. Indica qué hay que cambiar y qué valor establecer. Por ejemplo: «Sube los precios de todos los productos un 20%». El asistente no inventará por su cuenta un precio, stock, plazo u otra decisión.

No se requiere confirmación repetida. Una orden precisa ya se considera permiso para actuar.

Esta regla se refiere al asistente. La propia aplicación de IA puede mostrar por separado el botón Allow antes de llamar a una herramienta. Al conectar, puedes activar una vez el «Trabajo sin pausas»: la aplicación de IA permitirá todas las herramientas actuales y futuras de Yandex KIT, incluidas eliminaciones, pedidos, promociones y ajustes de la tienda. Las propias habilidades siguen modificando la tienda solo bajo tu orden precisa.

El resultado se verifica. Antes de un cambio, el asistente consultará el estado actual del objeto, ejecutará la orden y luego comprobará qué ha ocurrido.

Una operación poco clara no se repite. Si durante un cambio se pierde la conexión y no se puede confirmar el resultado, el asistente lo comunicará, pero no repetirá la orden a ciegas.

No hay deshacer automático. El asistente no guarda una copia del estado de la tienda antes de cada cambio, por lo que no se puede revertir todo con una sola orden de «como estaba».

Ten en cuenta

Todos los cambios ocurren en la tienda real. No existe una tienda de prueba separada ni un modo de prueba.

El asistente no supervisa la tienda constantemente. Comprueba el estado de la tienda y realiza acciones solo cuando le asignas una tarea.

Con los pedidos no están disponibles todas las acciones. El asistente puede ver, confirmar y cancelar pedidos. Para recogida y entrega propia con la automatización desactivada, puede finalizar la entrega; los estados de entrega arbitrarios y los estados de pago no están disponibles. No puede crear pedidos, cambiar libremente el contenido de un pedido, gestionar devoluciones ni escribir a los compradores.

La preparación para la apertura no se verifica de forma totalmente automática. El asistente no ve los ajustes de pago y entrega y no puede realizar ni pagar un pedido de prueba por sí mismo. Esa parte de la verificación la realiza el propietario de la tienda.

Tras un error de conexión, la orden no se repite automáticamente. Primero, el asistente intentará comprobar si el cambio se ha realizado. Si no se puede confirmar el resultado, lo comunicará y se detendrá para no ejecutar la acción dos veces por accidente.

La cobertura de la lista se ve en la respuesta. El asistente indicará cuántos objetos se han verificado y marcará por separado los objetos o secciones no verificados. Si faltan datos, no llamará al resultado completo. Para una lista grande, pueden ser necesarias varias consultas a la tienda.

Las listas de pedidos y clientes se pueden exportar a CSV. Pide exportar la lista con los campos seleccionados, por ejemplo: «Exporta los pedidos a CSV con fecha, importe y estado». Si la lista no se ha obtenido por completo, el asistente lo dirá.

Los datos personales se pueden ocultar en la respuesta. Pide mostrar pedidos, clientes o tarjetas regalo sin nombres, teléfonos, emails, direcciones ni notas. Esto solo cambia la respuesta mostrada: los datos de la tienda se conservan tal cual.

Servidor MCP (Model Context Protocol)

Este repositorio contiene un servidor MCP funcional para la API de Yandex KIT, no solo habilidades y plugins para clientes de IA.

  • Implementación. El servidor está escrito en TypeScript con el paquete oficial @modelcontextprotocol/sdk, se crea mediante McpServer y se conecta al cliente de IA a través de StdioServerTransport.
  • Capacidades de MCP. El servidor ofrece 92 herramientas (tools) para trabajar con productos, variantes (incluida la actualización masiva de precios), categorías, características, vídeos, noticias, pedidos, clientes y sus carritos, almacenes, colecciones, archivos, descuentos, códigos promocionales, tarjetas regalo, alertas y webhooks. Los recursos (resources) y los prompts (prompts) no se declaran: las operaciones de la API se ofrecen como herramientas MCP.
  • Cobertura completa de la API. Las herramientas especializadas complementan a search_operations, get_operation_schema y kit_request, a través de las cuales están disponibles las 169 operaciones de la API de Yandex KIT.
  • Transporte. El servidor MCP local funciona a través de stdio.
  • Publicación. El servidor está disponible como paquete npm mcp-yandex-kit y se ejecuta mediante npx en Node.js 20.11 y versiones posteriores.
  • Habilidades. Las habilidades de este repositorio añaden escenarios de trabajo listos para usar y reglas de ejecución segura de operaciones sobre las herramientas MCP, pero no sustituyen al propio servidor MCP.

Código fuente: packages/mcp/src/index.ts · packages/mcp/src/tools · lista de herramientas · README del paquete MCP.

A continuación se muestra la conexión directa del propio servidor MCP. Añade herramientas MCP para trabajar con la API de Yandex KIT, pero no instala las habilidades listas para usar de este repositorio.

Codex — conectar el servidor MCP

  1. Añade el servidor con el comando:

    codex mcp add yandex-kit \
  --env YANDEX_KIT_TOKEN=ваш_токен \
  -- npx -y mcp-yandex-kit@latest

  2. Inicia una nueva tarea de Codex.

  3. Comprueba la conexión con una solicitud sencilla:

    Comprueba si la tienda se ha conectado. Muestra cuántos productos hay en el catálogo y di en qué deberías fijarte primero.

Cursor — conectar el servidor MCP

  1. Abre ~/.cursor/mcp.json y añade el servidor:

    {
  "mcpServers": {
    "yandex-kit": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-kit"],
      "env": {
        "YANDEX_KIT_TOKEN": "ваш_токен"
      }
    }
  }
}

  2. Recarga la ventana de Cursor.

  3. Comprueba la conexión con una solicitud sencilla:

    Comprueba si la tienda se ha conectado. Muestra cuántos productos hay en el catálogo y di en qué deberías fijarte primero.

Claude Code — conectar el servidor MCP

  1. Añade el servidor con el comando:

    claude mcp add yandex-kit \
  -e YANDEX_KIT_TOKEN=ваш_токен \
  -- npx -y mcp-yandex-kit@latest

  2. Inicia una nueva sesión de Claude Code.

  3. Comprueba la conexión con una solicitud sencilla:

    Comprueba si la tienda se ha conectado. Muestra cuántos productos hay en el catálogo y di en qué deberías fijarte primero.

Instalación a través de marketplaces

Elige la aplicación de IA en la que quieras gestionar la tienda. Cada opción instala el conjunto completo: conexión de Yandex KIT, habilidades de API y cuatro escenarios listos para usar.

Si el método de instalación no es importante, usa el inicio rápido: allí basta con un solo comando.

Codex — instalar a través de Marketplace

  1. Añade el marketplace e instala el conjunto completo:

    codex plugin marketplace add ztemerbekov/a1-yandex-kit-skills
codex plugin add a1-yandex-kit-skills@a1-yandex-kit-skills

  2. Inicia una nueva tarea de Codex para que se carguen las habilidades instaladas.

  3. Conecta la tienda:

    $a1-yandex-kit-skills:a1-yandex-kit-setup

Sigue las preguntas del instalador: comprobará el entorno, conectará la tienda y realizará la primera llamada.

Cursor — instalar a través de Marketplace

  1. Añade el marketplace:

    cursor-agent plugin marketplace add https://github.com/ztemerbekov/a1-yandex-kit-skills

  2. Ejecuta Cursor Agent, abre /plugin y selecciona el marketplace A1 Yandex KIT.

  3. Instala el plugin A1 Yandex KIT, luego selecciona la habilidad a1-yandex-kit-setup y sigue las preguntas de conexión.

Claude Code — instalar a través de Marketplace

  1. Añade el marketplace e instala el conjunto completo:

    /plugin marketplace add ztemerbekov/a1-yandex-kit-skills
/plugin install a1-yandex-kit-skills@a1-yandex-kit-skills

  2. Carga las habilidades instaladas:

    /reload-plugins

  3. Conecta la tienda:

    /a1-yandex-kit-skills:a1-yandex-kit-setup

Sigue las preguntas del instalador: comprobará el entorno, conectará la tienda y realizará la primera llamada.

Actualización

Actualiza el paquete de la misma forma en que lo instalaste.

Si usaste el inicio rápido, obtén la versión más reciente de las habilidades con un solo comando:

npx skills update

Si instalaste el paquete a través de un marketplace, actualiza el plugin A1 Yandex KIT en la misma aplicación de IA. Después de la actualización, inicia una nueva tarea para que la aplicación cargue la versión más reciente de las habilidades.

Documentación

Ayuda y comentarios

¿Necesitas ayuda, algo no funciona o tienes una idea? Escríbenos en Telegram — A1 Yandex KIT Skills β.


Две Моны дают пять

¡Has llegado al final!