Google Search Console Servidor MCP

Lista todas as propriedades do GSC a que o usuário autenticado tem acesso. Devolve o ID da propriedade (UUID) e a URL (sc-domain:…) que você passa para todas as outras ferramentas.

Cliques, impressões, CTR e posição média de uma propriedade na janela que você escolher. Aceita presets (last_7_days, last_28_days, last_3_months, last_year) ou datas absolutas from/to. Devolve também um branded_breakdown que separa cliques, impressões, CTR e posição entre marca e não marca — com base na tag Brand da propriedade.

Compara duas janelas do GSC lado a lado e devolve diff + change_pct de cliques, impressões, CTR e posição. O período A pode ser um preset; o período B é absoluto.

Os maiores movimentos entre dois períodos, com os deltas já calculados para o assistente não precisar abrir item por item. Escolha dimension=keywords or pages, uma métrica (cliques, impressões ou posição) e direction=up / down / both para ver quem ganhou, quem caiu ou as maiores oscilações em qualquer direção. Por padrão, o Period B é a janela imediatamente anterior ao Period A.

Principais palavras-chave de uma propriedade ordenadas por cliques, impressões, CTR ou posição — com comparação período a período. Paginação via next_cursor. Filtre com branded: true|false para separar as consultas de marca das ganhas no SEO; o resumo traz um branded_breakdown que você lê de relance.

Série temporal diária (cliques, impressões, CTR, posição) de uma única consulta de busca em uma propriedade. As mesmas opções de intervalo de datas do resumo.

Dada uma consulta, lista as páginas da sua propriedade que levam os cliques e as impressões dela — ordenadas por cliques, impressões, CTR ou posição, com deltas período a período e paginação via next_cursor. Serve para achar canibalização de palavras-chave ou a página canônica de um termo.

Ideias de palavras-chave de uma pesquisa iniciada no app (palavras-chave semente, uma página ou o domínio de um concorrente), com volume de busca, concorrência e lances do Google Ads ao lado da sua presença no Search Console. Por padrão mantém só o gap de conteúdo: as ideias para as quais você ainda não ranqueia.

Suas palavras-chave do Search Console agrupadas em clusters temáticos (criados no Keyword Map), cada um com cliques, impressões, posição média, volume de busca do Google Ads, valor do tráfego e curva de demanda de 12 meses.

Principais páginas de uma propriedade ordenadas por cliques, impressões, CTR ou posição — cada linha devolve cliques, impressões, CTR e posição com deltas período a período. Paginação via next_cursor.

Série temporal diária (cliques, impressões, CTR, posição) da URL de uma página em uma propriedade. Compatível direto com a mesma sintaxe de intervalo de datas do resumo.

Dada a URL de uma página, lista as consultas de busca que geram os cliques e as impressões dela — ordenadas pela métrica que você escolher, com deltas período a período e paginação via next_cursor. É o inverso de list_pages_for_keyword: você começa em uma URL e vê exatamente quais consultas a alimentam.

Cliques, impressões e CTR do Discover na janela, cada um comparado com a janela de mesma duração imediatamente anterior: *_current, *_prev, *_delta e *_change_pct (ctr é uma fração 0–1). O Discover não abre por consulta, posição, país ou dispositivo, então nada disso é devolvido.

A tendência diária do Discover: duas séries, cliques e impressões, como pontos {date, value}, com os dias faltantes preenchidos com 0 e prontas para gráfico, mais o número de pontos e uma flag insufficient_history.

As principais páginas da propriedade no Discover ordenadas por cliques — ou por impressões ou CTR —, cada uma com cliques, impressões e ctr na janela e a variação contra a janela anterior. Paginação por cursor via next_cursor.

Resumo de cobertura do índice de uma propriedade: URLs conhecidas (enviadas por sitemap), quantas o Google indexa, indexed_pct e uma abertura by_state (Submitted and indexed, Crawled – currently not indexed, Discovered – currently not indexed, Excluded by 'noindex', Page with redirect, Not found 404, Soft 404…). indexed traz prev/delta real; intervalo de datas por preset ou absoluto from/to.

A tendência diária de páginas indexadas — uma série "indexed" de pontos {date, value}, somada entre os sitemaps da propriedade e pronta para um gráfico de série temporal. Devolve points (dias com dado real) e marca insufficient_history quando há poucos dias para um gráfico que diga algo.

