Yandex Direct Manager

Conector de IA para Yandex Direct: conecte Claude o ChatGPT a su cuenta publicitaria y gestione campañas directamente en el diálogo — estadísticas, búsqueda de gastos ineficientes, pujas, presupuestos, palabras clave negativas, auditoría.

GitHub

Prueba este MCPPatrocinado

Documentación

Direct Manager — MCP para Yandex Direct

Conecta Claude o ChatGPT a Yandex Direct y gestiona la publicidad en el chat: «¿Dónde se va el dinero?» → el asistente encontrará campañas con ROAS < 1 y sugerirá qué desactivar.

Connect Claude or ChatGPT to Yandex Direct and manage ad campaigns in chat — analytics, wasted-spend detection, bids, budgets, negative keywords.

Pruébalo gratis — 7 días del plan «Pro» →

Sitio web / Website: https://app.marketscore.ru

Qué es

marketscore-direct-mcp — un conector ligero al servidor MCP alojado Direct Manager. El propio servidor, el acceso a Direct API y toda la lógica funcionan en el lado del servicio — este paquete solo conecta a tu asistente de IA con él.

El servicio tiene dos servidores MCP independientes: uno publicitario (Direct, VK, Avito, Wordstat) y otro SEO (Webmaster, Search Console, Metrika, Topvisor) — sección sobre SEO más abajo.

Así se ve el trabajo:

Tú: ¿Dónde se está yendo mi dinero en los últimos 14 días?

Claude: Encontré 3 problemas por 12 400 ₽: la campaña «Ремонт квартир — РСЯ» gastó 4 210 ₽ sin una sola conversión; la plataforma dsp.example da un ROAS de 0.2; 6 palabras clave con gasto y cero solicitudes. ¿Desactivo la plataforma y añado las palabras clave como negativas?

Qué puede hacer

Hasta 116 herramientas sobre Direct API v5 y Reports API (en los planes «Asistente» y «Pro» — 111, en «Agencia» — 116, incluido el accounts_overview de cartera):

Analítica y estadísticas — métricas de campañas por periodos y segmentos: dispositivos, género, edad, plataformas RSN, geo; consultas de búsqueda; cuota de impresiones.
Detección de gastos ineficientes — campañas con ROAS < 1, gasto sin conversiones, plataformas y palabras clave sobrantes.
Gestión — pausa/reanudación, presupuesto diario y semanal, estrategias (incluidas las de conversión con objetivo y CPA/ROAS), palabras clave negativas, palabras clave, pujas y ajustes.
Creación de campañas desde cero — campaña → grupo → anuncio con enlaces rápidos y UTM.
Conclusiones de IA — previsión de gasto y conversiones a 30 días, diagnóstico de caídas (tráfico/CR/CPC), explicación de cambios periodo a periodo con factores impulsores, ranking de hallazgos en rublos, informe semanal listo con una sola llamada.
Wordstat — selección de palabras con frecuencias.
Para agencias — visión general de cartera en todas las cuentas: gasto, beneficio, gastos superfluos y saldo de presupuesto de cada cliente en una sola respuesta.

Las acciones de escritura están marcadas con anotaciones separadas — el asistente y el cliente ven exactamente qué cambia antes de aplicar la modificación. Los errores de Direct API se manejan correctamente, incluidos los «silenciosos» (cuando la API responde 200 pero el cambio no se aplicó).

MarketScore SEO — segundo MCP, para optimización en buscadores

La misma cuenta tiene un servidor MCP separado para SEO: no trata sobre publicidad, sino sobre búsqueda orgánica — Yandex Webmaster, Google Search Console, Yandex Metrika, Topvisor y Wordstat en un solo asistente.

https://app.marketscore.ru/api/mcp/seo

Es una dirección diferente y una suscripción diferente: el plan SEO no está incluido en los planes de Direct y viceversa. Las herramientas de Direct no aparecen en la dirección SEO, y viceversa.

Tú: ¿Por qué ha caído el tráfico de búsqueda en los últimos 28 días?

Claude: Los clics bajaron de 940 a 610. La comparación la hago solo con las fuentes que midieron ambos periodos: Search Console — sí, Webmaster — sí, Topvisor no está conectado, las posiciones no se verificaron de forma independiente. La caída principal está en la sección /catalog: 18 páginas salieron de la búsqueda de Yandex con el motivo «duplicado», Webmaster lo ve desde el 3 de agosto. ¿Muestro la lista de direcciones?

