Direct Manager — MCP para Yandex Direct

Conecte Claude o ChatGPT a Yandex Direct y gestione la publicidad en un diálogo: «¿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ébelo gratis — 7 días del plan «Profi» →

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

Qué es esto

marketscore-direct-mcp es un conector ligero al servidor MCP alojado Direct Manager. El servidor en sí, el acceso a la API de Direct y toda la lógica se ejecutan en el lado del servicio — este paquete solo lo conecta a su asistente de IA.

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í es como funciona:

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

Claude: Encontré 3 problemas por 12 400 ₽: la campaña «Renovación de apartamentos — RSY» gastó 4 210 ₽ sin una sola conversión; el sitio dsp.example da un ROAS de 0.2; 6 palabras clave con gasto y cero solicitudes. ¿Desactivo el sitio y agrego las palabras clave como negativas?

Related MCP server: meta-ads-mcp-server

Qué puede hacer

Hasta 116 herramientas sobre la API de Direct v5 y la API de Reports (en los planes «Asistente» y «Profi» — 111, en «Agencia» — 116, incluyendo la visión general de cartera accounts_overview):

• Analítica y estadísticas — métricas de campañas por períodos y segmentos: dispositivos, género, edad, sitios RSY, geo; consultas de búsqueda; cuota de impresiones.

• Búsqueda de gastos ineficientes — campañas con ROAS < 1, gasto sin conversiones, sitios y palabras clave innecesarios.

• Gestión — pausa/reanudación, presupuesto diario y semanal, estrategias (incluyendo las de conversión con objetivo y CPA/ROAS objetivo), 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 — pronóstico de gasto y conversiones a 30 días, diagnóstico de caídas (tráfico/CR/CPC), explicación de cambios período a período con 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 innecesarios y presupuesto restante por cada cliente en una sola respuesta.

Las acciones de escritura están marcadas con anotaciones separadas — el asistente y el cliente ven qué se modifica exactamente antes de aplicar el cambio. Los errores de la API de Direct se manejan correctamente, incluidos los «silenciosos» (cuando la API responde con 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 se trata de publicidad, sino de 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

Esta es otra dirección y otra suscripción: 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.

Usted: ¿Por qué bajó el tráfico de búsqueda en los últimos 28 días?

Claude: Los clics cayeron de 940 a 610. La comparación solo se calcula por fuentes que midieron ambos períodos: 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 períodos), seo_search_queries (consultas y páginas de Webmaster y Search Console por dispositivos y regiones), seo_positions (última verificación de Topvisor), seo_indexation (cuántas páginas están 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 fuente para 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 bajo CTR, impresiones sin clics, canibalización), seo_sitemaps (si Yandex y Google ven el mapa del sitio), seo_url_inspection (veredicto de Google para una dirección específica), seo_request_recrawl (enviar una dirección para re-rastreo en Yandex), seo_text_check (sellos de IA, burocratismo y sobreoptimización en texto ruso listo).

• Demanda — seo_keyword_demand: frecuencia, frases similares, marcado de ruido y estacionalidad de Wordstat.

• Palabras clave y verificaciones — seo_keywords (qué está en verificación de posiciones), seo_add_keywords (poner frases en verificación), seo_positions_plan (horario de verificaciones, precio de inicio y saldo de Topvisor).

• Competidores — seo_competitors (nuestras posiciones junto a las suyas), seo_add_competitors (agregar sitios de competidores al proyecto).

• Proyecto — seo_projects (sitios del panel) y seo_sources (qué está conectado, qué ha caducado y qué exactamente deja de ser conocido mientras la fuente no funciona).

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

• La respuesta lleva procedencia. Cada cifra tiene fuente y fecha de obtención. El acceso revocado a Webmaster se ve como una denegación de fuente, no como tráfico cero: «no hay datos» y «no hay problemas» son respuestas diferentes, y el modelo no debe confundirlas.

• Las verificaciones 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 verificó y por qué» y limita la evaluación por arriba, no la reduce a «todo está bien».

• El límite de escritura está marcado por el dinero. El inicio pago de la verificación de posiciones, el cambio de horario, la eliminación de palabras clave y competidores en el chat no se han expuesto deliberadamente — descuentan dinero del saldo de Topvisor, y el precio debe ser visible en la pantalla antes del descuento. Dos herramientas de escritura encarecen la siguiente verificación de posiciones, y el asistente debe mencionar esta consecuencia antes de la llamada.

