GSC Wizard MCP

Seu assistente de IA pode consultar análises do Search Console

Ver em gscwizard.comExperimente este MCPPatrocinado

Documentação

Este servidor implementa o Model Context Protocol. Uma vez conectado, seu assistente de IA pode consultar análises do Search Console, inspecionar URLs, gerenciar clusters de tópicos e grupos de conteúdo, usar a API de Inspeção do Google, enviar URLs para o IndexNow, ler dados do Bing Webmaster Tools e muito mais, tudo limitado à sua própria conta.

Tudo o que você precisa para conectar: uma chave de API MCP, gratuita para toda conta do GSC Wizard. Crie uma em tool.gscwizard.com/account/api-keys. As chaves têm o formato gscw_live_... e são mostradas apenas uma vez na criação.

Por que a análise é executada no servidor

A maioria dos servidores MCP de SEO e análise entrega as linhas brutas de volta ao modelo: milhares de registros de consultas/páginas transmitidos para a janela de contexto para o LLM processar. Modelos de linguagem não são feitos para aritmética sobre tabelas grandes. Eles são lentos nisso, queimam tokens fazendo isso e cometem erros (linhas descartadas, somas mal contadas, totais alucinados) que são difíceis de detectar.

O GSC Wizard faz o oposto. Cada análise (curvas de CTR, detecção de declínio, canibalização, pontuação de oportunidades, detalhamentos de caminho, mudanças de ranking, relatórios completos de SEO) é calculada em Python e SQL no lado do servidor, contra o data warehouse, antes que qualquer coisa chegue ao modelo. A ferramenta retorna o resultado finalizado, não a entrada bruta.

O que isso traz para você

  • Muito menos tokens. Uma única chamada de ferramenta retorna uma resposta compacta e finalizada em vez de dezenas de milhares de linhas que o modelo teria que ler, manter no contexto e pagar por elas.
  • Muito mais rápido. Agregações são executadas no warehouse em milissegundos. O modelo gasta seu tempo raciocinando sobre o resultado, não processando uma planilha token por token.
  • Não propenso a erros. A matemática é determinística. Os números vêm de consultas reais, então não há risco de o modelo contar errado ou inventar totais.
  • Conjuntos de dados maiores no escopo. Como o trabalho pesado nunca entra na janela de contexto, o servidor pode analisar meses de dados e milhões de linhas que nunca caberiam em um prompt.

O modelo ainda faz o que faz bem: interpretar os achados, identificar a história e recomendar o que fazer a seguir. O processamento pesado acontece onde deve acontecer.

Endpoint

HTTP Streamable

https://mcp.gscwizard.com/mcp

Duas formas de autenticar, ambas vinculadas à sua conta do GSC Wizard:

  • Chave de API (cabeçalho): envie Authorization: Bearer gscw_live_.... Melhor para clientes baseados em arquivo de configuração (Claude Code, Cursor, VS Code, Windsurf).
  • OAuth 2.1 (login): clientes que suportam OAuth remoto (ChatGPT, a interface de Conectores do Claude web/app, o conector nativo do Claude Desktop) descobrem automaticamente e guiam você por um login do Google e tela de consentimento. Sem chave para copiar ou armazenar.

Em clientes que renderizam saída rica de ferramentas (como ChatGPT), ferramentas de resumo como get_site_summary, query_top_queries, query_top_pages, get_ranking_changes, list_sites e generate_seo_report exibem uma visualização interativa de cartão/tabela adaptada ao tema. Outros clientes recebem os mesmos dados como JSON.

Conectar um cliente

O servidor fala HTTP Streamable, então qualquer cliente que suporte servidores MCP remotos pode se conectar. Os clientes baseados em arquivo de configuração abaixo (Claude Code, Cursor, VS Code, Windsurf) autenticam com um cabeçalho de chave de API: substitua gscw_live_... pela sua chave. Clientes que suportam OAuth remoto (ChatGPT, a interface de Conectores do Claude web/app, o conector nativo do Claude Desktop) precisam apenas da URL e farão seu login: veja a nota de OAuth em cada seção.

Claude Code

claude mcp add --transport http gsc-wizard \
  https://mcp.gscwizard.com/mcp \
  --header "Authorization: Bearer gscw_live_..."

Claude Desktop

Mais fácil (OAuth, sem Node): Configurações → Conectores → Adicionar conector personalizado, insira https://mcp.gscwizard.com/mcp como URL e deixe os campos OAuth em branco. O Claude se registra automaticamente, abre uma tela de login e consentimento do Google e conecta. Nada para copiar ou armazenar.

Claude Desktop Add custom connector dialog with the GSC Wizard MCP URL filled in and the OAuth Client ID and Secret fields left blank

Adicionar conector personalizado: cole a URL, deixe os campos OAuth em branco.

Alternativa (chave de API estática): O arquivo de configuração do Claude Desktop inicia apenas servidores locais (stdio), então colar uma entrada "type": "http" é rejeitado como inválido. Para usar uma chave de API em vez de OAuth, faça a ponte do servidor remoto através do mcp-remote (requer Node.js). Configurações → Desenvolvedor → Editar Configuração, então adicione:

{
  "mcpServers": {
    "gsc-wizard": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.gscwizard.com/mcp",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer gscw_live_..." }
    }
  }
}

A chave vai em env em vez de inline porque mcp-remote divide cada valor de --header por espaços, então Authorization:${AUTH_HEADER} é escrito sem espaço. No Windows, se npx falhar ao iniciar, defina "command": "cmd" e prefixe "/c", "npx" a args. Saia e reabra o Claude Desktop completamente após salvar.

Cursor

Adicione a ~/.cursor/mcp.json (global) ou .cursor/mcp.json em um projeto:

{
  "mcpServers": {
    "gsc-wizard": {
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": {
        "Authorization": "Bearer gscw_live_..."
      }
    }
  }
}

VS Code (modo agente do GitHub Copilot)

Adicione a .vscode/mcp.json no seu workspace (ou execute o comando MCP: Add Server). O VS Code usa servers, não mcpServers, e pode solicitar a chave para que ela fique fora do controle de versão:

{
  "inputs": [
    { "id": "gscw-key", "type": "promptString", "description": "GSC Wizard MCP key", "password": true }
  ],
  "servers": {
    "gsc-wizard": {
      "type": "http",
      "url": "https://mcp.gscwizard.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gscw-key}"
      }
    }
  }
}

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json. O Windsurf usa serverUrl para servidores remotos:

{
  "mcpServers": {
    "gsc-wizard": {
      "serverUrl": "https://mcp.gscwizard.com/mcp",
      "headers": {
        "Authorization": "Bearer gscw_live_..."
      }
    }
  }
}

ChatGPT

Conectores personalizados precisam de ChatGPT Plus, Pro, Business, Enterprise ou Edu; não estão disponíveis nos planos Free ou Go. (O aplicativo GSC Wizard para ChatGPT é o caminho para esses planos: não requer modo de desenvolvedor. Uma assinatura ou teste do GSC Wizard se aplica de qualquer forma.) Servidores MCP personalizados ficam em Configurações → Apps (modo de desenvolvedor, antigamente "Conectores"). Ative o modo de desenvolvedor, adicione um aplicativo e insira https://mcp.gscwizard.com/mcp como URL do servidor. O ChatGPT usa OAuth 2.1: ele se registra, então abre a tela de login e consentimento do GSC Wizard. Deixe os campos de client ID/secret OAuth em branco (o servidor suporta registro dinâmico de clientes). Não há campo de chave de API, o que é esperado: o ChatGPT não pode apresentar tokens bearer estáticos, então usa OAuth.

ChatGPT New App dialog in developer mode with the GSC Wizard MCP URL as the Server URL and Authentication set to OAuth

Novo aplicativo (modo de desenvolvedor): URL do servidor + Autenticação "OAuth"; client ID/secret deixados em branco.

Acesso programático também funciona através da Responses API da OpenAI, que aceita uma ferramenta MCP remota com um objeto headers, então lá você pode passar Authorization: Bearer gscw_live_... diretamente. Note que os conectores Deep Research integrados do ChatGPT chamam apenas ferramentas search e fetch; acesso completo a ferramentas é via aplicativos em modo de desenvolvedor e a Responses API.

Qualquer outro cliente MCP

Aponte para o endpoint HTTP Streamable e envie sua chave como um token bearer:

URL:    https://mcp.gscwizard.com/mcp
Header: Authorization: Bearer gscw_live_...

Os nomes das chaves variam entre clientes (por exemplo, transport vs type, url vs serverUrl), mas a URL e o cabeçalho bearer permanecem os mesmos. Verifique a documentação MCP do seu cliente se as chaves acima não forem reconhecidas.

Autenticação e escopos

Cada chave de API carrega um escopo, escolhido na criação:

  • Somente leitura: consultar dados e executar relatórios. Não pode adicionar, editar ou excluir nada.
  • Leitura e escrita: tudo que as chaves de leitura podem fazer, mais mutações (adicionar sites, enviar IndexNow, gerenciar clusters e assim por diante). Cada mutação é registrada em log de auditoria.

As ferramentas MCP exigem uma assinatura ativa ou um teste gratuito em andamento. Criar novas chaves de API exige o mesmo; chaves existentes podem sempre ser revogadas na página de chaves de API, onde a revogação tem efeito imediato.

