MetricPort

npx add-mcp 'https://metricport.io/api/mcp'

metricport-mcp

Servidor MCP para Google Search Console, Google Ads e AdSense, utilizável a partir do Claude, Cursor, Windsurf, VS Code, ChatGPT e qualquer outro cliente MCP.

Este pacote é um cliente local leve. O servidor em si é hospedado em metricport.io: ele mantém a conexão OAuth do Google, comunica-se com as três APIs do Google e expõe 57 ferramentas de análise somente leitura, além de insights diários, alertas e relatórios. Você nunca precisa criar um projeto no Google Cloud, cliente OAuth ou token de desenvolvedor.

npx metricport-mcp

Início rápido

1. Crie uma conta gratuita em metricport.io e conecte uma conta do Google (Search Console no plano Free, Ads e AdSense no Pro).
2. Adicione o servidor ao seu cliente. Faça login uma vez no navegador ou crie uma chave de API em https://metricport.io/app/keys.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "metricport": {
      "command": "npx",
      "args": ["-y", "metricport-mcp"],
      "env": { "METRICPORT_API_KEY": "mp_..." }
    }
  }
}

Cursor (.cursor/mcp.json), Windsurf, VS Code (.vscode/mcp.json): mesma estrutura.

claude.ai, ChatGPT e outros clientes que suportam servidores remotos não precisam de pacote algum. Adicione um conector personalizado com a URL https://metricport.io/api/mcp e faça login.

O que você pode perguntar

• "Quais páginas perderam mais cliques esta semana e o que elas têm em comum?"
• "Mostre-me consultas em posição de destaque nas posições 5 a 20 com impressões reais."
• "Quais termos de pesquisa na minha conta do Google Ads gastam dinheiro sem converter?"
• "Por que meus ganhos do AdSense caíram em comparação ao mês passado?"
• "Onde estou pagando por palavras-chave pelas quais já rankeio organicamente?"

Ferramentas

