Yandex Direct Manager

Conector de IA para Yandex Direct: conecte o Claude ou ChatGPT à sua conta de anúncios e gerencie campanhas diretamente no diálogo — estatísticas, busca de gastos ineficientes, lances, orçamentos, palavras-chave negativas, auditoria.

GitHub

Experimente este MCPPatrocinado

Documentação

Direct Manager — MCP para Yandex Direct

Conecte o Claude ou ChatGPT ao Yandex Direct e gerencie seus anúncios em conversa: "Onde o dinheiro está sendo desperdiçado?" → o assistente encontra campanhas com ROAS < 1 e sugere o que desativar.

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

Experimente grátis — 7 dias do plano "Profi" →

Site / Website: https://app.marketscore.ru

O que é

marketscore-direct-mcp — um conector leve para o servidor MCP hospedado Direct Manager. O próprio servidor, o acesso à Direct API e toda a lógica funcionam no lado do serviço — este pacote apenas conecta seu assistente de IA a ele.

O serviço tem dois servidores MCP independentes: o de publicidade (Direct, VK, Avito, Wordstat) e o de SEO (Webmaster, Search Console, Metrica, Topvisor) — seção sobre SEO abaixo.

Como funciona na prática:

Você: Onde meu dinheiro está sendo desperdiçado nos últimos 14 dias?

Claude: Encontrei 3 problemas totalizando 12.400 ₽: a campanha "Reparo de apartamentos — RSM" gastou 4.210 ₽ sem nenhuma conversão; o site dsp.example tem ROAS de 0.2; 6 palavras-chave com gasto e zero leads. Desativo o site e adiciono as palavras-chave como negativas?

O que ele faz

Até 116 ferramentas sobre a Direct API v5 e a Reports API (nos planos "Assistente" e "Profi" — 111, no "Agência" — 116, incluindo o accounts_overview de portfólio):

Análise e estatísticas — métricas de campanhas por períodos e segmentações: dispositivos, gênero, idade, sites RSM, geo; consultas de pesquisa; parcela de impressões.
Detecção de gastos ineficientes — campanhas com ROAS < 1, gastos sem conversões, sites e palavras-chave desnecessários.
Gerenciamento — pausar/retomar, orçamento diário e semanal, estratégias (incluindo as de conversão com meta e meta de CPA/ROAS), palavras-chave negativas, palavras-chave, lances e ajustes.
Criação de campanhas do zero — campanha → grupo → anúncio com links rápidos e UTM.
Insights de IA — previsão de gastos e conversões para 30 dias, diagnóstico de quedas (tráfego/CR/CPC), explicação de mudanças período a período com fatores, ranking das descobertas em rublos, briefing semanal pronto em uma única chamada.
Wordstat — seleção de palavras com frequências.
Para agências — visão geral do portfólio em todas as contas: gastos, lucro, desperdícios e saldo de orçamento de cada cliente em uma única resposta.

Ações de escrita são marcadas com anotações separadas — o assistente e o cliente veem exatamente o que será alterado antes da aplicação. Erros da Direct API são tratados corretamente, inclusive os "silenciosos" (quando a API responde 200, mas a alteração não foi aplicada).

MarketScore SEO — segundo MCP, para otimização de busca

A mesma conta tem um servidor MCP separado para SEO: não é sobre anúncios, mas sobre busca orgânica — Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor e Wordstat em um único assistente.

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

É um endereço diferente e uma assinatura diferente: o plano de SEO não está incluído nos planos do Direct e vice-versa. As ferramentas do Direct não aparecem no endereço de SEO, e vice-versa.

Você: Por que o tráfego de busca caiu nos últimos 28 dias?

Claude: Os cliques caíram de 940 para 610. A comparação é feita apenas com fontes que mediram ambos os períodos: Search Console — sim, Webmaster — sim, Topvisor não está conectado, posições não foram verificadas de forma independente. A maior queda está na seção /catalog: 18 páginas saíram da busca do Yandex com o motivo "duplicado", o Webmaster vê isso desde 3 de agosto. Mostrar a lista de URLs?