Limites de taxa

Chamadas de ferramentas são limitadas por conta para proteger sua cota do Search Console e manter o serviço responsivo. Duas janelas se aplicam ao mesmo tempo, e uma chamada deve caber em ambas. Os transportes MCP (assistentes como Claude e ChatGPT) e a API REST têm cada um seu próprio orçamento, então um painel atualizando via REST não pode bloquear sua sessão de assistente:

JanelaMCP (assistentes)API REST (/v1)
Por minuto60 chamadas de ferramentas180 chamadas de ferramentas
Por hora1.000 chamadas de ferramentas2.000 chamadas de ferramentas

A janela de minuto REST é a mais ampla das duas porque o tráfego REST é intermitente por construção: um painel do Data Studio atualiza cada gráfico independentemente e concorrentemente, então uma página chega como um pico e depois fica quieta. A janela de hora é o que ainda limita a carga sustentada.

Dentro de uma superfície, o limite é compartilhado entre todas as chaves e sessões da sua conta, então abrir mais sessões não o aumenta. Apenas invocações de ferramentas (tools/call) contam: handshakes de protocolo como initialize e tools/list são gratuitos, e uma solicitação em lote que invoca várias ferramentas conta como uma chamada por ferramenta. Algumas ferramentas caras contam como mais de uma chamada cada.

Quando você excede uma janela via REST, o servidor retorna HTTP 429 com um cabeçalho Retry-After dando os segundos até a janela resetar, e um corpo JSON: { "error": { "code": "rate_limited", "message": "Rate limit exceeded (minute window). Retry after 42s." } }. Pause por Retry-After segundos e tente novamente. Via MCP, a mesma condição retorna como um erro de ferramenta carregando essa mensagem, que a maioria dos clientes apresenta como um erro transitório que você pode simplesmente reexecutar.

Esses limites são separados das cotas do próprio Google. Ferramentas de Inspeção de URL (inspect_url, bulk_inspect_urls, check_tracked_url_now) também usam a cota diária de ~2.000 inspeções por propriedade que você compartilha com a interface do GSC Wizard.

Ferramentas

O servidor expõe 126 ferramentas. Normalmente você apenas pede ao seu assistente em linguagem natural ("mostre minhas principais consultas do mês passado para example.com") e ele escolhe a ferramenta certa e preenche os argumentos. O JSON sob cada ferramenta abaixo mostra a forma dos argumentos, para que você veja o que cada uma aceita. Datas usam YYYY-MM-DD e são opcionais em toda ferramenta que aceita um intervalo de datas: omita startDate / endDate e o servidor usa a janela mais recente já consolidada automaticamente (nunca passe null ou a string "null"). siteUrl é um valor retornado por list_sites (um prefixo de URL como https://example.com/ ou uma propriedade de domínio como sc-domain:example.com).

Intervalos de datas são opcionais. Toda ferramenta que aceita um intervalo de datas trata startDate e endDate como opcionais: omita-os e o servidor analisa os últimos 28 dias que o Search Console consolidou (seus dados têm atraso de ~2-3 dias). Passe uma extremidade ou ambas para estreitar a janela; as ferramentas de comparação (get_ranking_changes, find_decaying_content) definem a linha de base como o período de mesma duração imediatamente anterior ao atual. Você nunca precisa saber a data de hoje, e nunca deve enviar null ou a string "null" para uma data.

De onde vêm os números. As ferramentas de análise de pesquisa (query_search_analytics, query_top_queries, query_top_pages, query_countries, query_devices, get_site_summary, get_query_performance, get_page_performance) e as ferramentas de relatórios de análise (get_ranking_changes, find_decaying_content, get_decay_overview, analyze_cannibalization, analyze_ctr_curve, find_page_poaching_opportunities, score_opportunities, breakdown_by_path, analyze_sampling_impact, get_sitemap_performance, get_cross_site_summary, get_tag_group_view) leem do data warehouse do GSC Wizard quando têm sua propriedade: isso dá histórico mais longo e sem amostragem do Search Console. Caso contrário, elas recorrem automaticamente à API ao vivo do Search Console. Cada resposta inclui um campo dataSource definido como clickhouse ou api para que você sempre saiba qual respondeu. Respostas do warehouse também incluem uma data settledThrough e uma nota de frescor: os dados do warehouse consolidam ~2 dias atrás do tempo real, então para o dia ou dois mais recentes, a API ao vivo é a melhor fonte. Solicitações que precisam da dimensão searchAppearance, do tipo googleNews, de três ou mais dimensões distintas, ou paginação sempre usam a API ao vivo. Maturidade da fonte. As oito ferramentas de dados analíticos de pesquisa (query_search_analytics, query_top_queries, query_top_pages, query_countries, query_devices, get_site_summary, get_query_performance, get_page_performance) retornam um bloco dataMaturity tanto no caminho do warehouse quanto no da API ao vivo, e toda resposta carrega um settledThrough de nível superior. O Search Console não possui um campo nativo de data de liquidação, então o servidor executa uma pequena sondagem agrupada por data com dataState: "all" nos últimos dez dias, mantém o metadata.firstIncompleteDate bruto da API e deriva settledThrough como o dia calendário imediatamente anterior. Ambas as datas estão na própria base do Search Console, horário do Pacífico (dateBasis: "America/Los_Angeles"); probe registra a solicitação exata para que o limite possa ser reproduzido. A consulta falha de forma segura: quando a API não retorna um firstIncompleteDate utilizável, ambas as datas são null e source é "unavailable" com um note. Nunca infira uma data de liquidação a partir da última linha retornada, pois dias sem atividade são omitidos dos dados de linha. Nas respostas do warehouse, settledThrough é o menor entre o corte de ingestão (dataMaturity.warehouseCutoff) e o limite da API. As ferramentas de relatório GA4 (get_ga4_overview, query_ga4_report, get_ga4_ecommerce, get_ga4_key_events, get_ga4_llm_traffic, get_ga4_error_pages, query_ga4_custom_dimensions) retornam o fuso de relatório IANA da propriedade como timeZone, obtido dos metadados de resposta da Data API (com fallback para o registro da propriedade na Admin API), que é a base de cada data GA4 que retornam. Tudo isso usa os escopos somente leitura existentes webmasters.readonly e analytics.readonly.

Unidades de métricas. Todo campo ctr retornado por qualquer ferramenta é uma porcentagem de 0 a 100 (uma taxa de cliques de 2,34% é 2.34, não 0.0234) — o mesmo no caminho do warehouse, no caminho ao vivo do Search Console e nas ferramentas Bing. Diferenças entre duas taxas de cliques (ctrPoints, ctrDelta, o mapa deltas em analyze_ctr_curve) são em pontos percentuais. position é uma média ponderada por impressões onde menor é melhor. As métricas de taxa do GA4 são a exceção e mantêm as unidades próprias da Data API: bounceRate e engagementRate são frações de 0 a 1.

Bing Webmaster Tools. As ferramentas list_bing_sites e get_bing_* leem o lado Bing da pesquisa orgânica (Bing, Yahoo, DuckDuckGo) ao vivo da Bing Webmaster API. Elas usam a chave da Bing Webmaster API armazenada na conta Google conectada da propriedade no GSC Wizard, então não precisam de conexão separada aqui: se nenhuma chave estiver configurada, a ferramenta retorna notConfigured: true com uma dica em vez de um erro. O Bing expõe aproximadamente os últimos 6 meses por endpoint, então omitir o intervalo de datas retorna tudo o que o Bing tem (não um padrão de janela liquidada como nas ferramentas do Search Console).

Yandex Webmaster. As ferramentas list_yandex_sites e get_yandex_* leem o lado Yandex da pesquisa orgânica ao vivo da Yandex Webmaster API, o que importa principalmente para tráfego russo, turco, cazaque, bielorrusso e uzbeque. Elas usam a conexão Yandex na conta GSC Wizard do proprietário da propriedade, então não precisam de conexão separada aqui: com nada conectado, a ferramenta retorna notConfigured: true com uma dica em vez de um erro. Dois limites valem a pena conhecer antes de citar um número. O Yandex publica apenas suas 3.000 principais consultas da última semana e serve no máximo 500 por solicitação, então qualquer total que você derivar das linhas de consulta é um piso, não um valor completo; e o Yandex não tem relatório de consulta por página, nem dimensão de país e nem métrica de CTR, então o CTR é calculado a partir de impressões e cliques. As posições do Yandex são medidas de forma diferente das do Google e não devem ser calculadas em média junto com elas.

Leituras 94

list_sites leitura

Lista as propriedades do Search Console conectadas à conta.

{}

Sem argumentos. Comece aqui para obter os valores de siteUrl que as outras ferramentas esperam. Cada propriedade carrega um sinalizador <code>permissionLevel</code> e um <code>readable</code>; <code>readable: false</code> significa que a propriedade está listada no Search Console, mas não verificada, então o Google recusa todos os dados dela até que o usuário a verifique.

get_account_info leitura

Perfil, contas Google conectadas e estado da assinatura.

{}

Sem argumentos.

generate_seo_report leitura

Executa toda a suíte de análise para uma propriedade em uma única chamada e retorna um relatório HTML completo e autônomo (visão geral, principais consultas/páginas, países e dispositivos, curva de CTR, oportunidades, mudanças de classificação, declínio, canibalização, seções, cobertura, sitemaps). Muito mais rápido do que chamar cada ferramenta separadamente.

{
  "siteUrl": "sc-domain:example.com",
  "days": 28,
  "format": "html"
}

days tem como padrão 28 (7-180). format: "html" (padrão, relatório pronto para abrir) ou "json" (pacote de dados brutos). includeSitemap tem como padrão true.

query_search_analytics leitura

Consulta ad-hoc searchAnalytics.query contra uma propriedade. A ferramenta de leitura mais flexível.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "dimensions": [
    "query",
    "page"
  ],
  "rowLimit": 1000,
  "filters": [
    {
      "dimension": "country",
      "operator": "equals",
      "expression": "usa"
    }
  ]
}

