Google Search Console Servidor MCP

Lista todas as propriedades GSC a que o utilizador autenticado tem acesso. Devolve o ID da propriedade (UUID) e a URL (sc-domain:…) que passas a todas as outras ferramentas.

Cliques, impressões, CTR e posição média para uma propriedade numa janela à escolha. Aceita presets (last_7_days, last_28_days, last_3_months, last_year) ou datas absolutas from/to. Devolve ainda um branded_breakdown que separa cliques, impressões, CTR e posição entre branded e non-branded — com base na etiqueta Brand da propriedade.

Compara duas janelas GSC lado a lado e obtém diff + change_pct para 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 pré-calculados para que o teu assistente não tenha de aprofundar item a item. Escolhe dimension=keywords or pages, uma métrica (cliques, impressões ou posição) e direction=up / down / both para obter os que ganham, os que descem ou as maiores oscilações em qualquer sentido. Por defeito, o Period B é a janela imediatamente anterior ao Period A.

Keywords top de uma propriedade ordenadas por cliques, impressões, CTR ou posição — com comparação período sobre período. Paginação via next_cursor. Filtra com branded: true|false para separar as queries de marca das ganhas por SEO; o resumo inclui um branded_breakdown que lês de um relance.

Série temporal diária (cliques, impressões, CTR, posição) para uma única query de pesquisa numa propriedade. Mesmas opções de intervalo de datas do resumo.

Dada uma única query, lista as páginas da tua propriedade que ganham os seus cliques e impressões — ordenadas por cliques, impressões, CTR ou posição, com deltas período sobre período e paginação via next_cursor. Útil para detetar canibalização de keywords ou encontrar a página canónica de um termo.

Páginas top 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 sobre período. Paginação via next_cursor.

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

Dada a URL de uma página, lista as queries de pesquisa que geram os seus cliques e impressões — ordenadas pela métrica que escolheres, com deltas período sobre período e paginação via next_cursor. O inverso de list_pages_for_keyword: começas numa URL e vês exatamente quais as queries que a alimentam.

Resumo de cobertura do índice para uma propriedade: URLs conhecidos (submetidos por sitemap), quantos o Google indexa, indexed_pct e uma discriminação 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 um prev/delta real; intervalo de datas via 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 dados reais) e sinaliza insufficient_history quando há poucos dias para um gráfico significativo.

Os URLs atualmente num dado estado de cobertura do Google (passa o estado exatamente como get_indexation_summary o 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, canónica do Google vs do utilizador, 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 a partir do GSC dentro da quota de inspeção da propriedade.

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

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

Detalhe completo de uma única tarefa. Aceita um UUID, um slug ou o URL completo da tarefa no browser (o argumento property é opcional quando passas um URL).

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

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

Acrescenta um comentário a uma tarefa. Mesma referência flexível ao ticket (UUID / slug / URL) que get_task e update_task.

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

Cria uma nota de gráfico numa propriedade para uma data específica (Y-m-d) com o texto da nota — além de uma descrição mais longa opcional, uma categoria e o UUID de uma tarefa associada. É adicionada como uma nota personalizada, de âmbito global no site, da tua autoria.

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

Detalhe completo de uma única anotação pelo seu id — data, nota, descrição, categoria, tarefa associada, autor e a propriedade a que pertence. Usa list_annotations para encontrar o id.

Elimina uma anotação personalizada pelo seu id. Só podes remover as tuas próprias notas personalizadas — as notas oficiais ou globais são rejeitadas. Devolve o id com deleted: true.

Lista os projetos de Site Audit (configurações de crawl) da propriedade para descobrires o audit_id a visar. Cada um devolve audit_id, name, mode (list / complete / organic_traffic), device, start_urls, status, progress, last_crawl_date, pages_crawled e o health_score mais recente. A maioria das outras ferramentas de site-audit usa por defeito a auditoria mais recentemente concluída, por isso isto só é necessário para visar uma específica.

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 face ao crawl anterior), issues_by_category (OnPage, Links, International, Robots, Social) e category_scores por área. Por defeito, usa a auditoria mais recente.

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