21 ferramentas, das quais apenas três alteram algo (seo_add_keywords, seo_add_competitors, seo_request_recrawl) — as demais são somente leitura:

Dados de busca — seo_overview (cliques, impressões, CTR, posição média, top-3/top-10 e comparação de períodos), seo_search_queries (consultas e páginas do Webmaster e Search Console por dispositivos e regiões), seo_positions (última verificação do Topvisor), seo_indexation (quantas páginas estão na busca do Yandex, o que foi excluído e por qual motivo), seo_metrika (comportamento de visitantes vindos da busca e metas atingidas), seo_landing_pages (visitas e leads por página de entrada).
Trabalho com o site — seo_audit (análise de indexação, técnica, on-page e concorrência de páginas com fonte em cada resultado), seo_page_analysis (velocidade, Core Web Vitals e sinais on-page da página), seo_opportunities (consultas próximas ao topo, páginas com CTR baixo, impressões sem cliques, canibalização), seo_sitemaps (se o Yandex e o Google veem o sitemap), seo_url_inspection (veredito do Google para um URL específico), seo_request_recrawl (enviar URL para reindexação no Yandex), seo_text_check (marcas de IA, burocratês e excesso de palavras-chave em texto russo pronto).
Demanda — seo_keyword_demand: frequência, frases semelhantes, marcação de ruído e sazonalidade do Wordstat.
Palavras-chave e verificações — seo_keywords (o que está em verificação de posições), seo_add_keywords (colocar frases em verificação), seo_positions_plan (agendamento de verificações, preço de execução e saldo do Topvisor).
Concorrentes — seo_competitors (nossas posições ao lado das posições deles), seo_add_competitors (adicionar sites de concorrentes ao projeto).
Projeto — seo_projects (sites do painel) e seo_sources (o que está conectado, o que expirou e o que exatamente deixa de ser conhecido enquanto a fonte não funciona).

O que foi feito de diferente aqui em relação aos wrappers sobre as mesmas APIs:

A resposta carrega proveniência. Cada número tem fonte e data de coleta. Acesso revogado ao Webmaster aparece como falha de fonte, não como tráfego zero: "sem dados" e "sem problemas" são respostas diferentes, e o modelo não deve confundi-las.
Verificações não concluídas são listadas. Uma auditoria com fonte silenciosa ou sem direitos confirmados sobre o site retorna uma lista de "o que exatamente não foi verificado e por quê" e limita a avaliação por cima, em vez de rebaixá-la para "está tudo bem".
A fronteira de escrita é definida por dinheiro. Execução paga de verificação de posições, alteração de agendamento, exclusão de palavras-chave e concorrentes no chat são deliberadamente não expostas — elas debitam dinheiro do saldo do Topvisor, e o preço deve ser visível na tela antes do débito. Duas ferramentas de escrita encarecem a próxima verificação de posições, e o assistente é obrigado a informar essa consequência antes da chamada.
O que não prometemos: não há varredura do site inteiro — uma página é verificada por chamada; a exclusividade do texto não é verificada (não temos fonte); posições sem Topvisor conectado não são inventadas.

Planos de SEO (assinatura separada, 7 dias grátis): "Start" — 590 ₽/mês (1 site, 2 auditorias, 20 consultas Wordstat), "Profi" — 1.490 ₽/mês (5 sites, 10 auditorias, 200 Wordstat), "Agência" — 9.900 ₽/mês (20 sites, 60 auditorias, 2.000 Wordstat). Todas as 21 ferramentas estão disponíveis em qualquer plano de SEO ativo. As verificações de posições funcionam com o saldo da sua conta Topvisor — sem margem adicional sobre elas.

Mais detalhes: https://app.marketscore.ru/seo

Instalação

Claude (Desktop, web, Code) e ChatGPT — via link

Adicione o conector MCP remoto:

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

O assistente abrirá o login — autorize via OAuth. O token do Yandex não é transmitido ao assistente. Os dois endereços podem ser adicionados ao mesmo tempo: são conectores independentes com assinaturas independentes.

