Automação do Google Search Console

Automação do Google Search Console via Rube MCP

Consulte análises de pesquisa, inspecione URLs, gerencie sitemaps e monitore o desempenho de busca usando o Google Search Console via Rube MCP (Composio).

Documentação do toolkit: composio.dev/toolkits/google_search_console

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa via RUBE_MANAGE_CONNECTIONS com o toolkit google_search_console
• Propriedade verificada do site ou permissões adequadas no Google Search Console
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas atuais das ferramentas

Configuração

Obter o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e ele funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit google_search_console
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme que o status da conexão mostra ATIVO antes de executar qualquer fluxo de trabalho

Fluxos de Trabalho Principais

1. Listar Todos os Sites Verificados

Use GOOGLE_SEARCH_CONSOLE_LIST_SITES para recuperar todos os sites que o usuário autenticado possui ou tem acesso.

Ferramenta: GOOGLE_SEARCH_CONSOLE_LIST_SITES
Parâmetros: (nenhum obrigatório)
Retorna: Lista de entradas de site com siteUrl e permissionLevel

2. Consultar Análises de Pesquisa

Use GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY para obter dados de desempenho de pesquisa, incluindo cliques, impressões, CTR e posição.

Ferramenta: GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY
Parâmetros:
  - site_url (obrigatório): URL do site (ex.: "https://www.exemplo.com/" ou "sc-domain:exemplo.com")
  - start_date (obrigatório): Data de início no formato AAAA-MM-DD
  - end_date (obrigatório): Data de fim no formato AAAA-MM-DD
  - dimensions: Agrupar por ["query", "page", "country", "device", "date", "searchAppearance"]
  - search_type: "web" (padrão), "image", "video", "news", "discover", "googleNews"
  - dimension_filter_groups: Filtros para dimensões (operadores: equals, notEquals, contains, notContains, includingRegex, excludingRegex)
  - row_limit: Máximo de linhas (1-25000, padrão 1000)
  - start_row: Deslocamento para paginação (padrão 0)
  - aggregation_type: "auto", "byPage", "byProperty", "byNewsShowcasePanel"
  - data_state: "final" (padrão), "all", "hourly_all"

3. Inspecionar uma URL

Use GOOGLE_SEARCH_CONSOLE_INSPECT_URL para verificar o status de indexação e problemas de uma URL específica.

Ferramenta: GOOGLE_SEARCH_CONSOLE_INSPECT_URL
Parâmetros:
  - inspection_url (obrigatório): URL completa a ser inspecionada (ex.: "https://www.exemplo.com/pagina")
  - site_url (obrigatório): URL da propriedade (ex.: "https://www.exemplo.com/")
  - language_code: Código de idioma BCP-47 (padrão: "en-US")

4. Listar Sitemaps

Use GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS para recuperar todos os sitemaps enviados para um site.

Ferramenta: GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS
Parâmetros:
  - site_url (obrigatório): URL do site (ex.: "https://www.exemplo.com/")
  - sitemap_index: URL específica do índice de sitemap para listar sitemaps

5. Enviar um Sitemap

Use GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP para registrar ou reenviar um sitemap para indexação.

Ferramenta: GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP
Parâmetros:
  - site_url (obrigatório): URL do site ou propriedade de domínio (ex.: "sc-domain:exemplo.com")
  - feedpath (obrigatório): URL completa do sitemap (ex.: "https://www.exemplo.com/sitemap.xml")

6. Obter Detalhes do Sitemap

Use GOOGLE_SEARCH_CONSOLE_GET_SITEMAP para recuperar informações sobre um sitemap enviado específico.

Ferramenta: GOOGLE_SEARCH_CONSOLE_GET_SITEMAP
Parâmetros:
  - site_url (obrigatório): URL do site
  - feedpath (obrigatório): URL do sitemap para obter detalhes

Padrões Comuns

• Monitoramento de desempenho: Use GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY com dimensions: ["date"] em um intervalo de datas para acompanhar as tendências diárias de desempenho de busca.
• Relatório de principais consultas: Use GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY com dimensions: ["query"] para encontrar os termos de pesquisa mais clicados.
• Análise por página: Use dimensions: ["page"] para identificar as páginas com melhor desempenho e, em seguida, dimensions: ["query", "page"] para ver quais consultas geram tráfego para cada página.
• Auditoria de indexação: Use GOOGLE_SEARCH_CONSOLE_INSPECT_URL para verificar o status de indexação de páginas importantes.
• Gerenciamento de sitemaps: Use GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS para verificar sitemaps enviados e, em seguida, GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP para enviar novos ou atualizados.
• Detalhamento por país/dispositivo: Use dimensions: ["country", "device"] para entender a distribuição geográfica e por tipo de dispositivo do tráfego de busca.
• Filtrar por consultas específicas: Use dimension_filter_groups com operadores contains ou includingRegex para focar em grupos de palavras-chave específicos.

Armadilhas Conhecidas

• O formato da URL do site é importante: Propriedades de prefixo de URL usam a URL completa com protocolo e barra final (ex.: https://www.exemplo.com/). Propriedades de domínio usam o prefixo sc-domain: (ex.: sc-domain:exemplo.com). Usar o formato errado retornará resultados vazios ou erros.
• Limites de intervalo de datas: Os dados geralmente estão disponíveis com um atraso de 2 a 3 dias. data_state: "all" inclui dados mais recentes que ainda podem mudar. hourly_all funciona apenas para datas nos últimos 3 dias.
• Paginação por limite de linhas: A API retorna os principais resultados ordenados por cliques (ou por data ao agrupar por data). Para dados completos, faça paginação usando start_row com row_limit.
• Máximo de 25.000 linhas por requisição: Mesmo com paginação, cada requisição retorna no máximo 25.000 linhas. Para conjuntos de dados muito grandes, reduza o intervalo de datas ou adicione filtros de dimensão.
• URL de inspeção deve corresponder ao site: O inspection_url deve ser uma página dentro da propriedade site_url. Inspeções entre propriedades falharão.
• Sitemap deve estar acessível: GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP exige que o arquivo de sitemap esteja publicamente acessível na URL especificada e formatado corretamente como XML.
• Resultados ordenados por cliques: Por padrão, os resultados das análises são ordenados por número de cliques em ordem decrescente, exceto quando agrupados por date (que ordena por data crescente).

Referência Rápida

Ação	Ferramenta	Parâmetros Principais
Listar sites	GOOGLE_SEARCH_CONSOLE_LIST_SITES	(nenhum)
Análises de pesquisa	GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY	site_url, start_date, end_date, dimensions
Inspecionar URL	GOOGLE_SEARCH_CONSOLE_INSPECT_URL	inspection_url, site_url
Listar sitemaps	GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS	site_url
Enviar sitemap	GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP	site_url, feedpath
Obter informações do sitemap	GOOGLE_SEARCH_CONSOLE_GET_SITEMAP	site_url, feedpath

---

Desenvolvido por Composio