startDate/endDate, dimensions, rowLimit (padrão 1000, sem limite; o caminho da API ao vivo pagina automaticamente além de 25000), searchType, startRow e filters são todos opcionais. Omita as datas para os últimos 28 dias liquidados.

get_site_summary leitura

Totais para uma janela mais uma comparação com o período anterior.

{
  "siteUrl": "sc-domain:example.com",
  "days": 28
}

days tem como padrão 28 (máx. 180) e conta de trás para frente a partir da data liquidada mais recente. Passe startDate e/ou endDate para uma janela explícita: uma data fornecida por você sempre vence, e days apenas dimensiona uma borda que você deixar de fora. A comparação é sempre a janela de mesmo comprimento imediatamente anterior à que você pediu.

inspect_url leitura

Executa a URL Inspection API para uma URL e persiste o resultado no histórico.

{
  "siteUrl": "sc-domain:example.com",
  "inspectionUrl": "https://example.com/blog/post"
}

get_inspection_quota leitura

Inspeções de URL restantes disponíveis hoje para uma propriedade.

{
  "siteUrl": "sc-domain:example.com"
}

list_saved_filters leitura

Presets de filtro salvos, opcionalmente restritos a uma propriedade.

{
  "siteUrl": "sc-domain:example.com"
}

siteUrl é opcional; omita para listar todos os filtros salvos na conta.

list_topic_clusters leitura

Clusters de tópicos definidos para uma propriedade.

{
  "siteUrl": "sc-domain:example.com"
}

list_content_groups leitura

Grupos de conteúdo e suas regras de correspondência de URL para uma propriedade.

{
  "siteUrl": "sc-domain:example.com"
}

get_filter_options leitura

Quais filtros de marca, grupo de conteúdo e cluster de tópicos as ferramentas de relatório aceitam em uma propriedade.

{
  "siteUrl": "sc-domain:example.com"
}

Passe os resultados para get_site_summary, query_top_queries, query_top_pages, query_countries ou query_devices como brand, contentGroupId ou topicClusterId.

list_sitemaps leitura

Sitemaps enviados ao Search Console para uma propriedade.

{
  "siteUrl": "sc-domain:example.com"
}

list_url_inspections leitura

Histórico de inspeção de URL persistido (paginado).

{
  "siteUrl": "sc-domain:example.com",
  "urlContains": "/blog/",
  "limit": 100,
  "offset": 0
}

urlContains é opcional; limit tem como padrão 100 (máx. 500). O histórico não tem limite: siga pagination.nextOffset para recuperar cada inspeção armazenada, por exemplo, uma execução em massa de várias centenas de URLs. Defina latestPerUrl: true para manter apenas o resultado mais recente por URL.

query_top_queries leitura

Principais consultas de pesquisa por cliques para um intervalo de datas.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

limit tem como padrão 100, sem limite (puxe a propriedade inteira se quiser); searchType tem como padrão "web". startDate/endDate são opcionais: omita para os últimos 28 dias liquidados.

query_top_pages leitura

Principais páginas de destino por cliques para um intervalo de datas.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

limit tem como padrão 100, sem limite (puxe a propriedade inteira se quiser); searchType tem como padrão "web". startDate/endDate são opcionais: omita para os últimos 28 dias liquidados.

query_countries leitura

Detalhamento de cliques/impressões por país.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

limit tem como padrão 100, sem limite. startDate/endDate são opcionais: omita para os últimos 28 dias liquidados.

query_devices leitura

Divisão DESKTOP / MOBILE / TABLET para um intervalo de datas.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

startDate/endDate são opcionais: omita para os últimos 28 dias liquidados.

list_annotations leitura

Anotações de gráfico (escopo de plataforma, conta ou propriedade).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-05-28"
}

Todos os campos opcionais; omita siteUrl para anotações em toda a conta.

list_algo_updates leitura

Atualizações confirmadas de classificação do Google a partir do feed de status.

{
  "startDate": "2026-01-01",
  "endDate": "2026-05-28"
}

Ambas as datas opcionais; omita para o histórico completo.

list_indexnow_submissions leitura

Histórico de envios IndexNow para uma propriedade.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 100
}

limit tem como padrão 100 (máx. 500). Lotes que foram recusados antes do envio (um arquivo de chave ausente) estão deliberadamente ausentes: eles nunca foram enviados.

get_page_performance leitura

Cliques/impressões/CTR/posição diários para uma única URL.

{
  "siteUrl": "sc-domain:example.com",
  "pageUrl": "https://example.com/blog/post",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

get_query_performance leitura

Métricas diárias para uma única consulta, opcionalmente em uma URL.

{
  "siteUrl": "sc-domain:example.com",
  "query": "seo tools",
  "pageUrl": "https://example.com/blog/post",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

pageUrl é opcional; omita para medir a consulta em todo o site.

get_ranking_changes leitura

Consultas novas, perdidas, melhoradas e em declínio (ou páginas) entre dois períodos.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "comparisonStartDate": "2026-04-01",
  "comparisonEndDate": "2026-04-28",
  "dimension": "query",
  "limit": 50
}

dimension é "query" ou "page" (padrão query); limit é por bucket, padrão 50, máx. 10000. counts fornece o tamanho completo de cada bucket antes do limite, medido dentro das linhas de scanLimit principais por cliques por período.

find_decaying_content leitura

Consultas ou páginas perdendo cliques em relação a um período de referência, agrupadas em severo / moderado / leve.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "comparisonStartDate": "2026-02-01",
  "comparisonEndDate": "2026-02-28",
  "dimension": "page",
  "minImpressions": 100
}

start/end é o período recente; comparison* é a referência anterior. dimension tem como padrão "page".

get_decay_overview leitura

Matriz por consulta ou por página de cliques/impressões/posição dividida por mês ou semana (o heatmap de Query Decay / Content Decay do aplicativo).

{
  "siteUrl": "sc-domain:example.com",
  "dimension": "query",
  "granularity": "month",
  "metric": "clicks",
  "months": 16,
  "limit": 50
}

Padrão para os últimos 16 meses completos. granularity "month" ou "week"; metric clicks/impressions/position/ctr. Cada linha tem um array values\ alinhado a periods\. Passe startDate/endDate para substituir a janela.

analyze_cannibalization leitura

Consultas onde duas ou mais páginas competem, pontuadas por entropia de divisão de impressões.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "minImpressions": 10
}

minImpressions tem como padrão 10; limit tem como padrão 100, sem limite.

analyze_ctr_curve leitura

CTR real por faixa de posição (1-20) versus benchmarks do setor (AWR, estudo AWR 2026 com e sem AI Overviews, First Page Sage, Sistrix, Backlinko).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "minImpressions": 10,
  "benchmarkSource": "all"
}

benchmarkSource: awr | awr2026 | awrAio | firstPageSage | sistrix | backlinko | all (padrão all). awr2026 e awrAio são o estudo de 2026 da Advanced Web Ranking, orgânico versus SERPs com AI Overview; a lacuna entre eles é o imposto de cliques do AI Overview. Os valores de CTR são porcentagens (0-100) e os deltas são pontos percentuais; um delta negativo significa que a faixa está abaixo desse benchmark.

find_page_poaching_opportunities leitura

Consultas classificadas logo fora do topo, com upside de cliques estimado se empurradas para uma posição alvo.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "minPosition": 4,
  "maxPosition": 20,
  "targetPosition": 3,
  "fallbackBenchmark": "awr"
}

O upside de cliques usa a curva de CTR PRÓPRIA da propriedade em targetPosition; fallbackBenchmark (awr | awr2026 | awrAio | firstPageSage | sistrix | backlinko, padrão awr) é usado apenas onde o site não tem dados. A resposta relata targetCtr e ctrSource ("own" ou a chave do benchmark). A faixa de posição e o alvo são ajustáveis; limit tem como padrão 100, sem limite.

score_opportunities leitura

Pontuação de oportunidade ponderada por impressões favorecendo consultas de alta impressão perto do topo da segunda página.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "minImpressions": 10
}

Considera posições 3-30; limit tem como padrão 100, sem limite.

breakdown_by_path leitura

Agrega o desempenho da página por host + primeiro(s) segmento(s) de caminho.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "depth": 1
}

depth (1-4) controla quantos segmentos de caminho formam cada grupo; limit tem como padrão 100, sem limite.

analyze_sampling_impact leitura

Estima a parcela de cliques/impressões que o GSC oculta via anonimização (dimensões de consulta e página).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

Apenas o caminho da API ao vivo revela a amostragem real; o warehouse não é amostrado (veja a nota na resposta).