As URLs que estão em um determinado status de cobertura do Google (passe o status exatamente como get_indexation_summary reporta). Cada linha devolve url, state, last_crawled, google_canonical vs declared_canonical e discovered_via (sitemap ou página de referência). Paginação por cursor (limit máx. 200).

Inspeção de URL ao vivo do Google para uma página: coverage_state, verdict (PASS / NEUTRAL / FAIL), indexing_allowed, canonical do Google vs. do usuário, last_crawl_time, robots_txt_state, page_fetch_state, sitemaps, uma amostra de URLs de referência, rich_results e mobile_usability. Cache-first — devolve um resultado em cache recente ou atualiza ao vivo no GSC dentro da cota de inspeção da propriedade.

Todas as tarefas de uma propriedade. Filtre por status (open / done), responsável, taskbox (coluna) ou q (busca por título, sem diferenciar maiúsculas). Paginação via next_cursor.

As colunas do quadro de tarefas (taskboxes) de uma propriedade: id, nome, status (todo / in_progress / done) e ordem. Use um id de taskbox devolvido — ou a palavra-chave de status — em create_task ou update_task para mover uma tarefa para essa coluna.

Detalhe completo de uma tarefa. Aceita um UUID, um slug ou a URL completa da tarefa no navegador (o argumento property é opcional quando você passa uma URL).

Cria uma tarefa em uma propriedade com título (obrigatório), mais descrição opcional, responsável, prioridade (1–5, padrão 3) e taskbox (padrão: a coluna TO-DO).

Atualiza parcialmente uma tarefa — qualquer combinação de título, descrição, responsável, prioridade, taskbox, ou unassign:true para tirar o responsável.

Adiciona um comentário a uma tarefa. A mesma referência flexível ao ticket (UUID / slug / URL) de get_task e update_task.

Lista os comentários de uma tarefa, incluindo as respostas aninhadas. A mesma referência flexível ao ticket (UUID / slug / URL) de get_task — o argumento property é opcional quando você passa uma URL.

Adiciona um colega de time como seguidor de uma tarefa, ou remove com remove:true. O usuário é um e-mail ou um UUID de usuário e já precisa ser membro daquele quadro; ao adicionar, sai a mesma notificação que o app envia, e a chamada é idempotente.

Todos os marcos de roadmap no quadro de uma propriedade: id, slug, name, description, start_date e end_date (Y-m-d), color, progress (0–100, calculado pelas tarefas que estão na coluna DONE), state (upcoming / active / overdue / done / at_risk) e as contagens de tarefas e de tarefas concluídas. Passe um id ou slug devolvido para update_milestone ou assign_task_to_milestone.

Cria um marco de roadmap com datas. name mais startDate e endDate (Y-m-d, com o início igual ou anterior ao fim) são obrigatórios; description e uma cor #RRGGBB são opcionais. As tarefas entram depois, com assign_task_to_milestone.

Atualiza parcialmente um marco por id ou slug — qualquer combinação de name, description, startDate, endDate e color. Um marco pode ser movido, mas nunca ficar sem datas, e startDate precisa continuar igual ou anterior a endDate.

Associa uma tarefa a um marco, ou desassocia omitindo o marco. O ticket aceita um UUID, um slug ou a URL completa da tarefa no navegador, e uma tarefa pertence no máximo a um marco.

Cria uma nota de gráfico em uma propriedade para uma data específica (Y-m-d) com o texto da nota — mais uma descrição longa opcional, uma categoria e o UUID de uma tarefa associada. Entra como nota personalizada, de escopo global no site, com a sua autoria.

Lista as anotações de uma propriedade dentro de um intervalo de datas, das mais recentes para as mais antigas. Use um preset (last_7_days, last_28_days, last_3_months, last_year) ou datas absolutas from/to, com busca opcional por trecho do texto da nota e paginação (limit no máximo 200).

Detalhe completo de uma anotação pelo id — data, nota, descrição, categoria, tarefa associada, autor e a propriedade a que pertence. Use list_annotations para achar o id.

Apaga uma anotação personalizada pelo id. Você só remove as suas próprias notas personalizadas — notas oficiais ou globais são recusadas. Devolve o id com deleted: true.