• Lo que no prometemos: no se recorre todo el sitio — se verifica 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 Wordstat), «Profi» — 1 490 ₽/mes (5 sitios, 10 auditorías, 200 Wordstat), «Agencia» — 9 900 ₽/mes (20 sitios, 60 auditorías, 2 000 Wordstat). Las 21 herramientas están disponibles en cualquier plan SEO activo. Las verificaciones de posiciones funcionan con el saldo de su cuenta de Topvisor — no hay recargo propio sobre ellas.

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

Instalación

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

Agregue 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 — autentíquese mediante OAuth. El token de Yandex no se transmite al asistente. Se pueden agregar dos direcciones simultáneamente: 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 registrarse — 7 días del plan «Profi» gratis (incluyendo el asistente de IA en Claude/ChatGPT). Luego:

• «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.

• «Profi» — 1 990 ₽/mes: las mismas 111 herramientas más panel web con analítica y piloto automático, hasta 5 cuentas de Direct.

• «Agencia» — 9 900 ₽/mes: 116 herramientas (más visión general 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 envoltorios open-source sobre la API de Direct

Existen envoltorios MCP autoalojados sobre la API de Direct (por ejemplo, mcp-yandex-direct). Comparación honesta:

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.

• El cambio de 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 «Profi» al registrarse). Luego — plan desde «Asistente» (990 ₽/mes, solo MCP) y superiores.

¿Dónde va 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. Las pausas de campañas y los presupuestos no los toca el piloto automático — solo por su orden.

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

¿En qué se diferencia de los envoltorios MCP gratuitos? Además del acceso a la API — capa de conclusiones de IA, auditoría, panel, bot de Telegram y visión general 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 saben 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 a este es independiente de los planes de Direct, hay 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, siga el enlace manualmente. Los tokens mcp-remote viven en ~/.mcp-auth — monte un volumen para no tener que reautenticarse en cada inicio.

Enlaces útiles

• ¿Qué es MCP-сервер для Яндекс Директа? https://app.marketscore.ru/blog/mcp-server-yandex-direct

• IA para Яндекс Директ — herramientas 2026: https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026

• Gestión de Директ a través de Claude y ChatGPT: https://app.marketscore.ru/blog/upravlenie-yandex-direct-cherez-claude-chatgpt

• MCP-сервер para Яндекс Вебмастер: https://app.marketscore.ru/blog/mcp-server-yandex-webmaster

• Red neuronal para SEO — qué se automatiza realmente: https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya

• ¿Por qué no coinciden los clics en Search Console? 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: up to 116 tools on top of Direct API v5 and Reports API — campaign analytics by device/gender/age/placements/geo, search queries, impression share, wasted-spend detection (ROAS < 1), campaign management (pause, budgets, strategies, negative keywords, bids), building campaigns from scratch, AI insights (spend forecast, drop diagnosis, change explanation, weekly brief), Wordstat keyword research, and a cross-account portfolio overview for agencies.

SEO MCP (separate server): https://app.marketscore.ru/api/mcp/seo — 21 tools for organic search on top of Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor and Wordstat: search performance and period comparison, queries and pages, Yandex indexation state with exclusion reasons, growth opportunities (near-top queries, low-CTR pages, impressions without clicks, cannibalisation), a full SEO audit with a source and a date behind every finding, single-page technical analysis (PageSpeed, Core Web Vitals, on-page signals), sitemap status in both engines, Google URL inspection, Yandex recrawl requests, competitor positions, keyword management in Topvisor, landing-page conversions from Metrica, and a deterministic Russian-text check. Only three tools write anything; paid position checks are deliberately kept out of chat. Every answer carries provenance — a revoked source shows up as a source failure, never as zero traffic. Separate subscription (590 / 1 490 / 9 900 ₽/mo, 7-day trial): https://app.marketscore.ru/seo

Pricing: a Direct Manager account is required; sign-up includes a 7-day free Pro trial. Assistant — 990 ₽/mo (111 tools, chat-only, 3 Direct accounts); Pro — 1 990 ₽/mo (111 tools + web dashboard, 5 accounts); Agency — 9 900 ₽/mo (116 tools incl. portfolio overview, 20 accounts). SEO is a separate plan axis on a separate connector URL. Without an active plan the server exposes zero tools.

FAQ:

Is it free? The first 7 days are (Pro trial on sign-up); after that a subscription is required.

Where does my Yandex token go? It stays on the Direct Manager service — the assistant and the MCP client never see it, and it is not stored in any local config.

Can the assistant break my ad account? Write tools are annotated separately and the MCP client asks for confirmation before running them.

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, ИИ-менеджер для Яндекс Директа, ИИ для рекламы.

License

MIT — see LICENSE. El conector es abierto; el servicio Direct Manager es un SaaS de pago. / The connector is open; the Direct Manager service is a paid SaaS.