MessGEODocs
Obter chave de API

Registos de bots de IA

O registo de bots mostra que bots de IA visitam o seu site (leitores de respostas em direto, rastreadores de índice, rastreadores de treino), que páginas leem, se recebem erros e quantas visitas chegam da pesquisa com IA. Funciona nos dois pacotes; a lista de eventos recentes está no Pro.

Ligar o seu site

No painel, vá a Definições > Bots de IA e adicione uma fonte. Escolha o método adequado ao seu site:

  1. Cloudflare Worker (qualquer site atrás do Cloudflare, incluindo o plano gratuito): crie um Worker, cole o código do painel, adicione a chave como segredo MESSGEO_KEY e associe-o ao seu domínio. Se o Worker não nos conseguir alcançar, o seu site continua a funcionar.
  2. Plugin de WordPress: descarregue o zip do plugin no painel, instale-o e cole a chave na página de definições do plugin.
  3. Ficheiro PHP (outros sites PHP): descarregue o ficheiro e inclua-o no início do index.php.
  4. Carregamento de ficheiro de registo: carregue um registo de acessos nginx, Apache, CloudPanel ou IIS (.log ou .gz).

Depois carregue em Verificar ligação. O Shopify, o Wix, o Squarespace e plataformas geridas semelhantes não dão acesso aos pedidos do servidor; use antes o separador de tráfego de IA (Google Analytics).

O que é guardado

  • Para bots: nome do bot, caminho da página, hora, código de estado e bytes. O endereço IP é usado apenas para verificar que o bot é genuíno e é apagado logo a seguir.
  • Para visitantes humanos: apenas, por página, o número de visitas vindas da pesquisa com IA. Sem IP, dados do navegador ou identidade.
  • Os totais diários são guardados até 400 dias. Eliminar o painel apaga tudo.

Alertas

Recebe um alerta quando uma fonte ligada não envia dados durante 48 horas ou quando os bots de IA continuam a receber erros nas suas páginas. Os alertas seguem a sua preferência de e-mail de alertas.

API e MCP

  • GET /v1/panels/{panel_id}/bots: resumo e série diária.
  • GET /v1/panels/{panel_id}/bots/pages: páginas com a última leitura de cada classe de bot.
  • GET /v1/panels/{panel_id}/bots/events: eventos recentes (Pro).
  • GET /v1/panels/{panel_id}/bots/sources: fontes ligadas.
  • POST /v1/panels/{panel_id}/bots/sources: cria uma fonte (kind: cf ou php; o plugin de WordPress usa php). A chave só aparece nesta resposta. Criar uma fonte pela API significa aceitar as mesmas condições do painel.
  • POST /v1/panels/{panel_id}/bots/sources/{source_id}/rotate: nova chave; a antiga funciona mais 7 dias. DELETE com confirm: true revoga-a.
  • POST /v1/panels/{panel_id}/bots/sources/{source_id}/verify: envia um pedido de teste ao seu site; depois leia verified em /bots/sources. No máximo 10 por painel por dia.
  • GET /v1/panels/{panel_id}/bots/kit/{kind}: o ficheiro de instalação (worker, php ou wp para o zip do plugin de WordPress). Não contém a chave. wp é um ficheiro zip e não pode ser pedido com ?format=json (422, reason: binary_file).

Consulte a referência da API para os detalhes de pedidos e respostas.