Lista os projetos do Crawler da propriedade (configurações de rastreamento) para achar o audit_id. Cada um retorna audit_id, name, mode (list / complete / organic_traffic), device, start_urls, status, progress, last_crawl_date, pages_crawled e o último health_score. As outras ferramentas do Crawler usam por padrão o último rastreamento concluído, então você só precisa disso para apontar para um projeto específico.

Cria um projeto do Crawler (ação de escrita): rastrear o site inteiro, descoberto a partir do Search Console e dos sitemaps, ou uma lista fixa das suas URLs. Criar não rastreia nada nem gasta créditos; dispare com trigger_site_audit_crawl e depois ele é rastreado de novo toda semana.

Renomeia um projeto do Crawler, troca entre os modos complete e list ou substitui a lista de URLs (ação de escrita). Nada é rastreado até você disparar o próximo rastreamento.

Exclui um projeto do Crawler (ação de escrita, não dá para desfazer): ele some do app e das ferramentas de leitura, e o rastreamento semanal para.

Resumo de saúde técnica do último crawl: health_score (atual, mais prev e delta), pages_crawled, crawl_date, issues_by_severity (critical / warning / notice, cada um com issue_types e pages_affected contra o crawl anterior), issues_by_category (OnPage, Links, International, Robots, Social) e category_scores por área. Por padrão, usa a auditoria mais recente.

Os problemas técnicos encontrados no último crawl, dos mais graves primeiro — cada um com issue_code (passe para list_site_audit_issue_pages), title, severity, category, pages_affected (com prev e delta), orientação how_to_fix e priority. Filtre por severity e/ou category; paginação por cursor (limit máx. 200).

As URLs exatas afetadas por um problema — passe o issue_code dele e receba cada url em falta com o valor por página. Paginação por cursor (limit máx. 200). Transforma qualquer problema de auditoria direto em uma lista concreta de correções.

Detalhe completo de crawl de uma única URL: status_code, crawl_depth, indexability_score e health_score, category_scores, issue_counts e issues[] — as checagens que a página reprovou, cada uma com issue_code, severity, category, a descrição por página e how_to_fix.

Encontra páginas rastreadas que atendem a critérios técnicos de SEO no seu último rastreamento. Filtre por status_code (ex.: 404), no_canonical, missing_h1 ou check_title (qualquer verificação do Crawler que aparece no app, ex.: "Title Tag too short"). Ordene por saúde, status_code, url ou profundidade, com paginação via next_cursor. Cada linha retorna url, status_code, title, indexabilidade, performance_score (saúde 0–100), last_crawled_at, count_errors e count_warnings, mais check_description quando há um filtro de verificação ativo.

Inicia um novo crawl (ação de escrita) — coloca a auditoria na fila e consome os créditos de crawler do projeto (separados dos créditos MCP) em proporção às páginas rastreadas. Suporta os modos complete e list; devolve audit_id, status, started_at e pages_queued. Os resultados ficam disponíveis para as ferramentas de leitura assim que o crawl termina.

Compara dois crawls para responder "o que piorou ou melhorou desde a última vez?" — health_diff mais contagens e quatro listas: new_issues, resolved_issues, worsened e improved, cada problema com pages_affected, prev e delta. Por padrão, compara o último crawl com o anterior.

Lista as páginas que uma propriedade monitora no Code Monitor, cada uma com o status de monitoramento — url, last_change_at (mudança detectada mais recente) e changes_count (total de mudanças detectadas). Filtre por trecho da url; paginação por cursor (limit máx. 200). Devolve feature_not_available quando o plano não inclui o Code Monitor.

Lista as mudanças de código/HTML on-page detectadas, das mais recentes primeiro — cada uma com url, date e change_types (Title, Canonical, Meta Description, noindex, robots.txt, sitemap.xml, H1, Status code, Hreflang, Open Graph, Twitter image, Analytics, Tag Manager). Restrinja a uma página com seoMonitorId ou page, ou omita para pegar o feed de mudanças recentes do projeto inteiro; limite com from/to. Paginação por cursor (limit máx. 200).