21 herramientas, de las cuales solo tres modifican algo (seo_add_keywords, seo_add_competitors, seo_request_recrawl) — el resto son de lectura:

Datos de búsqueda — seo_overview (clics, impresiones, CTR, posición media, top-3/top-10 y comparación de periodos), seo_search_queries (consultas y páginas de Webmaster y Search Console por dispositivos y regiones), seo_positions (última comprobación de Topvisor), seo_indexation (cuántas páginas hay en la búsqueda de Yandex, qué está excluido y por qué motivo), seo_metrika (comportamiento de los visitantes desde la búsqueda y logro de objetivos), seo_landing_pages (visitas y solicitudes por página de entrada).
Trabajo con el sitio — seo_audit (análisis de indexación, técnica, on-page y competencia de páginas con la fuente de cada conclusión), seo_page_analysis (velocidad, Core Web Vitals y señales on-page de la página), seo_opportunities (consultas cerca del top, páginas con CTR bajo, impresiones sin clics, canibalización), seo_sitemaps (si Yandex y Google ven el mapa del sitio), seo_url_inspection (veredicto de Google sobre una dirección concreta), seo_request_recrawl (enviar una dirección para re-rastreo en Yandex), seo_text_check (sellos de IA, lenguaje burocrático y sobreoptimización en texto ruso listo).
Demanda — seo_keyword_demand: frecuencia, frases similares, marcado de ruido y estacionalidad de Wordstat.
Palabras clave y comprobaciones — seo_keywords (qué está en revisión de posiciones), seo_add_keywords (poner frases en revisión), seo_positions_plan (programación de comprobaciones, precio de lanzamiento y saldo de Topvisor).
Competidores — seo_competitors (nuestras posiciones junto a las suyas), seo_add_competitors (añadir sitios de competidores al proyecto).
Proyecto — seo_projects (sitios del panel) y seo_sources (qué está conectado, qué ha caducado y qué deja de saberse mientras la fuente no funciona).

Qué se ha hecho aquí de forma diferente a los wrappers sobre las mismas API:

La respuesta lleva procedencia. Cada cifra tiene fuente y fecha de captura. Un acceso revocado a Webmaster se ve como una denegación de la fuente, no como tráfico cero: «no hay datos» y «no hay problemas» son respuestas distintas, y el modelo no debe confundirlas.
Las comprobaciones no realizadas se enumeran. Una auditoría con una fuente silenciosa o sin derechos confirmados sobre el sitio devuelve una lista de «qué exactamente no se comprobó y por qué» y limita la evaluación por arriba, en lugar de rebajarla a «todo está bien».
La frontera de escritura está marcada por el dinero. El lanzamiento de pago de una comprobación de posiciones, el cambio de programación, la eliminación de palabras clave y competidores en el chat están deliberadamente no expuestos — descuentan dinero del saldo de Topvisor, y el precio debe verse en pantalla antes del cargo. Dos herramientas de escritura encarecen la siguiente comprobación de posiciones, y el asistente debe mencionar esa consecuencia antes de la llamada.
Lo que no prometemos: no hay rastreo de todo el sitio — se comprueba una página por llamada; la unicidad del texto no se verifica (no tenemos fuente); las posiciones sin Topvisor conectado no se inventan.

Planes SEO (suscripción separada, 7 días gratis): «Start» — 590 ₽/mes (1 sitio, 2 auditorías, 20 consultas de Wordstat), «Pro» — 1 490 ₽/mes (5 sitios, 10 auditorías, 200 de Wordstat), «Agencia» — 9 900 ₽/mes (20 sitios, 60 auditorías, 2 000 de Wordstat). Las 21 herramientas están disponibles en cualquier plan SEO activo. Las comprobaciones de posiciones funcionan con el saldo de tu cuenta de Topvisor — sin recargo propio.

Más información: https://app.marketscore.ru/seo

Instalación

Claude (Desktop, web, Code) y ChatGPT — mediante enlace

Añade el conector MCP remoto:

https://app.marketscore.ru/api/mcp        реклама: Яндекс Директ, VK, Авито, Wordstat
https://app.marketscore.ru/api/mcp/seo    органика: Вебмастер, Search Console, Метрика, Topvisor

El asistente abrirá el inicio de sesión — autoriza con OAuth. El token de Yandex no se transmite al asistente. Se pueden añadir dos direcciones a la vez: son conectores independientes con suscripciones independientes.