Os URLs exatos afetados por um problema — passa o seu issue_code e obtém cada url infrator com o valor por página. Paginação por cursor (limit máx. 200). Transforma qualquer problema de auditoria diretamente numa lista concreta de correções.

Detalhe completo de crawl para um único URL: status_code, crawl_depth, indexability_score e health_score, category_scores, issue_counts e issues[] — as verificações falhadas da página, cada uma com issue_code, severity, category, a descrição por página e how_to_fix.

Encontra as páginas rastreadas que correspondem a critérios de SEO técnico da tua última auditoria de site. Filtra por status_code (p. ex. 404), no_canonical (tag canónica em falta), missing_h1 (título H1 em falta) ou check_title (qualquer verificação da auditoria mostrada na UI, p. ex. "Title Tag too short"). Ordena por health, status_code, url ou depth, com paginação via next_cursor. Cada linha devolve url, status_code, title, indexability, performance_score (saúde 0–100), last_crawled_at, count_errors e count_warnings — além de um check_description quando há um filtro de verificação ativo.

Inicia um novo crawl (ação de escrita) — coloca a auditoria em fila e gasta 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 a "o que regrediu 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 defeito, compara o último crawl com o anterior.

Lista as páginas que uma propriedade monitoriza no Code Monitor, cada uma com o seu estado de monitorização — url, last_change_at (mudança detetada mais recente) e changes_count (total de mudanças detetadas). Filtra por subcadeia de url; paginação por cursor (limit máx. 200). Devolve feature_not_available quando o plano não inclui Code Monitor.

Lista as mudanças de código/HTML on-page detetadas, 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). Filtra numa única página com seoMonitorId ou page, ou omite-o para o feed de mudanças recentes de todo o projeto; restringe com from/to. Paginação por cursor (limit máx. 200).

Obtém os valores de antes/depois de uma mudança detetada específica, identificada por url + createdAt — uma entrada por cada campo alterado com type, property, before e after (arrays para campos com vários valores). Passa changeType para devolver apenas um campo. Devolve not_found quando nenhuma mudança corresponde e invalid_change_type para uma etiqueta de campo desconhecida.

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

Lista os prompts do AI Tracker (Brand Radar) que uma propriedade está a seguir. Cada linha devolve prompt_id, prompt_text, engines_tracked (os motores LLM contra os quais o prompt corre), last_run_at (ISO-8601, execução mais recente) e runs_in_range (execuções de motor dentro da janela). Delimita runs_in_range com um preset (last_7_days, last_28_days, last_3_months, last_year) ou datas absolutas from/to — a lista completa de prompts vem sempre de volta. Filtra por engine (chatgpt/openai, claude/anthropic, gemini, perplexity) e pagina via limit (máx. 200) e next_cursor.

Visibilidade por motor para um único prompt: execuções, menções, mention_rate (%) e a variação em pontos percentuais face ao período imediatamente anterior — discriminado por ChatGPT, Claude, Gemini e Perplexity, com totais agregados entre motores. Intervalo de datas via preset ou absoluto from/to (por defeito last_28_days).

As execuções de motor individuais por trás de um prompt — uma linha por execução com data, motor, flags mentioned / mentioned_in_text e um response_excerpt (até 600 carateres da resposta real da IA). Filtra por engine, delimita por intervalo de datas, pagina via limit (máx. 200) e next_cursor.

As fontes que os motores de IA citaram ao responder a um prompt, agregadas ao longo da janela: own_domain mais cada domínio e URL citados, sinalizados com is_own_domain e url_count — para veres quais das tuas páginas ganham citações e quais os concorrentes que as ganham.

