Ligar o Search Console a qualquer cliente MCP

O endpoint

O servidor está em /mcp no domínio da aplicação e comunica em Streamable HTTP na versão de protocolo 2025-06-18. Os clientes enviam JSON-RPC via POST, fazem um pedido initialize e depois tools/list. Não há nada para instalar nem qualquer proxy local no caminho.

• Authorization: Bearer com uma chave no formato apk_live_ mais 32 caracteres hexadecimais
• As chaves são mostradas uma única vez, no momento da criação, e armazenadas apenas como hash SHA-256
• Cada chamada atualiza a data/hora da última utilização da chave e o contador de pedidos

As ferramentas

Agrupadas pelo que fazem, com nomes claros para o modelo escolher a certa. Uma chave só de leitura nunca acede a uma ferramenta que escreve ou gasta créditos de pesquisa.

• Descoberta: list_properties, search_analytics
• Desempenho: top_queries, top_pages, top_countries, compare_periods
• Diagnóstico: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Indexação: url_inspection, sitemaps
• Linha temporal: annotations, e create_annotation com uma chave de escrita
• Analytics: ga4_overview, ga4_breakdown, ga4_key_events
• Pesquisa: palavras-chave, SERPs, backlinks, monitorização de posições e auditorias de site, que gastam créditos de pesquisa
• Motor de conteúdo: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish e as ferramentas de capa, para escrever a partir da fila

As datas são opcionais

Omita o intervalo em qualquer ferramenta e o servidor utiliza os últimos 28 dias já consolidados, tendo em conta o atraso de relatório do Search Console, com a janela de comparação a assumir por predefinição o período anterior de igual duração. O cliente nunca precisa de saber a data de hoje para fazer uma pergunta sensata.

Âmbitos e limites de taxa

Uma chave é só de leitura ou de leitura e escrita. Uma chave só de leitura nunca consegue aceder a uma ferramenta de escrita, e todas as alterações feitas com uma chave de escrita ficam registadas em auditoria.

• 60 pedidos por minuto por chave, 1000 por hora por conta
• Ultrapassar o limite devolve HTTP 429 com Retry-After em segundos
• Revogue uma única chave sem afetar o resto da conta

REST, se preferir

As ferramentas do Search Console e GA4 também estão disponíveis como rotas GET e POST em /v1, com um documento OpenAPI 3.1 gerado em /v1/openapi.json, que serve também de especificação para chamada de funções. Mesmas chaves, mesmos âmbitos, mesmos limites.