Automação do Google Search Console via Rube MCP

O que Automação do Google Search Console via Rube MCP faz?

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

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

Pré-requisitos

• 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 apropriadas no Google Search Console
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas atuais das ferramentas

Configuração

Obtenha 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 da 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 YYYY-MM-DD
  - end_date (obrigatório): Data de término no formato YYYY-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 (operador: equals, notEquals, contains, notContains, includingRegex, excludingRegex)
  - row_limit: Máximo de linhas (1-25000, padrão 1000)
  - start_row: Offset de 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 para inspeção (ex.: "https://www.exemplo.com/pagina")
  - site_url (obrigatório): URL da propriedade (ex.: "https://www.exemplo.com/")
  - language_code: 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 de índice de sitemap específico 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 recuperar 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 da pesquisa.
• Relatório de consultas principais: 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 de 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 pesquisa.
• Filtrar consultas específicas: Use dimension_filter_groups com os 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 melhores resultados ordenados por cliques (ou por data ao agrupar por data). Para dados completos, pagine 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 parâmetro 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 analíticos são ordenados por número de cliques descendente, exceto ao agrupar por date (que ordena por data ascendente).

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 info do sitemap	GOOGLE_SEARCH_CONSOLE_GET_SITEMAP	site_url, feedpath

---

Desenvolvido por Composio