Clientes MCP locais (Cursor, VS Code, Cline, Zed) — via bridge

npx -y marketscore-direct-mcp

Exemplo de configuração do cliente MCP:

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

Planos e acesso

O conector requer uma conta Direct Manager. No registro — 7 dias do plano "Profi" grátis (incluindo o assistente de IA no Claude/ChatGPT). Depois:

"Assistente" — 990 ₽/mês: conjunto MCP completo (111 ferramentas) para trabalhar pelo chat de IA, até 3 contas do Direct. Sem dashboard web — apenas assistente.
"Profi" — 1.990 ₽/mês: as mesmas 111 ferramentas mais dashboard web com análise e autopiloto, até 5 contas do Direct.
"Agência" — 9.900 ₽/mês: 116 ferramentas (mais visão de portfólio accounts_overview), até 20 contas.
SEO — eixo separado de planos (590 / 1.490 / 9.900 ₽/mês) e endereço de conector separado. O plano do Direct não dá acesso às ferramentas de SEO, e vice-versa.

Sem um plano ativo, o servidor retorna 0 ferramentas. Registro: https://app.marketscore.ru/register · Planos: https://app.marketscore.ru/pricing · SEO: https://app.marketscore.ru/seo

Diferenças em relação aos wrappers open-source da Direct API

Existem wrappers MCP self-host sobre a Direct API (por exemplo, mcp-yandex-direct). Comparação honesta:

	Direct Manager (este conector)	Wrapper self-host
Instalação	Login OAuth via link	obter token do Direct e inseri-lo no config
Insights de IA, auditoria, autopiloto	sim (previsão, diagnóstico, briefing, top de descobertas)	não — apenas chamadas brutas de API
Dashboard web e bot do Telegram	sim	não
Portfólio de contas	sim (visão geral de todos os clientes)	não
Preço	assinatura (7 dias grátis)	grátis, mas você configura e hospeda
Onde o token do Yandex fica	no serviço, não está no config do cliente	localmente no config do cliente

Segurança

Autenticação — OAuth 2.1: o token do Yandex não é transmitido ao assistente e não fica no config do cliente; ele é armazenado no lado do serviço.
Alterar a senha da conta Direct Manager revoga todos os acessos MCP emitidos.
Ações de escrita são marcadas com anotações e confirmadas no lado do cliente MCP.
Dados pessoais são armazenados em servidores na Rússia (152-FZ).

FAQ

É grátis? Os primeiros 7 dias — sim (teste do plano "Profi" no registro). Depois — planos a partir do "Assistente" (990 ₽/mês, somente MCP) e acima.

Para onde vai o token do Direct? Ele é emitido ao serviço Direct Manager na conexão OAuth e armazenado nos servidores dele. O assistente e o cliente MCP não veem o token.

O assistente pode quebrar algo no painel? As ferramentas de escrita são marcadas separadamente, e o cliente MCP solicita confirmação antes de chamá-las. O autopiloto não pausa campanhas nem altera orçamentos sozinho — apenas sob seu comando.

Funciona com ChatGPT, Cursor, VS Code? Sim: Claude e ChatGPT conectam via URL diretamente; Cursor/VS Code/Cline/Zed — via este pacote (npx -y marketscore-direct-mcp).

Qual a diferença para os wrappers MCP gratuitos? Além do acesso à API — camada de insights de IA, auditoria, dashboard, bot do Telegram e visão de portfólio; o token do Yandex não fica no config. Mais detalhes na tabela acima.

Funciona sem assinatura? Não — sem um plano ativo, o servidor retorna 0 ferramentas.

Vocês também fazem SEO? Sim, por um servidor MCP separado: https://app.marketscore.ru/api/mcp/seo — 21 ferramentas sobre Yandex Webmaster, Google Search Console, Metrica, Topvisor e Wordstat. A assinatura é separada dos planos do Direct, com teste de 7 dias.

Docker

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