get_sitemap_performance leitura

Busca um sitemap, extrai suas URLs e junta cada uma com cliques/impressões/posição do GSC.

{
  "siteUrl": "sc-domain:example.com",
  "sitemapUrl": "https://example.com/sitemap.xml",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "maxUrls": 500
}

O host do sitemap deve pertencer à propriedade. Um nível de expansão de índice de sitemap; maxUrls limita a junção (padrão 500, sem limite).

get_cross_site_summary leitura

Cliques/impressões dos últimos N dias em todas as suas propriedades (opcionalmente uma tag), com totais por site.

{
  "days": 28,
  "tag": "client-a"
}

tag é opcional; days assume 28 por padrão (máx. 180); maxSites é opcional sem limite rígido: omita para incluir TODAS as propriedades correspondentes, ou passe um número para limitar quantas são processadas.

list_tags leitura

Cada tag na conta (tags globais + por propriedade) com o número de propriedades que possuem cada uma.

{
  "includeSites": false
}

includeSites assume false por padrão; defina true para também listar as URLs das propriedades sob cada tag.

get_tag_group_view leitura

Relatório agregado entre sites para todas as propriedades que possuem uma tag (o dashboard /group/tag): totais + comparação, tendência diária, totais por site e principais consultas/páginas/países/dispositivos mesclados.

{
  "tag": "client-a",
  "days": 28,
  "dimensions": [
    "query",
    "page",
    "country",
    "device"
  ],
  "limit": 100
}

days assume 28 por padrão (máx. 180); searchType assume "web" por padrão; dimensions assume as quatro por padrão; limit assume 100 por padrão (máx. 1000); maxSites é opcional sem limite rígido: omita para incluir TODAS as propriedades com tag, ou passe um número para limitar.

get_indexing_tracker leitura

Configuração do Indexing Tracker e um resumo de status (indexado / não indexado / pendente / erros / avisos).

{
  "siteUrl": "sc-domain:example.com"
}

Retorna tracker: null quando nenhum tracker está configurado para a propriedade.

list_tracked_urls leitura

Lista paginada de URLs rastreadas com seu status de indexação mais recente, filtrável e pesquisável.

{
  "siteUrl": "sc-domain:example.com",
  "filter": "warnings",
  "search": "/blog/",
  "page": 1,
  "pageSize": 50
}

filter: all | indexed | not_indexed | pending | errors | warnings. pageSize máx. 1000 (padrão 50); page é baseada em um.

get_indexing_tracker_report leitura

Relatório de saúde de indexação: pontuação, detalhamento de cobertura, frescor de rastreamento, páginas perdidas e recém-indexadas.

{
  "siteUrl": "sc-domain:example.com",
  "days": 30
}

days assume 30 por padrão (máx. 90).

list_ga4_properties leitura

Cada propriedade do Google Analytics 4 que suas contas Google conectadas podem ler, e a quais sites do GSC Wizard cada uma está vinculada.

{}

Sem argumentos. connected: false significa que o consentimento do Google Analytics ainda não foi concedido no aplicativo GSC Wizard. linkedSiteUrls cobre apenas os sites da conta do GSC Wizard na qual a conexão está autenticada (retornada como account), então uma propriedade vinculada de outra conta sua mostra uma lista vazia.

get_ga4_overview leitura

Resumo de tráfego GA4 (sessões, usuários, taxa de engajamento, eventos-chave e mais) para a propriedade GA4 vinculada a um site, sempre com comparação com o período anterior.

{
  "siteUrl": "sc-domain:example.com",
  "includeTimeseries": false
}

O GA4 deve estar vinculado ao site no aplicativo GSC Wizard; caso contrário, uma explicação notConfigured é retornada, indicando em account qual conta do GSC Wizard foi usada para resolver (os vínculos são por conta). Datas e a janela de comparação são opcionais; includeTimeseries adiciona pontos diários.

query_ga4_report leitura

Um detalhamento por dimensão GA4 por chamada: channel, sourceMedium, page, landingPage, country, device ou event, cada um com seu próprio conjunto de métricas.

{
  "siteUrl": "sc-domain:example.com",
  "dimension": "landingPage",
  "limit": 25
}

O GA4 deve estar vinculado ao site no aplicativo GSC Wizard. filters e um intervalo de comparação são opcionais; limit assume 50 por padrão (máx. 1000).

get_ga4_ecommerce leitura

Desempenho de ecommerce GA4: resumo de receita/transações além de detalhamentos por canal, fonte, página, página de destino e produto.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 25
}

O GA4 deve estar vinculado ao site no aplicativo GSC Wizard. hasEcommerce é false quando a propriedade não mostra atividade de ecommerce; a receita está na moeda da propriedade (currencyCode).

get_ga4_llm_traffic leitura

Sessões, engajamento, conversões e receita referidas por ChatGPT, Perplexity, Copilot, Gemini, Claude e outros assistentes de IA, com sua participação no tráfego total.

{
  "siteUrl": "sc-domain:example.com",
  "includeDailySplit": false,
  "limit": 25
}

O GA4 deve estar vinculado ao site no aplicativo GSC Wizard. O tráfego do Google AI Overviews não possui referenciador distinto e NÃO está incluído. includeDailySplit adiciona uma série diária de sessões por assistente.

get_ga4_key_events leitura

Segmenta o GA4 em UM evento-chave (conversão): totais, taxas de conversão e detalhamentos por canal/fonte/página de destino/página/país/dispositivo.

{
  "siteUrl": "sc-domain:example.com",
  "keyEvent": "form_submit",
  "limit": 25
}

O GA4 deve estar vinculado ao site no aplicativo GSC Wizard. Omita keyEvent para selecionar automaticamente o mais ativo; a resposta lista todos os nomes de eventos-chave disponíveis.

list_ga4_custom_dimensions leitura

As dimensões personalizadas e métricas personalizadas registradas na propriedade GA4 do site: os parâmetros de evento e propriedades de usuário que ela coleta além dos campos padrão do GA4.

{
  "siteUrl": "sc-domain:example.com"
}

O GA4 deve estar vinculado ao site no aplicativo GSC Wizard. Cada entrada traz o apiName (ex.: customEvent:source_format) que query_ga4_custom_dimensions aceita. Um parâmetro de evento não registrado em GA4 Admin > Custom definitions não pode ser relatado de forma alguma, então chame isso antes de adivinhar um nome. Definições com escopo de item são listadas com queryable: false.

query_ga4_custom_dimensions leitura

Divide o tráfego GA4 por uma de suas próprias dimensões personalizadas registradas, opcionalmente cruzada com uma segunda: qual valor de parâmetro levou a qual.

{
  "siteUrl": "sc-domain:example.com",
  "dimension": "customEvent:source_path",
  "secondaryDimension": "customEvent:target_path",
  "filters": {
    "event": [
      "internal_link_click"
    ]
  },
  "limit": 50
}

O GA4 deve estar vinculado ao site no aplicativo GSC Wizard. Os nomes vêm de list_ga4_custom_dimensions; um não registrado é rejeitado em vez de respondido com um relatório vazio. As linhas trazem key (valor primário), secondary (o valor cruzado) e eventCount / sessions / activeUsers / keyEvents. valueFilters aprofunda em um valor; customMetrics adiciona métricas personalizadas registradas como colunas.

get_blended_landing_pages leitura

Une o Search Console (cliques, impressões, CTR, posição) com o GA4 (sessões, taxa de rejeição, eventos-chave, receita) por página de destino.

{
  "siteUrl": "sc-domain:example.com",
  "organicOnly": true,
  "limit": 50,
  "dateGranularity": "none"
}

O GA4 deve estar vinculado ao site no aplicativo GSC Wizard. organicOnly (padrão true) limita as métricas do GA4 a sessões google / organic para que ambos os lados descrevam o mesmo tráfego. dateGranularity ("day" / "week" / "month") retorna uma série temporal em vez de um agregado: cada linha traz o início do período como date, limit se aplica por período, e os campos prev* comparam cada período com o anterior (portanto, não pode ser combinado com um intervalo de comparação explícito).

get_query_value_attribution leitura

Estima sessões GA4, eventos-chave e receita por consulta do Search Console via participação proporcional de cliques na junção consulta→página→página de destino.

{
  "siteUrl": "sc-domain:example.com",
  "organicOnly": true,
  "limit": 1000,
  "dateGranularity": "none"
}

O GA4 deve estar vinculado ao site no aplicativo GSC Wizard. Estimativas, não receita medida: atribuição por participação de cliques no nível da página; matchedClickShare relata cobertura; estRevenue apenas quando a propriedade GA4 registra receita. dateGranularity ("day" / "week" / "month") retorna uma série temporal em vez de um agregado — a forma de gráfico de receita estimada de consultas sem marca mês a mês — com cada linha trazendo o início do período como date e limit se aplicando por período.

list_bing_sites leitura

Lista os sites verificados na sua conta vinculada do Bing Webmaster Tools.

{}

Sem argumentos. Retorna notConfigured: true quando nenhuma chave de API do Bing Webmaster está configurada no aplicativo GSC Wizard.

get_bing_traffic_stats leitura

Cliques e impressões diários do Bing para uma propriedade (aproximadamente os últimos 6 meses).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

startDate/endDate opcionais; omita ambos para tudo que o Bing tem (~6 meses).

