Assistente do GSC (versão prévia)

Pesquisar desempenho do Console, indexação e IndexNow para seus sites.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Logic Apps Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Azure Governamental regiões
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões Power Apps exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões Power Automate exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Name Assistente do GSC
URL https://www.gscwizard.com
Email support@gscwizard.com
Metadados do conector
Publicador Assistente do GSC
Website https://www.gscwizard.com
Política de Privacidade https://www.gscwizard.com/privacy.html
Categories IA; Dados

Assistente do GSC

Visão geral

O Assistente do GSC conecta agentes aos seus próprios dados do Console de Pesquisa do Google e ao pipeline de indexação instantânea do Bing. Pergunte sobre tendências de tráfego, principais consultas e páginas, canibalização de palavra-chave, conteúdo em decomposição, Core Web Vitals e cobertura de índice em linguagem natural e, em seguida, aja na resposta: envie URLs alteradas diretamente para IndexNow, o protocolo aberto que Bing, Yandex e Seznam usam para pegar páginas novas e atualizadas sem esperar por um rastreamento.

O conector expõe um conjunto de 24 ferramentas, escolhidos no catálogo de ferramentas do Assistente do GSC mais amplo para os que se ajustam ao uso de conversa. Vinte e dois são somente leitura. Apenas duas gravações: submit_indexnow_urls e update_indexnow_settingsambas descritas na seção IndexNow abaixo.

Publicador

Assistente do GSC

Serviço/API

Servidor MCP do Assistente do GSC

  • Host:mcp.gscwizard.com
  • Caminho base:/
  • Esquema:https
  • Transporte: MCP Streamable HTTP

Prerequisites

Antes de poder usar este conector:

  1. Crie uma conta do https://www.gscwizard.comAssistente do GSC e inicie uma assinatura. A etapa de entrada rejeita contas sem uma assinatura ativa.
  2. Conecte pelo menos uma propriedade do Console de Pesquisa do Google. Entre com a conta do Google que possui ou tem acesso à propriedade. Sem uma propriedade conectada, cada ferramenta retorna um resultado vazio ou não encontrado.
  3. Somente para as ferramentas indexNow: configure uma chave IndexNow para a propriedade e publique o arquivo de chave em seu site. Consulte a configuração do IndexNow abaixo. As ferramentas somente leitura funcionam sem esta etapa.

Authentication

Esse conector usa o OAuth 2.0 com PKCE. Entre com sua conta do Assistente do GSC e conceda ao conector acesso às propriedades do Console de Pesquisa já conectadas a ela. O conector nunca vê suas credenciais do Google: o Assistente do GSC contém a autorização do Google e o conector tem o escopo do próprio Assistente do GSC.

Dois escopos são solicitados:

  • mcp:read para todos os dados do Console de Pesquisa, indexação e conta.
  • mcp:write para as ferramentas indexNow.

Ferramentas disponíveis

Orientando-se

  • list_sites: Listar propriedades do Console de Pesquisa conectadas à conta. Comece aqui; a maioria das outras ferramentas tira um siteUrl desta lista.
  • get_account_info: Perfil, contas conectadas do Google e estado da assinatura.
  • get_site_summary: totais dos últimos N dias mais uma comparação de período anterior.

Desempenho da pesquisa

  • query_search_analytics: consulta ad hoc Search Analytics em relação a uma propriedade. A ferramenta de leitura mais flexível: escolha suas próprias dimensões, intervalo de datas e filtros.
  • query_top_queries: principais consultas de pesquisa clicando em um intervalo de datas.
  • query_top_pages: Páginas de aterrissagem superiores clicando em um intervalo de datas.
  • get_query_performance: Métricas diárias para uma única consulta, opcionalmente em uma URL.
  • get_page_performance: cliques diários, impressões, CTR e posição para uma única URL.
  • get_ranking_changes: consultas novas, perdidas, aprimoradas e recusadas (ou páginas) entre dois períodos.

Oportunidades e diagnóstico

  • score_opportunities: Pontuação de oportunidade ponderada por impressão favorecendo consultas de alta impressão perto da parte superior da página dois.
  • analyze_cannibalization: consultas em que duas ou mais páginas competem, pontuadas por entropia dividida por impressão.
  • find_decaying_content: consultas ou páginas perdendo cliques em um período de linha de base, bucketed grave, moderado ou leve.
  • audit_onpage_seo: rastreia páginas e executa uma auditoria técnica na página por URL (indexabilidade, títulos, canônicos, links, dados estruturados, problemas).
  • get_core_web_vitals: Dados de campo de relatório do Chrome UX: core web vitals semanais (LCP, INP, CLS) mais FCP e TTFB, com classificações e regressões.

Indexação e rastreamento

  • inspect_url: execute a API de Inspeção de URL para uma URL e persista o resultado no histórico.
  • list_url_inspections: histórico de inspeção de URL persistente, paginado.
  • get_inspection_quota: Inspeções de URL restantes disponíveis hoje para uma propriedade. Vale a pena verificar antes de uma série de inspeções, já que a cota diária do Google é pequena.
  • get_indexing_tracker: Configuração do Rastreador de Indexação e um resumo de status: indexado, não indexado, pendente, erros e avisos.
  • list_sitemaps: Sitemaps enviados ao Console de Pesquisa para obter uma propriedade.
  • get_sitemap_performance: busca um mapa de site, extrai suas URLs e une cada uma delas com cliques, impressões e posição do Console de Pesquisa.

IndexNow: indexação instantânea do Bing