Cria um prompt do AI Tracker — a pergunta que o tracker corre contra os motores. Define a lista de motores (chatgpt, claude, gemini, perplexity), o país, a língua da resposta e a cadência de execução (daily, week ou month) e, opcionalmente, arquiva-o sob um tópico por topicId ou topicTitle (find-or-create).

Atualiza parcialmente um prompt monitorizado — qualquer combinação do seu texto, lista de motores, país, língua da resposta ou cadência de execução; os campos omitidos ficam inalterados. O prompt mantém o seu tópico atual e tem de continuar único dentro dele.

Elimina um prompt monitorizado e todas as suas respostas de motor registadas. Irreversível; o tópico do prompt fica intacto.

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

Cria (ou obtém) um tópico de prompts pelo título — um upsert idempotente, por isso recriar um título existente devolve-o inalterado com created=false. Os tópicos agrupam prompts na página do LLM Tracker.

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

Elimina um tópico de prompts. Em cascata: cada prompt arquivado sob ele, e todas as respostas registadas desses prompts, são também eliminados permanentemente. Devolve prompts_deleted. Irreversível.

Lista as propriedades GA4 ligadas aos teus projetos. Cada entrada devolve o id do projeto e a URL (qualquer um dos dois serve como argumento property para as outras ferramentas GA4), o ID da propriedade GA4 subjacente e a data de ligação. Só são devolvidos os projetos com uma propriedade GA4 ligada.

Sessões, utilizadores, novos utilizadores, conversões, taxa de envolvimento e sessões por utilizador para uma propriedade numa janela à escolha — 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 face ao período imediatamente anterior.

Compara duas janelas GA4 lado a lado — sessões, utilizadores, novos utilizadores, conversões e taxa de envolvimento, com ambos os 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 divididas por fonte de aquisição. Escolhe dimension=source_medium (por defeito) ou channel para o agrupamento de canais predefinido do GA4 — as linhas vêm ordenadas por sessões, cada uma com o seu share_pct do total do período, limitadas por limit (por defeito 25, máx. 100).

Métricas do GA4 por página (landing / URL), ordenadas para veres que páginas geram mais sessões, registos (conversões) ou utilizadores. Cada linha devolve a página mais sessões, utilizadores, conversões e engagement_rate, cada uma com o prev do período anterior e a change_pct. Ordena por sessões (por defeito), conversões ou utilizadores; limitada por limit (por defeito 25, máx. 100). O companheiro ao nível da página de get_ga4_traffic_by_source.

Tráfego de referência de IA/LLM por motor — ChatGPT, Perplexity, Gemini, Claude, Copilot e mais, detetado a partir do source/medium da sessão do GA4. Cada motor devolve sessões, eventos principais e duração média de sessão, com a variação face ao período anterior. O teu tráfego GEO, medido.

Lista as etiquetas de keywords e páginas de uma propriedade. Cada etiqueta devolve tag_id, name, type (keyword|page), color, rule_count (regras de atribuição automática) e member_count (keywords ou páginas que a carregam atualmente). Passa os nomes das etiquetas ao filtro tags em get_top_keywords, get_top_pages e list_winners_losers.

Cria uma etiqueta numa propriedade. type é keyword (etiqueta keywords), url (etiqueta páginas) ou both. O color opcional é uma string hex usada pela UI do SEOcrawl. A identidade da etiqueta é name + type, por isso recriar uma etiqueta existente apenas atualiza a sua cor.

Aplica manualmente uma etiqueta a keywords e/ou páginas específicas, para além de quaisquer regras automáticas. Passa keywords (strings exatas) e/ou urls (URLs exatos de páginas); pelo menos um é obrigatório. A etiqueta é criada para o type relevante se ainda não existir.

Remove uma etiqueta de keywords e/ou páginas específicas — o inverso de apply_tag. Apenas retira a atribuição da etiqueta a esses itens; não elimina a própria etiqueta nem mexe nas regras de atribuição automática.