get_bing_query_stats leitura

Principais consultas de pesquisa do Bing para uma propriedade (cliques, impressões, CTR, posição).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

Datas opcionais (omita para ~6 meses); limit assume 100 por padrão, sem limite máximo.

get_bing_page_stats leitura

Principais páginas de destino do Bing para uma propriedade (cliques, impressões, CTR, posição).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

Datas opcionais (omita para ~6 meses); limit assume 100 por padrão, sem limite máximo.

get_bing_query_page_stats leitura

Pares de consulta + página de destino do Bing para uma propriedade (qual consulta direciona cada página).

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100,
  "seedLimit": 25
}

Datas opcionais (omita para ~6 meses); limit assume 100 por padrão, sem limite máximo. O Bing não tem endpoint que retorne combinações de consulta + página, então os pares são montados com uma solicitação por página principal — seedLimit (padrão 25, máx. 100) define quantas páginas são expandidas, e truncated: true significa que o Bing tinha mais. Passe query para parear a partir de um único termo de pesquisa (as páginas que ranquearam para ele).

get_bing_page_queries leitura

As consultas de pesquisa do Bing que levaram a UMA página de destino — a visão de palavras-chave por página, e o aprofundamento após get_bing_page_stats.

{
  "siteUrl": "sc-domain:example.com",
  "page": "https://example.com/blog/post/",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28",
  "limit": 100
}

page é obrigatória e deve corresponder exatamente ao Bing (URL completa, incluindo esquema, www e barra final) — pegue-a de get_bing_page_stats. Datas opcionais; limit assume 100 por padrão.

get_bing_query_page_trend leitura

Cliques, impressões, CTR e posição média diários para UM par exato de consulta + página de destino no Bing.

{
  "siteUrl": "sc-domain:example.com",
  "query": "example query",
  "page": "https://example.com/blog/post/",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

query e page são ambas obrigatórias e devem corresponder exatamente ao Bing — pegue o par literalmente de get_bing_query_page_stats ou get_bing_page_queries. O único endpoint do Bing com posição verdadeira no nível do par. Datas opcionais (omita para ~6 meses).

get_bing_crawl_stats leitura

Estatísticas diárias de rastreamento do Bing: páginas rastreadas/indexadas, links de entrada e detalhamento por código de resposta.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

startDate/endDate opcionais; omita ambos para tudo que o Bing tem (~6 meses).

get_bing_crawl_issues leitura

URLs onde o Bing encontrou problemas de rastreamento (4xx/5xx, redirecionamentos, bloqueios de robots, malware), com rótulos decodificados.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 200
}

limit assume 200 por padrão, sem limite máximo; os resultados são ordenados por contagem de links de entrada.

get_bing_link_counts leitura

Contagens de links de entrada (backlinks) por URL registradas pelo Bing, paginadas (~100 linhas por página).

{
  "siteUrl": "sc-domain:example.com",
  "page": 0
}

page assume 0 por padrão; a resposta inclui totalPages para que você possa paginar.

get_bing_keyword_stats leitura

Volume histórico de impressões do Bing para uma única palavra-chave (semanal), além de impressões de correspondência ampla.

{
  "keyword": "seo tools",
  "country": "us",
  "language": "en-US"
}

Dados de demanda de mercado, não vinculados a uma propriedade (sem siteUrl). country assume "us" por padrão, language assume "en-US".

get_bing_feeds leitura

Sitemaps/feeds enviados ao Bing para uma propriedade, com status, tipo, datas e contagens de URL decodificados.

{
  "siteUrl": "sc-domain:example.com"
}

get_bing_url_submission_quota leitura

Cota restante de envio de URL ao Bing (diária e mensal) para uma propriedade.

{
  "siteUrl": "sc-domain:example.com"
}

list_yandex_sites leitura

Lista os sites na sua conta vinculada do Yandex Webmaster, com status de verificação e espelho canônico.

{}

Sem argumentos. Retorna notConfigured: true quando nenhuma conta Yandex está conectada no aplicativo GSC Wizard.

get_yandex_site_summary leitura

Índice de qualidade do site (SQI) do Yandex, páginas na pesquisa, páginas excluídas e problemas abertos do site para uma propriedade.

{
  "siteUrl": "sc-domain:example.com"
}

get_yandex_query_stats leitura

Consultas de pesquisa do Yandex para uma propriedade (impressões, cliques, CTR derivado, posição média de impressão e de clique).

{
  "siteUrl": "sc-domain:example.com",
  "orderBy": "TOTAL_SHOWS",
  "deviceType": "ALL",
  "limit": 500
}

O Yandex expõe apenas suas 3.000 principais consultas da última semana (500 por solicitação), então os totais são um piso, não um número completo. O Yandex não publica métrica de CTR, então o CTR é derivado. Não há relatório de consulta por página na API do Yandex. MOBILE_AND_TABLET sobrepõe MOBILE e TABLET — nunca some-os.

get_yandex_indexing_history leitura

Códigos de resposta de rastreamento do Yandex por dia, páginas na pesquisa do Yandex e as páginas que apareceram ou foram removidas da pesquisa.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-05-01",
  "endDate": "2026-05-28"
}

Datas opcionais. A série de aparecidas/removidas não tem equivalente no Google Search Console.

detect_anomalies leitura

Sinaliza dias estatisticamente anômalos (picos/quedas) para uma métrica, pontuados por gravidade.

{
  "siteUrl": "sc-domain:example.com",
  "metric": "clicks",
  "days": 90,
  "sensitivity": 3.5
}

metric: clicks | impressions | ctr | position (padrão clicks). days >= 21 (padrão 90). Menor sensibilidade = mais anomalias.

detect_change_points leitura

Encontra datas onde cliques ou impressões mudaram para um novo nível sustentado (mudanças de degrau).

{
  "siteUrl": "sc-domain:example.com",
  "metric": "clicks",
  "days": 180,
  "sensitivity": 2
}

metric: clicks | impressions. days >= 14 (padrão 180). Relata médias antes/depois e variação percentual.

forecast_traffic leitura

Projeta cliques/impressões futuros via decomposição sazonal + uma linha de tendência selecionada automaticamente.

{
  "siteUrl": "sc-domain:example.com",
  "metric": "clicks",
  "granularity": "weekly",
  "forecastPeriods": 26
}

Semanal precisa de >= 13 semanas, mensal de >= 6 meses. growthRate, cvr + aov (para receita) e trendlineType opcionais.

get_longtail_clusters leitura

Segmenta páginas em camadas Head / Chunky Middle / Long Tail por detecção de cotovelo em cliques cumulativos.

{
  "siteUrl": "sc-domain:example.com",
  "preset": "default",
  "pagesPerCluster": 10
}

preset: default | content | ecommerce | small_site | enterprise. sensitivity e includeZeroClicks opcionais.

get_core_web_vitals leitura

Dados de campo do Chrome UX Report: Core Web Vitals semanais (LCP, INP, CLS) + FCP/TTFB com classificações e regressões, além das métricas experimentais de anúncios do Chrome onde o site exibe anúncios.

{
  "siteUrl": "sc-domain:example.com",
  "formFactor": "ALL"
}

Necessita de uma chave de API CrUX configurada no aplicativo. Passe um url\ para medir uma única página; formFactor: ALL | PHONE | DESKTOP | TABLET. adMetrics\ (contagem de anúncios/densidade/CPU/peso de rede) é apenas p75 e sem classificação — o CrUX não publica metas para isso — e está ausente quando o Chrome não detectou anúncios.

list_experiments leitura

Lista os experimentos de SEO (testes divididos) definidos para uma propriedade, com seus grupos de URLs.

{
  "siteUrl": "sc-domain:example.com",
  "includeArchived": false
}

get_experiment_results leitura

Pontua um experimento: crescimento de cliques controle vs variante com teste de significância, intervalo de confiança do uplift e vencedor.

{
  "siteUrl": "sc-domain:example.com",
  "experimentId": "00000000-0000-0000-0000-000000000000",
  "confidenceLevel": 0.95
}

O grupo 0 é o controle. A janela de comparação usa como padrão o período anterior de mesma duração.

compare_migration leitura

Comparação A-vs-B antes/depois para uma migração: tendência diária, totais por lado, vencedores e perdedores de consultas/páginas.

{
  "mode": "cross-property",
  "siteUrl": "sc-domain:old.com",
  "siteUrlB": "sc-domain:new.com",
  "limit": 50
}

modo: cross-property (siteUrl + siteUrlB) | two-urls (urlPrefixA + urlPrefixB) | regex (regexA + regexB). Ambos os lados compartilham uma única janela de datas.

audit_onpage_seo leitura

Rastreia páginas e executa uma auditoria técnica on-page por URL (indexabilidade, títulos, canônicos, links, dados estruturados, problemas).

{
  "siteUrl": "sc-domain:example.com",
  "maxUrls": 10
}

Passe um urls\ explícito (deve pertencer à propriedade) ou omita para auditar as principais páginas por impressões. Busca cada página ao vivo; mantenha a quantidade modesta.

get_content_group_performance leitura

Mede seus grupos de conteúdo salvos: cliques, impressões, CTR, posição média, contagem de páginas e participação de cliques por grupo, além de um bucket "não categorizado". Passe groupId para detalhar as principais páginas de um grupo.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31"
}