O IndexNow permite informar aos mecanismos de pesquisa participantes que uma URL foi alterada, em vez de aguardar o próximo rastreamento. O Bing é seu principal consumidor; Yandex e Seznam também participam.

  • get_indexnow_settings: relata se uma chave IndexNow está configurada para uma propriedade (mascarada para seus últimos quatro caracteres, nunca retornada na íntegra) e se o arquivo de chave é realmente acessível em seu site.
  • update_indexnow_settings: defina, gire ou desmarque a chave IndexNow para uma propriedade.
  • submit_indexnow_urls: envie até 100 URLs para IndexNow para a propriedade.
  • list_indexnow_submissions: histórico de envio do IndexNow para uma propriedade.

Configuração do IndexNow

O IndexNow requer uma prova de que você controla o site, na forma de um arquivo de chave fornecido do próprio site. Ambas as etapas são necessárias:

  1. Defina uma chave para a propriedade com update_indexnow_settings ou no aplicativo Web assistente GSC nas configurações do IndexNow.
  2. Publique essa chave como um arquivo https://<your-domain>/<key>.txtde texto sem formatação, contendo a chave e nada mais.

get_indexnow_settings relata o estado de ambas as etapas, para que um agente possa informar em qual delas está faltando e fornecer a URL exata em que o arquivo deve residir. Os envios feitos antes que o arquivo de chave seja acessível são rejeitados antecipadamente em vez de aceitos e removidos silenciosamente.

Introdução

  1. Ligue list_sites para ver quais propriedades do Console de Pesquisa estão disponíveis e obtenha seus siteUrl valores.
  2. Chame get_site_summary uma leitura rápida sobre como uma propriedade está se saindo.
  3. Chame query_search_analytics, query_top_queries ou query_top_pages para detalhes, ou score_opportunities e analyze_cannibalization para as próximas ações classificadas.
  4. Ligue inspect_url ou get_indexing_tracker verifique se o Google indexou as páginas com as quais você se importa.
  5. Depois de publicar ou atualizar páginas, chame submit_indexnow_urls para que o Bing as pegue sem esperar por um rastreamento.

Casos de uso comuns

  • Relatórios semanais de pesquisa. "Como a pesquisa orgânica fez na semana passada em comparação com a semana anterior, e quais páginas se moveram mais?"
  • Encontrar vitórias rápidas. "Quais consultas estão apenas fora da página um com impressões altas?"
  • Diagnosticando uma queda. "O tráfego para esta página caiu. É uma alteração de classificação, um problema de indexação ou uma regressão do Core Web Vitals?"
  • Corrigindo a auto-concorrência. "Quais das minhas páginas estão competindo pelas mesmas consultas?"
  • Fluxo de trabalho de publicação. "Acabei de atualizar essas dez páginas. Audite-os e envie-os ao IndexNow para que o Bing os repita."
  • Verificações de cobertura de índice. "As URLs no meu mapa de site são realmente indexadas e quais não são?"

Limitações conhecidas

  • Somente leitura, exceto duas ferramentas IndexNow. Vinte e dois das 24 ferramentas são lidas apenas. Nada altera a configuração do Console de Pesquisa ou seu site. Os dois que gravam são update_indexnow_settings, que armazena uma chave IndexNow para sua propriedade e submit_indexnow_urls, que transmite URLs para a rede indexNow pública. As outras duas ferramentas get_indexnow_settings IndexNow e list_indexnow_submissions, somente leitura.
  • IndexNow 202 não significa indexado. IndexNow retorna HTTP 202 para "aceitação, validação de chave pendente". Em seguida, os mecanismos buscarão o arquivo de chave e descartarão o lote se ele não for acessível. Trate 202 como enviado, nunca como indexado.
  • Limites de envio do IndexNow. Até 100 URLs por chamada. Os envios também contam com relação aos limites de chamada de ferramenta por conexão acima.
  • Cota de inspeção de URL. O Google caps URL inspeções por propriedade por dia. Verifique get_inspection_quota antes do trabalho em massa.
  • Atraso de dados do Console de Pesquisa. Os dados do Console de Pesquisa normalmente estão de dois a três dias atrasados, e o dia ou dois mais recentes ainda podem ser alterados. Não leia o último dia de um intervalo como final.
  • Respostas superdimensionadas são recusadas, não truncadas. Um resultado com mais de 100.000 caracteres volta como um aviso curto dizendo o tamanho e o que ele continha, em vez de uma resposta parcial que poderia ser mal lida como concluída. Reduza o intervalo de datas, reduza o limite de linhas ou solicite menos dimensões.
  • Algumas propriedades não retornam nada. Uma propriedade com pouco tráfego ou uma conectada muito recentemente retorna legitimamente resultados vazios.
  • O acesso à propriedade segue o Assistente de GSC. Você só pode acessar propriedades conectadas ou compartilhadas com sua conta do Assistente do GSC.

Limitações

Name Chamadas Período de renovação
Chamadas de ferramenta por conexão 60 60 segundos
Chamadas de ferramenta por conexão 1000 1 hora

Nem todas as ferramentas custam uma chamada nessas janelas. audit_onpage_seo rastreia páginas e custa 5, portanto, o teto prático é de cerca de 12 auditorias por minuto em vez de 60. Todo o resto neste conector custa 1.

Suporte

Ações

Assistente do GSC

Pesquisar desempenho do Console, indexação e IndexNow para seus sites.

Assistente do GSC

Pesquisar desempenho do Console, indexação e IndexNow para seus sites.