Pega os valores de antes/depois de uma mudança detectada específica, identificada por url + createdAt — uma entrada por campo alterado, com type, property, before e after (arrays para campos com vários valores). Passe changeType para devolver só um campo. Devolve not_found quando nenhuma mudança bate e invalid_change_type para um rótulo de campo desconhecido.

Pega o estado capturado mais recente de uma página monitorada — os campos on-page extraídos no momento (title, canonical, meta description, meta robots, robots.txt, sitemap.xml, H1, headings, status code, hreflang, imagem Open Graph, Twitter image, Analytics, Tag Manager). Identifique a página por seoMonitorId ou url; o HTML bruto e as capturas de tela não são armazenados. Devolve not_found para uma página desconhecida.

Lista os prompts que uma propriedade monitora. Cada linha retorna prompt_id, prompt_text, engines_tracked, last_run_at (ISO-8601) e runs_in_range (execuções no período). Limite runs_in_range com um preset (last_7_days, last_28_days, last_3_months, last_year) ou datas from/to; a lista completa de prompts sempre volta. Filtre por mecanismo (chatgpt, claude, gemini, perplexity, ai_overview, ai_mode) ou por texto, mantenha só os prompts em que um concorrente aparece e você não (gapOnly) e pagine com limit (máx. 200) e next_cursor.

Visibilidade por mecanismo de um prompt: runs, mentions, mention_rate (%) e a variação em pontos em relação ao período anterior, para cada mecanismo em que roda (ChatGPT, Claude, Gemini, Perplexity, Google AI Overviews, Google AI Mode), com totais. No AI Overviews só uma citação conta como menção. Período por preset ou from/to (padrão last_28_days).

As rodadas de motor individuais por trás de um prompt — uma linha por rodada, com data, motor, flags mentioned / mentioned_in_text e um response_excerpt (até 600 caracteres da resposta real da IA). Filtre por engine, limite por intervalo de datas e pagine com limit (máx. 200) e next_cursor.

As fontes que os motores de IA citaram ao responder um prompt, somadas ao longo da janela: own_domain mais cada domínio e URL citados, marcados com is_own_domain e url_count — para você ver quais páginas suas ganham citação e quais concorrentes levam as outras.

Roda agora um prompt monitorado em todos os seus mecanismos, sem esperar o agendamento (ação de escrita). As respostas chegam em list_prompt_runs em poucos minutos; uma execução sob demanda por prompt por hora, compartilhada com o Run now do app.

Cria um prompt para monitorar: a pergunta enviada aos mecanismos de IA. Escolha os mecanismos (chatgpt, claude, gemini, perplexity, ai_overview, ai_mode), o país, o idioma da resposta e a frequência (daily, week ou month) e, se quiser, coloque-o em um tema por topicId ou topicTitle (encontra ou cria). A primeira execução começa na hora.

Atualiza parcialmente um prompt acompanhado — qualquer combinação do texto, lista de motores, país, idioma da resposta ou cadência; os campos omitidos ficam como estão. O prompt mantém o tópico atual e precisa continuar único dentro dele.

Apaga um prompt acompanhado e todas as respostas de motor registradas dele. Irreversível; o tópico do prompt continua intacto.

Lista os tópicos que agrupam prompts na página do LLM Tracker — cada um com topic_id e title. Passe um tópico para create_prompt / update_prompt para arquivar um prompt sob ele.

Cria (ou recupera) um tópico de prompts pelo título — um upsert idempotente, então recriar um título existente devolve ele inalterado, com created=false. Os tópicos agrupam prompts na página do LLM Tracker.

Renomeia um tópico de prompts pelo topicId. O novo título não pode ser vazio e precisa ser único dentro da propriedade (renomear para o mesmo título é um no-op com sucesso).

Apaga um tópico de prompts. Em cascata: cada prompt arquivado sob ele, e todas as respostas registradas desses prompts, também são apagados em definitivo. Devolve prompts_deleted. Irreversível.

A visão agregada de share of voice: o seu domínio contra os concorrentes em todos os prompts acompanhados, com cada domínio ordenado por share of voice (0–100 de visibilidade média) e a variação contra o período anterior, mais a contagem direta dos prompts que você ganha e perde para o principal concorrente. Use list_prompts / get_prompt_detail para o detalhe prompt a prompt.