Clientes MCP locales (Cursor, VS Code, Cline, Zed) — mediante puente

npx -y marketscore-direct-mcp

Ejemplo de configuración del cliente MCP:

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

Planes y acceso

El conector necesita una cuenta de Direct Manager. Al registrarte — 7 días del plan «Pro» gratis (incluido el asistente de IA en Claude/ChatGPT). Después:

«Asistente» — 990 ₽/mes: conjunto MCP completo (111 herramientas) para trabajar desde el chat de IA, hasta 3 cuentas de Direct. Sin panel web — solo asistente.
«Pro» — 1 990 ₽/mes: las mismas 111 herramientas más panel web con analítica y autopiloto, hasta 5 cuentas de Direct.
«Agencia» — 9 900 ₽/mes: 116 herramientas (más la visión de cartera accounts_overview), hasta 20 cuentas.
SEO — eje de planes separado (590 / 1 490 / 9 900 ₽/mes) y dirección de conector separada. El plan de Direct no da acceso a las herramientas SEO, y viceversa.

Sin un plan activo, el servidor devuelve 0 herramientas. Registro: https://app.marketscore.ru/register · Planes: https://app.marketscore.ru/pricing · SEO: https://app.marketscore.ru/seo

En qué se diferencia de los wrappers open-source sobre Direct API

Existen wrappers MCP self-host sobre Direct API (por ejemplo, mcp-yandex-direct). Comparación honesta:

	Direct Manager (este conector)	Wrapper self-host
Instalación	Entrada OAuth mediante enlace	obtener token de Direct e introducirlo en la configuración
Conclusiones de IA, auditoría, autopiloto	sí (previsión, diagnóstico, informe, top de hallazgos)	no — solo llamadas API crudas
Panel web y bot de Telegram	sí	no
Cartera de cuentas	sí (visión general de todos los clientes)	no
Precio	suscripción (7 días gratis)	gratis, pero hay que configurarlo y alojarlo uno mismo
Dónde vive el token de Yandex	en el servicio, no está en la configuración del cliente	localmente en la configuración del cliente

Seguridad

Autorización — OAuth 2.1: el token de Yandex no se transmite al asistente ni está en la configuración del cliente; se almacena en el lado del servicio.
Cambiar la contraseña de la cuenta de Direct Manager revoca todos los accesos MCP emitidos.
Las acciones de escritura están marcadas con anotaciones y se confirman en el lado del cliente MCP.
Los datos personales se almacenan en servidores en la Federación Rusa (Ley Federal 152).

FAQ

¿Es gratis? Los primeros 7 días — sí (prueba del plan «Pro» al registrarte). Después — plan desde «Asistente» (990 ₽/mes, solo MCP) y superiores.

¿Dónde va a parar el token de Direct? Se entrega al servicio Direct Manager durante la conexión OAuth y se almacena en sus servidores. El asistente y el cliente MCP no ven el token.

¿Puede el asistente romper algo en el panel? Las herramientas de escritura están marcadas por separado, y el cliente MCP solicita confirmación antes de llamarlas. El autopiloto no toca pausas de campañas ni presupuestos por sí solo — solo bajo tu orden.

¿Funciona con ChatGPT, Cursor, VS Code? Sí: Claude y ChatGPT se conectan por URL directamente; Cursor/VS Code/Cline/Zed — mediante este paquete (npx -y marketscore-direct-mcp).

¿En qué se diferencia de los wrappers MCP gratuitos? Además del acceso a la API — capa de conclusiones de IA, auditoría, panel, bot de Telegram y visión de cartera; el token de Yandex no se almacena en la configuración. Más detalles en la tabla anterior.

¿Funciona sin suscripción? No — sin un plan activo, el servidor devuelve 0 herramientas.

¿Y SEO, lo sabéis hacer? Sí, con un servidor MCP separado: https://app.marketscore.ru/api/mcp/seo — 21 herramientas sobre Yandex Webmaster, Google Search Console, Metrika, Topvisor y Wordstat. La suscripción es independiente de los planes de Direct, con prueba de 7 días.

Docker

docker build -t marketscore-direct-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-direct-mcp

La URL de OAuth se imprime en stdout — el navegador no se abrirá desde el contenedor; ve a la URL manualmente. Los tokens mcp-remote viven en ~/.mcp-auth — monta un volume para no volver a autorizarte en cada ejecución.

Enlaces útiles