Os grupos são criados no aplicativo ou com create_content_group. No caminho do warehouse, os totais cobrem TODAS as páginas da propriedade, não apenas as principais N. A correspondência é primeira-ocorrência-vence na ordem salva dos grupos.

get_topic_cluster_performance leitura

Mede seus clusters de tópicos salvos por consultas: cliques, impressões, CTR, posição média, contagem de consultas correspondidas e participação de cliques por cluster, além de um bucket "não agrupado". Passe clusterId para detalhar as principais consultas de um cluster.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31"
}

Os clusters podem se SOBREPOR: uma consulta que corresponde a dois clusters conta integralmente em ambos, então os totais dos clusters não somam ao total da propriedade (overlappingQueries informa quantas são contadas em duplicidade).

get_branded_performance leitura

Divide uma propriedade em busca orgânica com e sem marca: totais, participação de cliques da marca, tendência diária para ambos os lados e as principais consultas de cada lado.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "limit": 25
}

Impulsionado pelas palavras-chave de marca salvas na propriedade (defina-as com update_site). Uma palavra-chave entre barras, como /acme?corp/, é uma regex; caso contrário, é uma substring sem diferenciar maiúsculas de minúsculas. Retorna notConfigured quando nenhuma está definida.

get_position_distribution leitura

Fatia uma propriedade por onde ela classifica, em faixas 1-3 / 4-10 / 11-20 / 21+: impressões e cliques por faixa ao longo do intervalo, ou a contagem de consultas distintas classificando em cada faixa dia a dia.

{
  "siteUrl": "sc-domain:example.com",
  "granularity": "period",
  "dimension": "query"
}

granularidade: "period" (padrão, totais do bucket) ou "daily" (consultas distintas por faixa por dia, sempre chaveadas por consulta). As posições são médias ponderadas por impressões, então uma linha fica em exatamente uma faixa.

get_ga4_error_pages leitura

Páginas de erro GA4 para a propriedade vinculada a um site, divididas por título E URL da página: sessões, visualizações de página, usuários ativos e taxa de rejeição.

{
  "siteUrl": "sc-domain:example.com",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31"
}

O GA4 não tem sinal nativo de 404, então as páginas de erro são correspondidas aos padrões de título de página salvos para o site no aplicativo. Passe titleFilters (ex.: [{ operator: "contains", value: "404" }]) para substituí-los em uma única chamada.

list_shared_reports leitura

Lista os relatórios compartilháveis salvos na sua conta, cada um com sua URL de visualização e os clientes atualmente com acesso concedido.

{
  "limit": 50
}

Use para encontrar um reportId para manage_report_access ou delete_shared_report, ou para auditar quem pode ver qual relatório.

list_report_clients leitura

Lista os contatos de clientes na sua conta: as pessoas que podem receber acesso a um relatório compartilhável.

{
  "limit": 100
}

Um cliente é um endereço de e-mail mais um nome opcional; eles entram com ele para visualizar relatórios compartilhados com eles.

list_migration_redirects leitura

Lista os mapeamentos de redirecionamento salvos (URL antiga para URL nova) por trás do fluxo de trabalho Migration Compare, agrupados pelo par de propriedades A/B e pelo rótulo a que pertencem.

{
  "summaryOnly": true
}

Filtre com label / siteUrlA / siteUrlB. summaryOnly retorna apenas as contagens por migração, que é a escolha certa em um mapeamento grande.

get_indexnow_settings leitura

Informa se o IndexNow está configurado para uma propriedade: se uma chave está configurada e se o arquivo de chave está realmente acessível no site.

{
  "siteUrl": "sc-domain:example.com"
}

Ambas as metades precisam ser verdadeiras antes que os mecanismos aceitem qualquer coisa. keyFileVerified é a verificação ao vivo: false significa que o arquivo está genuinamente ausente ou contém a chave errada, e keyFileUrl então nomeia o arquivo exato a publicar; null significa que a sondagem foi inconclusiva (um timeout ou uma regra de bot), o que não é uma falha. A chave completa nunca é retornada como campo, e keyFileUrl é omitida quando tudo já está verificado. Verifique aqui primeiro quando um envio falhar.

analyze_query_shapes leitura

Classifica consultas por formato para revelar impressões digitais de AI Overviews / AI Mode: respostas diretas, acompanhamentos pivot, perguntas conversacionais, sondas de rastreadores, estruturas de agentes.

{
  "siteUrl": "sc-domain:example.com",
  "examplesPerBucket": 10
}

Correspondência heurística de padrões em 27 idiomas; julga como uma consulta parece, não o que o pesquisador quis dizer. Passe buckets: ["reply_artefact","pivot_follow_up","conversational_question"] para apenas os formatos de conversação com IA.

get_query_shape_trend leitura

Cliques + impressões mensais (ou semanais) divididos em consultas com formato de IA vs convencionais, com a participação do formato de IA em cada métrica.

{
  "siteUrl": "sc-domain:example.com",
  "months": 12,
  "granularity": "month"
}

Responde "as consultas de AI Mode / AI Overviews estão crescendo neste site?". Padrão para os últimos 12 meses completos (máx. 16, retenção do GSC).

get_merchant_listings_performance leitura

Desempenho do Search Console para uma aparência de pesquisa (padrão MERCHANT_LISTINGS): o inventário de aparências, uma linha do tempo diária e as principais páginas de produto por trás dela.

{
  "siteUrl": "sc-domain:example.com",
  "appearance": "MERCHANT_LISTINGS",
  "limit": 25
}

Sempre API ao vivo do Search Console: a aparência de pesquisa nunca é armazenada em warehouse e não pode ser agrupada com outra dimensão, apenas filtrada. Conta resultados de produtos enriquecidos apenas na Pesquisa web, então não reconcilia com os números de listagens gratuitas do Merchant Center, que também cobrem a aba Shopping, Imagens, Lens, YouTube e Maps. Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de implantação, e não aparece em tools/list para outras contas.

list_gmc_accounts leitura

Cada conta do Google Merchant Center que suas contas Google conectadas podem ler, e a quais sites do GSC Wizard cada uma está vinculada.

{
  "siteUrl": "sc-domain:example.com"
}

siteUrl é opcional e apenas adiciona o linkedAccountId para aquela propriedade. connected: false significa que o consentimento do Merchant Center ainda não foi concedido no aplicativo GSC Wizard. isAdvanced: true marca um pai multicliente, que não pode ser relatado diretamente: vincule uma de suas subcontas. Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de implantação, e não aparece em tools/list para outras contas.

get_organic_shopping_performance leitura

Desempenho de produtos orgânicos (listagens gratuitas) da conta Merchant Center vinculada: cliques / impressões / conversões diárias mais as principais ofertas, agrupáveis por marca, categoria ou tipo de produto.

{
  "siteUrl": "sc-domain:example.com",
  "groupBy": "offer",
  "limit": 25
}

Cobre todas as superfícies gratuitas (aba Shopping, Pesquisa, Imagens, Lens, YouTube, Maps), então não reconcilia com os números de listagens de comerciantes apenas da Pesquisa web de get_merchant_listings_performance. Conversões precisam de uma fonte de conversão do Merchant Center. Orgânico exclui tráfego de afiliados do YouTube a partir de 1º de julho de 2026. Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de implantação, e não aparece em tools/list para outras contas.

get_product_listing_status leitura

Elegibilidade para listagens gratuitas e problemas de itens por produto, ordenados por potencial de cliques: quais produtos estão invisíveis nas listagens gratuitas e por quê.

{
  "siteUrl": "sc-domain:example.com",
  "onlyProblems": true,
  "limit": 25
}

clickPotentialRank 1 é o produto do qual o Google espera mais cliques, então um produto reprovado classificado em número baixo é o problema mais caro. topIssueResolution MERCHANT_ACTION precisa de uma correção no feed ou no site; PENDING_PROCESSING se resolve sozinho. Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de implantação, e não aparece em tools/list para outras contas.

get_gmc_competitors leitura

Visibilidade competitiva do Merchant Center para uma célula de país / categoria / fonte de tráfego: linhas diárias de concorrentes com um resumo por domínio, um agregado de janela por domínio (top_merchant), ou sua tendência de visibilidade contra o benchmark da categoria.

{
  "siteUrl": "sc-domain:example.com",
  "view": "competitor",
  "countryCode": "US",
  "categoryId": "166",
  "trafficSource": "ORGANIC",
  "limit": 50
}

countryCode e categoryId são ambos obrigatórios: a Merchant API responde uma célula por solicitação. relativeVisibility, adsOrganicRatio, pageOverlapRate, higherPositionRate e ambas as tendências são frações 0-1 (0.12 = 12%), não a porcentagem de CTR 0-100; as tendências são relativas ao início da janela. Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de implantação, e não aparece em tools/list para outras contas.

get_gmc_pricing_insights leitura

Competitividade de preços do Merchant Center e sugestões de preço de venda unidas por produto: seu preço contra o benchmark do mercado (priceGapFraction) e o preço sugerido pelo Google com a mudança prevista de impressões / cliques / conversões.

{
  "siteUrl": "sc-domain:example.com",
  "sort": "opportunity",
  "limit": 100
}