Com que frequência a marca é citada em todos os prompts acompanhados dentro da janela: total_prompts mais três grupos que não se sobrepõem — mentioned (citada com destaque), mentioned_in_text (só no corpo da resposta) e absent —, cada um com contagem e porcentagem. Mede presença, não sentimento.

A tendência diária de visibilidade em IA: uma série de pontos {date, value} em que value é a porcentagem de prompts acompanhados cujas respostas linkaram para a marca naquele dia, pronta para gráfico. Devolve também o número de pontos na janela e marca insufficient_history quando a janela é curta demais para ler.

Lista as propriedades do GA4 conectadas aos seus projetos. Cada entrada devolve o id do projeto e a URL (qualquer um dos dois serve como argumento property nas outras ferramentas de GA4), o ID da propriedade GA4 por baixo e a data da conexão. Só aparecem os projetos com uma propriedade GA4 conectada.

Sessões, usuários, novos usuários, conversões, taxa de engajamento e sessões por usuário de uma propriedade na janela que você escolher — presets (last_7_days, last_28_days, last_3_months, last_year) ou datas absolutas from/to. Cada métrica devolve current, prev e delta contra o período imediatamente anterior.

Compara duas janelas do GA4 lado a lado — sessões, usuários, novos usuários, conversões e taxa de engajamento, com os dois valores mais diff e change_pct por métrica. O período A pode ser um preset; o período B é absoluto. É o gêmeo GA4 de compare_date_ranges.

Sessões abertas por fonte de aquisição. Escolha dimension=source_medium (padrão) ou channel para o agrupamento de canais padrão do GA4 — as linhas vêm ordenadas por sessões, cada uma com o share_pct do total do período, limitadas por limit (padrão 25, máx. 100).

Métricas do GA4 por página (landing / URL), ordenadas para você ver quais páginas geram mais sessões, cadastros (conversões) ou usuários. Cada linha devolve a página mais sessões, usuários, conversões e engagement_rate, cada uma com o prev do período anterior e a change_pct. Ordene por sessões (padrão), conversões ou usuários; limitada por limit (padrão 25, máx. 100). É a companheira em nível de página de get_ga4_traffic_by_source.

Tráfego de referência de IA/LLM por motor — ChatGPT, Perplexity, Gemini, Claude, Copilot e outros, detectados pelo source/medium da sessão no GA4. Cada motor devolve sessões, eventos principais e duração média de sessão, com a variação contra o período anterior. O seu tráfego de GEO, medido.

Lista as tags de palavras-chave e de páginas de uma propriedade. Cada tag devolve tag_id, name, type (keyword|page), color, rule_count (regras de atribuição automática) e member_count (palavras-chave ou páginas que a carregam hoje). Passe os nomes das tags no filtro tags de get_top_keywords, get_top_pages e list_winners_losers.

Cria uma tag em uma propriedade. type é keyword (marca palavras-chave), url (marca páginas) ou both. O color opcional é uma string hex usada pela UI da SEOcrawl AI. A identidade da tag é name + type, então recriar uma tag existente só atualiza a cor dela.

Aplica uma tag na mão a palavras-chave e/ou páginas específicas, além de qualquer regra automática. Passe keywords (strings exatas) e/ou urls (URLs exatas de páginas); pelo menos um é obrigatório. A tag é criada para o type correspondente se ainda não existir.

Tira uma tag de palavras-chave e/ou páginas específicas — o inverso de apply_tag. Só remove a atribuição nesses itens; não apaga a tag nem mexe nas regras de atribuição automática.

Apaga uma tag por completo: tira a atribuição de cada palavra-chave/página e remove a tag. type é keyword, url ou both. As tags nativas Brand / Non-Brand não podem ser apagadas. As regras automáticas que apontam para a tag continuam intactas — para elas, use delete_tag_rule.

Lista as regras de atribuição automática de uma propriedade — os padrões que marcam palavras-chave/páginas sozinhos. Se quiser, filtre por tag. Cada regra devolve rule_id, tag, field (keyword|url), country e as conditions dela (match + value).

Cria uma regra de atribuição automática que marca toda palavra-chave ou página que bater — as atuais e as futuras. field é keyword ou url; match é contains, not_contains, exact, starts_with, ends_with ou regex (um padrão RE2 seguro); value é o padrão. Uma regra por tag+field; a marcação dos itens já existentes roda de forma assíncrona.