Qué es un servidor MCP para Yandex Direct: https://app.marketscore.ru/blog/mcp-server-yandex-direct
IA para Yandex Direct — herramientas 2026: https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026
Gestión de Direct mediante Claude y ChatGPT: https://app.marketscore.ru/blog/upravlenie-yandex-direct-cherez-claude-chatgpt
Servidor MCP para Yandex Webmaster: https://app.marketscore.ru/blog/mcp-server-yandex-webmaster
Red neuronal para SEO — qué se automatiza de verdad: https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya
Por qué los clics en Search Console no coinciden: https://app.marketscore.ru/blog/search-console-kliki-ne-shodyatsya

English

Direct Manager is an AI/MCP service for Yandex Direct (Russian search advertising). This package is a thin connector to the hosted Direct Manager MCP server: it lets Claude, ChatGPT, or any MCP client read campaign analytics and run actions (pause, bids, budgets, negative keywords) on a Yandex Direct account from chat.

Install (remote, Claude/ChatGPT): add connector URL https://app.marketscore.ru/api/mcp and sign in via OAuth.

Install (local MCP clients — Cursor, VS Code, Cline, Zed):

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

Tools: hasta 116 herramientas sobre Direct API v5 y Reports API — análisis de campañas por dispositivo/género/edad/ubicaciones/geo, consultas de búsqueda, cuota de impresiones, detección de gasto desperdiciado (ROAS < 1), gestión de campañas (pausa, presupuestos, estrategias, palabras clave negativas, pujas), creación de campañas desde cero, información de IA (previsión de gasto, diagnóstico de caídas, explicación de cambios, informe semanal), investigación de palabras clave de Wordstat y una vista general de cartera multicuenta para agencias.

SEO MCP (servidor separado): https://app.marketscore.ru/api/mcp/seo — 21 herramientas para búsqueda orgánica sobre Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor y Wordstat: rendimiento de búsqueda y comparación de períodos, consultas y páginas, estado de indexación de Yandex con motivos de exclusión, oportunidades de crecimiento (consultas cerca del top, páginas con bajo CTR, impresiones sin clics, canibalización), una auditoría SEO completa con fuente y fecha detrás de cada hallazgo, análisis técnico de una sola página (PageSpeed, Core Web Vitals, señales on-page), estado del sitemap en ambos motores, inspección de URL de Google, solicitudes de recrawling de Yandex, posiciones de competidores, gestión de palabras clave en Topvisor, conversiones de landing pages desde Metrica y una verificación determinista de texto en ruso. Solo tres herramientas escriben algo; las comprobaciones de posiciones de pago se mantienen deliberadamente fuera del chat. Cada respuesta lleva su procedencia: una fuente revocada aparece como fallo de fuente, nunca como tráfico cero. Suscripción separada (590 / 1 490 / 9 900 ₽/mes, prueba de 7 días): https://app.marketscore.ru/seo

Precios: se requiere una cuenta de Direct Manager; el registro incluye una prueba gratuita de Pro de 7 días. Assistant — 990 ₽/mes (111 herramientas, solo chat, 3 cuentas de Direct); Pro — 1 990 ₽/mes (111 herramientas + panel web, 5 cuentas); Agency — 9 900 ₽/mes (116 herramientas incl. vista de cartera, 20 cuentas). SEO es un eje de plan separado en una URL de conector separada. Sin un plan activo, el servidor expone cero herramientas.

Preguntas frecuentes:

¿Es gratuito? Los primeros 7 días lo son (prueba de Pro al registrarse); después se requiere una suscripción.

¿A dónde va mi token de Yandex? Permanece en el servicio Direct Manager: el asistente y el cliente MCP nunca lo ven, y no se almacena en ninguna configuración local.

¿Puede el asistente romper mi cuenta publicitaria? Las herramientas de escritura están anotadas por separado y el cliente MCP pide confirmación antes de ejecutarlas.

Keywords: Yandex Direct, Яндекс Директ, MCP, Model Context Protocol, MCP server, PPC, ads management, campaign analytics, ROAS, negative keywords, Wordstat, Claude, ChatGPT, Cursor, AI marketing, SEO MCP, Yandex Webmaster, Яндекс Вебмастер, Google Search Console, Yandex Metrica, Topvisor, SEO audit, ИИ-менеджер для Яндекс Директа, ИИ для рекламы.

Licencia

MIT — ver LICENSE. El conector es abierto; el servicio Direct Manager es un SaaS de pago.