A URL OAuth é impressa no stdout — o navegador não abrirá a partir do contêiner; acesse o link manualmente. Os tokens mcp-remote ficam em ~/.mcp-auth — monte um volume para não precisar reautorizar a cada execução.

Links úteis

O que é um servidor MCP para Yandex Direct: https://app.marketscore.ru/blog/mcp-server-yandex-direct
IA para Yandex Direct — ferramentas 2026: https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026
Gerenciamento do Direct via Claude e 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
Rede neural para SEO — o que realmente é automatizável: https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya
Por que os cliques no Search Console não batem: 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"]
    }
  }
}

Ferramentas: até 116 ferramentas sobre a Direct API v5 e a Reports API — análise de campanhas por dispositivo/gênero/idade/posições/geo, consultas de pesquisa, participação de impressões, detecção de gastos desperdiçados (ROAS < 1), gerenciamento de campanhas (pausa, orçamentos, estratégias, palavras-chave negativas, lances), criação de campanhas do zero, insights de IA (previsão de gastos, diagnóstico de quedas, explicação de mudanças, resumo semanal), pesquisa de palavras-chave no Wordstat e uma visão geral de portfólio entre contas para agências.

SEO MCP (servidor separado): https://app.marketscore.ru/api/mcp/seo — 21 ferramentas para busca orgânica sobre o Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor e Wordstat: desempenho de busca e comparação de períodos, consultas e páginas, estado de indexação do Yandex com motivos de exclusão, oportunidades de crescimento (consultas quase no topo, páginas com baixo CTR, impressões sem cliques, canibalização), uma auditoria de SEO completa com fonte e data por trás de cada descoberta, análise técnica de página única (PageSpeed, Core Web Vitals, sinais on-page), status de sitemap em ambos os mecanismos, inspeção de URL do Google, solicitações de recrawl do Yandex, posições de concorrentes, gerenciamento de palavras-chave no Topvisor, conversões de landing page do Metrica e uma verificação determinística de texto em russo. Apenas três ferramentas escrevem algo; verificações de posições pagas são deliberadamente mantidas fora do chat. Cada resposta traz proveniência — uma fonte revogada aparece como falha de fonte, nunca como tráfego zero. Assinatura separada (590 / 1 490 / 9 900 ₽/mês, teste de 7 dias): https://app.marketscore.ru/seo

Preços: uma conta Direct Manager é necessária; o cadastro inclui um teste Pro gratuito de 7 dias. Assistente — 990 ₽/mês (111 ferramentas, somente chat, 3 contas Direct); Pro — 1 990 ₽/mês (111 ferramentas + painel web, 5 contas); Agência — 9 900 ₽/mês (116 ferramentas incl. visão geral de portfólio, 20 contas). SEO é um eixo de plano separado em uma URL de conector separada. Sem um plano ativo, o servidor expõe zero ferramentas.

FAQ:

É gratuito? Os primeiros 7 dias são (teste Pro no cadastro); depois disso, é necessária uma assinatura.

Para onde vai meu token do Yandex? Ele permanece no serviço Direct Manager — o assistente e o cliente MCP nunca o veem, e ele não é armazenado em nenhuma configuração local.

O assistente pode quebrar minha conta de anúncios? As ferramentas de escrita são anotadas separadamente e o cliente MCP pede confirmação antes de executá-las.

Palavras-chave: Yandex Direct, Яндекс Директ, MCP, Model Context Protocol, MCP server, PPC, gerenciamento de anúncios, análise de campanhas, ROAS, palavras-chave negativas, Wordstat, Claude, ChatGPT, Cursor, marketing com IA, SEO MCP, Yandex Webmaster, Яндекс Вебмастер, Google Search Console, Yandex Metrica, Topvisor, auditoria de SEO, ИИ-менеджер для Яндекс Директа, ИИ для рекламы.

Licença

MIT — veja LICENSE. Коннектор открыт; сервис Direct Manager — платный SaaS. / O conector é aberto; o serviço Direct Manager é um SaaS pago.