Ambas as visualizações são instantâneos sem data do catálogo atual; snapshotDate é o dia UTC da chamada. predicted*ChangeFraction, priceGapFraction e suggestedChangeFraction são frações 0-1 (0.12 = +12%), não a porcentagem de CTR 0-100. Benchmarks precisam de GTINs válidos e sugestões precisam de relatórios de conversão, então um resultado vazio geralmente significa "não elegível". Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de implantação, e não aparece em tools/list para outras contas.

get_gmc_best_sellers leitura

Ranking de mais vendidos do Google para um país do Merchant Center: principais clusters de produtos ou marcas por categoria com classificação, classificação anterior, demanda relativa e, para clusters, um sinal demandGap quando você não estoca um cluster classificado.

{
  "siteUrl": "sc-domain:example.com",
  "view": "product_cluster",
  "granularity": "WEEKLY",
  "countryCode": "US",
  "limit": 100
}

Omita reportDate para o relatório publicado mais recente (relatórios atrasam até duas semanas) e leia reportDate de volta; uma data WEEKLY deve ser uma segunda-feira, uma MONTHLY o dia 1º. inventoryStatus ignora o país do relatório, então demandGap é um sinal em toda a conta. Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de implantação, e não aparece em tools/list para outras contas.

get_feed_audit_results leitura

Resultados da auditoria de feed do Merchant Center: a execução mais recente (ou um runDate) com seu status, Feed Score (0-100, dividido em planos de feed e página), contagens de falhas por gravidade, contagens aplicável / reprovado / aprovado por verificação com taxas de aprovação, cobertura de rastreamento e o histórico de pontuação de execuções anteriores.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 100
}

coverage, passRate e failRate são frações 0-1 (0.12 = 12%), não a porcentagem de CTR 0-100. checkKey restringe a lista de verificações; as linhas de problemas por oferta por trás de checkKey ou gravidade vivem no warehouse ClickHouse que este servidor não pode ler, então essas chamadas respondem issuesAvailable: false e apontam para o relatório Feed Audit no aplicativo. run: null significa que nenhuma auditoria foi executada ainda. Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de implantação, e não aparece em tools/list para outras contas.

get_gmc_title_hygiene leitura

Higiene de título e descrição do catálogo Merchant Center vinculado: histogramas de comprimento de título e descrição, descrições ausentes, comprimento médio e mediano de título, grupos de títulos duplicados, ofertas repetindo uma palavra e as palavras de título mais frequentes com tokens de marca sinalizados.

{
  "siteUrl": "sc-domain:example.com",
  "limit": 2000,
  "topWords": 50
}

Um snapshot de catálogo sem intervalo de datas, calculado sobre os primeiros limit\ produtos da lista de produtos ativos (padrão 2000, máximo 5000); truncated: true significa que o catálogo tinha mais itens e o resumo descreve uma amostra. topWords[].share é uma fração de 0-1 das ofertas amostradas, não a porcentagem de ctr de 0-100; comprimentos estão em caracteres, títulos CJK incluídos (cjkNote). A diferença de título entre feed e página existe apenas no relatório do app. Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de teste, e não aparece em tools/list para outras contas.

Mutações 32

Requerem uma chave de leitura e escrita. Todas as mutações são registradas em um log de auditoria somente anexação.

add_site write

Registra uma propriedade GSC no GSC Wizard. A propriedade já deve existir na sua conta do Search Console.

{
  "siteUrl": "sc-domain:example.com",
  "tags": [
    "client-a"
  ]
}

tags são opcionais.

create_gsc_property write

Cria novas propriedades de prefixo de URL no Google Search Console (ex.: propriedades de nível de pasta) e as registra no GSC Wizard. Verificação automática se o domínio pai for de sua propriedade. Use add_site para propriedades que já existem no GSC.

{
  "parentSiteUrl": "sc-domain:example.com",
  "propertyUrls": [
    "https://example.com/blog/",
    "https://example.com/docs/"
  ]
}

parentSiteUrl deve ser uma propriedade registrada existente cuja conta do Google seja dona do domínio. register tem padrão true; até 50 URLs.

update_site write

Edita tags, palavras-chave de marca, URLs de sitemap ou a taxa de rastreamento em uma propriedade registrada.

{
  "siteUrl": "sc-domain:example.com",
  "tags": [
    "client-a",
    "priority"
  ],
  "brandedKeywords": [
    "example",
    "example brand"
  ],
  "sitemapUrls": [
    "https://example.com/sitemap.xml"
  ],
  "crawlMaxConcurrency": 2,
  "crawlMinDelayMs": 1000
}

Passe apenas os campos que deseja alterar. crawlMaxConcurrency (1-10) e crawlMinDelayMs (0-60000) limitam a velocidade com que o GSC Wizard rastreia este site na auditoria on-page, no rastreador de links e na auditoria de feed; reduza-os se o site responder 429. Passe null para qualquer um deles para voltar ao padrão do app. O atraso mínimo combina com o Crawl-delay do robots.txt, prevalecendo o maior.

manage_tags write

Cria, atribui, desatribui, renomeia ou exclui tags de propriedade em toda a conta (o lado de tags do painel /group/tag).

{
  "action": "assign",
  "tag": "client-a",
  "siteUrls": [
    "sc-domain:example.com",
    "https://example.org/"
  ]
}

action: create | assign | unassign | rename | delete. siteUrls é obrigatório para assign/unassign; newName é obrigatório para rename. rename e delete se aplicam a todas as propriedades e à lista global de tags.

delete_site write

Cancela o registro de uma propriedade. Em cascata para seus clusters, grupos, filtros, inspeções e anotações.

{
  "siteUrl": "sc-domain:example.com",
  "confirm": true
}

confirm deve ser true; isso é irreversível.

create_topic_cluster write

Cria um cluster de tópicos de palavras-chave em uma propriedade.

{
  "siteUrl": "sc-domain:example.com",
  "name": "Pricing",
  "keywords": [
    "pricing",
    "cost",
    "plans"
  ]
}

Idempotente: um nome existente retorna esse cluster com alreadyExisted: true, não um erro.

delete_topic_cluster write

Exclui um cluster de tópicos por id.

{
  "clusterId": "00000000-0000-0000-0000-000000000000"
}

create_content_group write

Cria uma partição de grupo de conteúdo. As regras correspondem a URLs por prefixo / contém / regex / igual.

{
  "siteUrl": "sc-domain:example.com",
  "name": "Blog",
  "rules": [
    {
      "type": "prefix",
      "value": "https://example.com/blog/"
    }
  ]
}

color e description são opcionais; até 50 regras.

delete_content_group write

Exclui um grupo de conteúdo por id.

{
  "groupId": "00000000-0000-0000-0000-000000000000"
}

create_saved_filter write

Salva um preset de filtro reutilizável para uma propriedade.

{
  "siteUrl": "sc-domain:example.com",
  "name": "Non-branded, mobile",
  "filters": [
    {
      "dimension": "device",
      "operator": "equals",
      "value": "MOBILE"
    },
    {
      "dimension": "branded",
      "operator": "equals",
      "value": "non_branded"
    }
  ]
}

filters é a lista de linhas de filtro que o painel armazena, no formato que list_saved_filters retorna. filterLogic é "and" (padrão) ou "or".

delete_saved_filter write

Exclui um filtro salvo por id.

{
  "filterId": "00000000-0000-0000-0000-000000000000"
}

create_annotation write

Adiciona uma anotação de gráfico em uma data (ex.: um marcador de lançamento ou campanha).

{
  "siteUrl": "sc-domain:example.com",
  "eventDate": "2026-05-15",
  "label": "Site redesign launched",
  "description": "New template rolled out across the blog.",
  "color": "#2563eb"
}

Omita siteUrl para uma anotação em toda a conta; description, category, color opcionais.

delete_annotation write

Exclui uma anotação de gráfico por id.

{
  "annotationId": "00000000-0000-0000-0000-000000000000"
}

submit_indexnow_urls write

Envia até 100 URLs para o IndexNow para a propriedade, após verificar se o arquivo de chave está no lugar.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/new-page",
    "https://example.com/updated-page"
  ]
}

O arquivo de chave é verificado por host ANTES de qualquer envio. Quando está definitivamente ausente ou incorreto, o lote não é enviado, outcome é setup_incomplete e a mensagem nomeia o arquivo a publicar; nada é gravado no histórico, porque um lote que nunca foi enviado não é uma submissão. Uma verificação inconclusiva (timeout, regra de bot) nunca bloqueia. outcome é um de submitted, pending_key_validation, rejected (o IndexNow recusou tudo o que foi enviado) ou setup_incomplete, e um lote misto relata ambas as partes na mensagem. Caso contrário, o 202 usual significa "aceito, validação de chave pendente", não entregue: os mecanismos buscam seu {key}.txt depois e descartam o lote sem aviso adicional se estiver inacessível. Cada submissão carrega um status e um sinalizador accepted, e submitted conta apenas o que o IndexNow aceitou.

submit_sitemap write

Envia (ou reenvia) uma URL de sitemap já publicada para o Search Console para a propriedade.

{
  "siteUrl": "sc-domain:example.com",
  "sitemapUrls": [
    "https://example.com/sitemap_index.xml"
  ]
}