Elimina uma etiqueta por completo: retira-lhe a atribuição de cada keyword/página e remove a etiqueta. type é keyword, url ou both. As etiquetas integradas Brand / Non-Brand não podem ser eliminadas. As regras automáticas que visam a etiqueta ficam intactas — usa delete_tag_rule para essas.

Lista as regras de atribuição automática de uma propriedade — os padrões que etiquetam keywords/páginas automaticamente. Opcionalmente, filtra por tag. Cada regra devolve rule_id, tag, field (keyword|url), country e as suas conditions (match + value).

Cria uma regra de atribuição automática que etiqueta cada keyword ou página correspondente — atuais e 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 etiquetagem dos itens existentes corre de forma assíncrona.

Elimina uma regra de atribuição automática pelo seu rule_id (de list_tag_rules). Para a etiquetagem automática futura para esse padrão; os itens que já carregam a etiqueta mantêm-na (usa remove_tag ou delete_tag para retirar a atribuição).

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

Cria uma Smart View a partir de um conjunto de etiquetas (lê-as de list_tags). type é keyword (sobre etiquetas de keywords) ou page (sobre etiquetas de páginas). A vista aparece na UI do SEOcrawl tal como uma criada nativamente e pode ser editada lá.

Elimina uma Smart View pelo seu view_id. Permanente e remove a vista também da UI do SEOcrawl; as etiquetas subjacentes não são afetadas. Um id de filtro aplicado normal 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 são excluídos (use list_report_schedules). Paginado por cursor via next_cursor.

Obtenha os metadados de um relatório (name, is_template, is_automate, owner, created_at, além de period e destinatários quando agendado) e sua estrutura completa de widgets — 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 (leia-os com as ferramentas GSC / GA4).

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

Liste os relatórios configurados para envio recorrente automático em uma propriedade — cada um com id, name, owner, period (week ou month) e os IDs de usuário dos destinatários. Reflete a configuração de agendamento salva (period + destinatários). Paginado por cursor via next_cursor.

Busca uma única URL ao vivo sob demanda (HTTP GET simples, sem JavaScript) e devolve os detalhes da resposta — URL final, código de status, cadeia completa de redirecionamentos, tempo de resposta e tamanho descomprimido da página — além de blocos opcionais: elementos SEO analisados (title, meta description, meta robots, canonical, hreflang, títulos, tags OG/Twitter, tipos JSON-LD, contagem de palavras, contagem de links, imagens sem alt), o conteúdo principal como markdown limpo e o HTML bruto. Falhas de transporte retornam erros estruturados (dns_error, timeout, blocked_url…). Gratuito — nunca consome créditos MCP; com limite de uso por usuário.

Renderize uma grelha de cartões de KPI a partir de dados de resumo — cada cartão inclui uma etiqueta, um valor em bruto, uma unidade opcional (prefixo $, sufixo % ou s para uma duração), uma variação período a período com direção ascendente/descendente e um agrupamento opcional em secções quando há mais de quatro cartões. Chamado automaticamente quando uma ferramenta de resumo (get_gsc_summary, get_ga4_summary…) devolve render_with: render-scorecard. Grátis.

Renderize uma tabela interativa com ordenação, pesquisa e paginação do lado do cliente a partir de qualquer resultado em lista — principais palavras-chave, principais páginas, maiores variações, prompts, backlinks e muito mais. As colunas são tipadas a partir dos dados e as células do tipo array mantêm-se como chips. Chamado automaticamente quando uma ferramenta de lista devolve render_with: render-data-table. Grátis.

Renderize um gráfico de linhas interativo com tooltip ao passar o cursor e linha de cruzamento, uma legenda comutável e um 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.

Estado ao vivo do backend MCP por superfície (GSC, GA4, Site Audit, AI Tracker, Tarefas) e por armazenamento de dados, cada um reportado como ok, degraded ou down com last_check_at e um sample_error. Gratuito e sem argumentos — consulta-o antes de um fluxo de vários passos para que um endpoint avariado fique visível à partida.