Ferramenta	O que faz
gsc_search_analytics	Desempenho de pesquisa (cliques, impressões, CTR, posição) agrupado por dimensões com filtros opcionais
gsc_top_queries	Principais consultas de pesquisa por cliques nos últimos N dias (padrão 28)
gsc_top_pages	Principais páginas por cliques nos últimos N dias (padrão 28)
gsc_page_queries	Todas as consultas pelas quais uma única URL rankeia, com cliques, impressões, CTR e posição
gsc_quick_wins	Consultas em posição de destaque (padrão posições 5-20) com impressões reais, classificadas por cliques extras estimados se subirem ~3 posições
gsc_ctr_opportunities	Consultas na primeira página cujo CTR está muito abaixo do CTR esperado para sua posição
gsc_content_decay	Páginas que perderam mais cliques em comparação ao período anterior (ou ao mesmo período do ano anterior com compareTo=year)
gsc_new_and_lost_queries	Consultas que apareceram neste período, mas não no anterior, e consultas que desapareceram
gsc_cannibalization	Consultas em que duas ou mais das suas páginas competem pela mesma palavra-chave
gsc_brand_split	Divide consultas em marca e não-marca usando uma regex (ex.:
gsc_query_clusters	Agrupa consultas por termos compartilhados em clusters de tópicos com total de cliques, impressões e consultas de exemplo
gsc_question_queries	Consultas formuladas como perguntas (como, o que, por que, wie, was, warum…) ordenadas por impressões
gsc_zero_click_pages	Páginas que recebem impressões, mas nenhum clique
gsc_daily_trend	Cliques e impressões diários com média móvel de 7 dias, com quedas ou picos sinalizados (≥30% vs.
gsc_device_country_breakdown	Cliques, impressões, CTR e posição por dispositivo e por país, com a diferença de CTR entre mobile e desktop
gsc_search_appearance	Desempenho por aparência de pesquisa (rich results, vídeo, AMP…) além de tráfego do Discover e Google News no mesmo período
gsc_inspect_url	Status de indexação no Google para uma URL: veredito, estado de cobertura, último rastreamento, canônico, usabilidade mobile, rich results
gsc_index_check	Inspeciona até 10 URLs e retorna uma tabela compacta: indexado ou não, estado de cobertura, último rastreamento, canônico selecionado pelo Google vs.
gsc_sitemaps	Sitemaps enviados com status, erros, avisos e contagens de URLs
gsc_weekly_report	Uma chamada para um resumo semanal pronto para o cliente: totais vs.
ads_list_accounts	Contas de cliente do Google Ads conectadas, incluindo contas de gerente (MCC) e suas contas filhas diretas
ads_query	Executa uma consulta SELECT da Google Ads Query Language (GAQL) em uma conta de cliente
ads_campaign_performance	Campanhas com custo, cliques, impressões, CTR, conversões, custo por conversão, ROAS e status para um intervalo de datas (padrão últimos 30 dias)
ads_search_terms	Termos de pesquisa reais que acionaram anúncios, com custo, cliques, impressões e conversões
ads_wasted_spend	Termos de pesquisa que custaram dinheiro ou cliques, mas nunca converteram no período (padrão 30 dias), agregados entre campanhas, com sugestões de palavras-chave negativas (frase para palavras recorrentes, exata para casos isolados)
ads_keyword_performance	Palavras-chave com tipo de correspondência, status, qualidade, custo, cliques, conversões, CPA e participação de impressões
ads_quality_score_audit	Qualidade ponderada por impressões, distribuição de 1 a 10, e as palavras-chave em ou abaixo de um limite com seu componente mais fraco (CTR esperado, relevância do anúncio, experiência da página de destino) e o dinheiro gasto nelas
ads_impression_share	Participação de impressões de pesquisa por campanha, com participação perdida por orçamento e perdida por classificação, além de taxas de topo de página e topo absoluto
ads_budget_pacing	Gasto mensal até a data por campanha versus o gasto esperado com base no orçamento diário, com projeção para o fim do mês
ads_ad_performance	Anúncios de pesquisa responsivos com força do anúncio, URL final, contagem de títulos, CTR, custo, conversões
ads_geo_performance	Custo, cliques, conversões e CPA por país (ou por região/cidade com level)
ads_device_performance	Custo, cliques, CTR, conversões e CPA por dispositivo (mobile, desktop, tablet) para a conta ou uma campanha
ads_dayparting	Custo, cliques, conversões e CPA por hora do dia e por dia da semana
ads_landing_pages	Páginas de destino com custo, cliques, conversões, CPA e taxa de cliques compatível com mobile
ads_recommendations	Recomendações de otimização do próprio Google para a conta (palavras-chave, orçamentos, sugestões de anúncios, lances), com o impacto estimado quando disponível
ads_change_history	Quem mudou o quê na conta nos últimos N dias (máx. 30): tipo de recurso, operação, usuário, timestamp
ads_conversion_actions	Ações de conversão configuradas com status, categoria, tipo de contagem, modelo de atribuição e as conversões que cada uma produziu no período
ads_pmax_asset_groups	Grupos de ativos de campanhas Performance Max com força do anúncio, custo, conversões e valor
ads_daily_trend	Custo, cliques, conversões e CPA diários para a conta com picos ou quedas de gasto sinalizados (≥30% vs.
ads_metadata	Descreve campos selecionáveis de um recurso do Google Ads (ex.:
ads_account_audit	Uma chamada que executa as verificações principais: totais da campanha vs.
adsense_earnings	Resumo de ganhos: totais para o intervalo (padrão últimos 30 dias) além de um detalhamento diário
adsense_report	Relatório personalizado com dimensões e métricas escolhidas para um intervalo de datas (padrão últimos 30 dias)
adsense_top_pages	Páginas por ganhos estimados com visualizações de página e RPM
adsense_by_country	Ganhos, visualizações de página, RPM e CTR por país
adsense_ad_unit_performance	Unidades de anúncio com ganhos, impressões, RPM, CTR e visibilidade
adsense_platform_split	Ganhos, visualizações de página, RPM e CTR por plataforma (desktop, mobile de alta qualidade, tablet)
adsense_daily_trend	Ganhos, visualizações de página e RPM diários com quedas ou picos sinalizados (≥30% vs.
adsense_sites	Sites na conta do AdSense com estado de aprovação
adsense_alerts	Alertas de política e de conta para a conta do AdSense
adsense_payments	Saldo não pago e histórico de pagamentos para a conta do AdSense
adsense_ad_units	Unidades de anúncio por cliente de anúncio na conta do AdSense
adsense_monthly_report	Uma chamada: mês calendário até a data vs.
paid_vs_organic	Compara termos de pesquisa do Google Ads com consultas do Search Console no mesmo período
content_monetization	Junta cliques do Search Console por página com ganhos do AdSense por URL de página
landing_page_overview	Junta gasto e conversões de páginas de destino do Google Ads com cliques do Search Console para as mesmas URLs
list_properties	Lista todas as contas do Google conectadas com seus sites do Search Console, contas de cliente do Google Ads e contas do AdSense

Todas as ferramentas são somente leitura. A MetricPort nunca altera nada nas suas contas do Google.

Opções

npx metricport-mcp                      sign in with your MetricPort account
npx metricport-mcp --key mp_xxx         use an API key
METRICPORT_API_KEY=mp_xxx npx metricport-mcp
METRICPORT_URL=...                      override the server URL (self-hosted or staging)

Preços e dados

Plano gratuito: 1 conta do Google, Search Console, 500 chamadas de ferramenta por mês. Pro e Agency adicionam Google Ads, AdSense, mais contas, insights diários, alertas e relatórios compartilháveis. Veja https://metricport.io/pricing.

Hospedado em Frankfurt (UE). Tokens de atualização são criptografados em repouso, respostas brutas da API são armazenadas em cache na memória por cinco minutos e nunca gravadas em disco. Política de privacidade: https://metricport.io/privacy.

Licença

MIT para este pacote de cliente. O serviço hospedado é regido pelos termos.