Apaga uma regra de atribuição automática pelo rule_id (vindo de list_tag_rules). Para a marcação automática futura daquele padrão; os itens que já carregam a tag continuam com ela (use remove_tag ou delete_tag para tirar).

Lista as Smart Views de palavras-chave e de páginas definidas para uma propriedade — cada uma com view_id, name, type (keyword | page) e os nomes das tags que ela agrupa. As contagens de membros por tag vêm de list_tags.

Cria uma Smart View a partir de um conjunto de tags (leia as tags com list_tags). type é keyword (sobre tags de palavras-chave) ou page (sobre tags de páginas). A visão aparece na UI da SEOcrawl AI como uma criada por lá e pode ser editada ali.

Apaga uma Smart View pelo view_id. É permanente e some com a visão também na UI da SEOcrawl AI; as tags por baixo não são afetadas. Um id de filtro aplicado comum devolve not_found.

Liste os relatórios de SEO Reporting criados para uma propriedade — cada um com id, name, is_template, is_automate, created_at e owner. Retorna relatórios normais por padrão; passe templates: true para listar modelos de relatório. Relatórios recorrentes ficam de fora (use list_report_schedules). Paginado por cursor via next_cursor.

Pegue os metadados de um relatório (name, is_template, is_automate, owner, created_at, mais period e destinatários quando agendado) e a estrutura completa de widgets dele — type, título, posição, configuração e filtros de cada widget. Retorna a composição do relatório, não os números renderizados (para eles, use as ferramentas de GSC / GA4).

Gere um snapshot compartilhável de um relatório existente e receba a URL pública dele (ação de escrita). Captura o estado atual dos widgets, deduplicado por hash de conteúdo — não aceita intervalo de datas, então edite antes os widgets se precisar de outro período. Retorna report_id, snapshot_id e url.

Lista os relatórios de uma propriedade que saem sozinhos em envio recorrente — cada um com id, name, owner, period (week ou month) e os IDs de usuário de quem recebe. Mostra o agendamento salvo (period + destinatários). Paginação por cursor via next_cursor.

Busca uma URL ao vivo sob demanda (HTTP GET simples, sem JavaScript) e devolve os detalhes da resposta — URL final, status code, cadeia completa de redirecionamentos, tempo de resposta e tamanho descompactado da página — além de blocos opcionais: elementos de SEO analisados (title, meta description, meta robots, canonical, hreflang, headings, tags OG/Twitter, tipos de JSON-LD, contagem de palavras, contagem de links, imagens sem alt), o conteúdo principal em markdown limpo e o HTML bruto. Falha de transporte retorna erro estruturado (dns_error, timeout, blocked_url…). Grátis — nunca consome créditos MCP; com limite de uso por usuário.

Renderiza uma grade de cartões de KPI a partir de dados de resumo — cada cartão traz um rótulo, um valor cru, uma unidade opcional (prefixo $, sufixo % ou s para duração), a variação período a período com direção de alta/queda e um agrupamento opcional em seções quando passa de quatro cartões. Chamada sozinha quando uma ferramenta de resumo (get_gsc_summary, get_ga4_summary…) devolve render_with: render-scorecard. Grátis.

Renderiza uma tabela interativa com ordenação, busca e paginação no cliente a partir de qualquer resultado em lista — principais palavras-chave, principais páginas, maiores variações, prompts, backlinks e mais. As colunas são tipadas pelos dados e as células do tipo array viram chips. Chamada sozinha quando uma ferramenta de lista devolve render_with: render-data-table. Grátis.

Renderiza um gráfico de linhas interativo com tooltip no hover e linha de cruzamento, legenda que liga e desliga e eixo Y duplo automático quando duas séries usam unidades diferentes. Alimentado por qualquer ferramenta de histórico ou série diária (get_page_detail, get_keyword_detail, histórico de desempenho…) que devolva render_with: render-time-series-chart. Grátis.

Status em tempo real do backend MCP por área (Search Console, GA4, Crawler, Prompt Tracking, Tarefas) e por banco de dados, cada um como ok, degraded ou down com last_check_at e um sample_error. Grátis e sem argumentos: consulte antes de um fluxo com várias etapas para ver logo se algo está fora do ar.