Registra um sitemap existente no Google — nunca gera ou hospeda um, então o arquivo já deve estar publicado nessa URL (WordPress/Yoast, seu CMS, seu build). Cada URL deve estar no host da propriedade ou em um subdomínio. Até 20 por chamada, idempotente, e enfileira um download em vez de indexar qualquer coisa. Requer acesso total ao Search Console (webmasters, não webmasters.readonly). Cada submissão aceita é relida com list_sitemaps para que o resultado mostre o que o Google realmente registrou; avisos, erros e contagens indexadas só aparecem depois que o Google baixou o arquivo.

bulk_inspect_urls write

Inspeciona uma lista de URLs sequencialmente e persiste cada resultado.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/a",
    "https://example.com/b"
  ]
}

Conta contra a cota diária de 2.000 inspeções/propriedade (compartilhada com a UI); para e relata URLs ignoradas quando o limite é atingido. Passe até 25 URLs por chamada; conjuntos maiores pertencem a add_tracked_urls, que o Indexing Tracker inspeciona em segundo plano.

add_tracked_urls write

Adiciona URLs ao Indexing Tracker (cria o rastreador se necessário). Até 1.800 URLs por propriedade.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/page-1",
    "https://example.com/page-2"
  ]
}

URLs devem pertencer à propriedade. Novas URLs começam como "pending"; o cron horário ou check_tracked_url_now as inspeciona.

remove_tracked_urls write

Remove URLs do Indexing Tracker.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/page-1"
  ]
}

check_tracked_url_now write

Executa uma Inspeção de URL imediata para até 10 URLs rastreadas e atualiza seu status e histórico.

{
  "siteUrl": "sc-domain:example.com",
  "urls": [
    "https://example.com/page-1"
  ]
}

Conta contra a cota diária de 2.000 inspeções/propriedade; retorna uma mensagem de cota quando esgotada.

update_content_group write

Edita um grupo de conteúdo existente: seu nome, descrição, cor ou regras de correspondência.

{
  "groupId": "00000000-0000-0000-0000-000000000000",
  "name": "Blog"
}

Apenas os campos que você passar mudam. Passar rules SUBSTITUI a lista inteira de regras, então leia as regras atuais com list_content_groups primeiro se quiser adicionar uma.

update_topic_cluster write

Edita o nome ou a lista de palavras-chave de um cluster de tópicos.

{
  "clusterId": "00000000-0000-0000-0000-000000000000",
  "keywords": [
    "seo audit"
  ],
  "mode": "add"
}

mode: "replace" (padrão, troca a lista), "add" (mescla, deduplicado sem diferenciar maiúsculas/minúsculas) ou "remove" (exclui as palavras-chave listadas).

update_saved_filter write

Renomeia um preset de filtro salvo e/ou substitui seu payload de filtro.

{
  "filterId": "00000000-0000-0000-0000-000000000000",
  "name": "Blog, non-branded"
}

As linhas de filtro são substituídas por completo, não mescladas; leia as linhas atuais com list_saved_filters primeiro. Passe filterLogic junto com elas, ou o preset redefine para "and".

update_annotation write

Edita uma anotação de gráfico que você possui: sua data, rótulo, descrição, categoria ou cor.

{
  "annotationId": "00000000-0000-0000-0000-000000000000",
  "label": "Redesign launched"
}

O escopo não pode ser alterado (uma anotação de toda a conta não pode ser movida para uma propriedade); exclua-a e crie uma nova.

create_shared_report write

Salva uma tabela de linhas como um relatório compartilhável e obtém sua URL. Passe as linhas de outra ferramenta mais as colunas descrevendo quais campos mostrar.

{
  "title": "Top queries - January",
  "rows": [
    {
      "query": "seo tools",
      "clicks": 120,
      "impressions": 3400
    }
  ],
  "columns": [
    {
      "key": "query",
      "label": "Query",
      "type": "text"
    },
    {
      "key": "clicks",
      "label": "Clicks",
      "type": "number"
    }
  ]
}

PASSO 1 DE 3: a URL não abre para ninguém (nem para você) até que o acesso seja concedido. Depois, create_report_client e então manage_report_access. Até 50 relatórios por conta.

delete_shared_report write

Exclui permanentemente um relatório compartilhável salvo e todas as concessões de cliente nele.

{
  "reportId": "00000000-0000-0000-0000-000000000000"
}

Quebra o link compartilhado para qualquer pessoa que ainda o tenha. Encontre o id com list_shared_reports.

create_report_client write

Adiciona um contato de cliente (um endereço de e-mail mais um nome opcional) ao qual relatórios compartilháveis podem ser concedidos.

{
  "email": "client@example.com",
  "name": "Example Ltd"
}

Não envia e-mail e não concede acesso por si só. Adicionar um endereço que já existe retorna o cliente existente em vez de falhar.

manage_report_access write

Concede ou revoga acesso de cliente a um relatório compartilhável salvo. É isso que torna um relatório aberto.

{
  "reportId": "00000000-0000-0000-0000-000000000000",
  "action": "grant",
  "clientIds": [
    "00000000-0000-0000-0000-000000000000"
  ]
}

NÃO envia um e-mail de notificação. Passe ao cliente a URL do relatório (eles entram com seu e-mail e o app envia um link de login), ou envie de Account > Shared Reports no app, que tem um botão Resend por cliente.

set_dashboard_visibility write

Mostra ou oculta propriedades registradas no seu painel do GSC Wizard. A visibilidade também é o que torna uma propriedade utilizável pelas outras ferramentas MCP.

{
  "siteUrls": [
    "sc-domain:example.com"
  ],
  "visible": true
}

Mostrar uma propriedade consome um slot do painel do seu plano e é recusado quando o limite é atingido. Ocultar uma não exclui dados. Propriedades sincronizadas com ClickHouse são sempre mostradas e não consomem slot.

add_migration_redirects write

Salva mapeamentos de redirecionamento (URL antiga para URL nova) para uma migração de site, vinculados à propriedade de origem A e à propriedade de destino B.

{
  "siteUrlA": "sc-domain:old.com",
  "siteUrlB": "sc-domain:new.com",
  "redirects": [
    {
      "fromUrl": "https://old.com/a",
      "toUrl": "https://new.com/a"
    }
  ],
  "label": "2026-replatform"
}

As linhas são ANEXADAS, nunca deduplicadas contra o que já está armazenado, então reenviar a mesma lista a armazena duas vezes. Até 10.000 linhas por chamada.

delete_migration_redirects write

Exclui mapeamentos de redirecionamento salvos, filtrados por rótulo e/ou pelo par de propriedades A/B.

{
  "label": "2026-replatform"
}

Excluir TODOS os mapeamentos na conta requer confirmDeleteAll: true. Visualize o que seria excluído com list_migration_redirects usando os mesmos filtros primeiro.

update_indexnow_settings write

Define, rotaciona ou limpa a chave de API do IndexNow para uma propriedade.

{
  "siteUrl": "sc-domain:example.com",
  "indexnowApiKey": "a1b2c3d4e5f6a7b8c9d0"
}

A chave deve ter 8-128 caracteres de letras, dígitos e hífens, E publicada em https://your-domain/<key>.txt, ou as submissões são rejeitadas. Passe clear: true para removê-la.

run_feed_audit write

Enfileira uma auditoria de feed do Merchant Center para uma propriedade: 21 verificações determinísticas sobre o catálogo sincronizado mais um rastreamento das páginas de produto nos hosts aprovados pelo proprietário, pontuado de 0-100. Retorna um identificador de trabalho (runDate), nunca os resultados.

{
  "siteUrl": "sc-domain:example.com",
  "force": false
}

Apenas enfileira; a auditoria é executada no worker do app GSC Wizard e um catálogo grande pode levar horas para rastrear. enqueued: false com um skipReason significa que uma execução para hoje já existe ou uma foi concluída dentro do ciclo de 28 dias (force: true substitui o ciclo, nunca a regra de uma por dia). Siga com get_feed_audit_results. Shopping está em lançamento limitado: a ferramenta está habilitada apenas para contas na lista de permissões enquanto o recurso está em fase de teste, e não aparece em tools/list para outras contas.

Chamando uma ferramenta diretamente (curl)

A maioria dos usuários nunca precisa disso; os clientes lidam com o JSON-RPC para você. Mas para testar uma ferramenta manualmente, envie uma solicitação tools/call para o endpoint (após o SDK ter aberto uma sessão):

curl -X POST https://mcp.gscwizard.com/mcp \
  -H "Authorization: Bearer gscw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "query_top_queries",
      "arguments": {
        "siteUrl": "sc-domain:example.com",
        "startDate": "2026-05-01",
        "endDate": "2026-05-28",
        "limit": 10
      }
    }
  }'

Solução de problemas

  • 401 unauthorized: o cabeçalho Authorization: Bearer está ausente, malformado, ou a chave foi revogada ou expirou.
  • Uma ferramenta de mutação ausente ou recusada: sua chave é somente leitura. Crie uma nova chave de leitura e escrita.
  • 429 rate limit exceeded: chamadas de ferramenta são limitadas por conta a 60/minuto e 1.000/hora via MCP, e 180/minuto e 2.000/hora via API REST, medidas separadamente. A resposta REST inclui um cabeçalho Retry-After (segundos); pause e tente novamente após ele passar. Handshakes de protocolo não contam para o limite.
  • Verificação de saúde: GET https://mcp.gscwizard.com/health retorna { "ok": true } quando o servidor está ativo.