MessGEODocs
Get an API key

AI bot logs

The bot log shows which AI bots visit your site (live answer readers, index crawlers, training crawlers), which pages they read, whether they get errors, and how many visits arrive from AI search. It runs on both plans; the recent event list is on Pro.

Connect your site

Open the panel, go to Settings > AI bots and add a source. Choose the method that fits your site:

  1. Cloudflare Worker (any site behind Cloudflare, free plan included): create a Worker, paste the code from the panel, add the key as the MESSGEO_KEY secret and route it to your domain. If the Worker cannot reach us, your site keeps working.
  2. WordPress plugin: download the plugin zip from the panel, install it, and paste the key on its settings page.
  3. PHP file (other PHP sites): download the file and include it at the top of index.php.
  4. Log file upload: upload an nginx, Apache, CloudPanel or IIS access log (.log or .gz).

Then press Verify connection. Shopify, Wix, Squarespace and similar hosted platforms do not give access to server requests; use the AI traffic tab (Google Analytics) instead.

What is stored

  • For bots: bot name, page path, time, status code and bytes. The IP address is used only to check that the bot is genuine and is deleted right after.
  • For human visitors: only a per-page count of visits coming from AI search. No IP, browser details or identity.
  • Daily totals are kept for up to 400 days. Deleting the panel deletes everything.

Alerts

You get an alert when a connected source sends no data for 48 hours, or when AI bots keep getting errors on your pages. Alerts follow your alert e-mail preference.

API and MCP

  • GET /v1/panels/{panel_id}/bots: summary and daily series.
  • GET /v1/panels/{panel_id}/bots/pages: pages with the last read by each bot class.
  • GET /v1/panels/{panel_id}/bots/events: recent events (Pro).
  • GET /v1/panels/{panel_id}/bots/sources: connected sources.
  • POST /v1/panels/{panel_id}/bots/sources: create a source (kind: cf or php; the WordPress plugin uses php). The key is in this answer only. Creating a source through the API means you accept the same terms as in the panel.
  • POST /v1/panels/{panel_id}/bots/sources/{source_id}/rotate: new key, the old one works for 7 more days. DELETE with confirm: true revokes it.
  • POST /v1/panels/{panel_id}/bots/sources/{source_id}/verify: send one test request to your site, then read verified in /bots/sources. At most 10 per panel per day.
  • GET /v1/panels/{panel_id}/bots/kit/{kind}: the setup file (worker, php, or wp for the WordPress plugin zip). It contains no key. wp is a zip file and cannot be requested with ?format=json (422, reason: binary_file).

See the API reference for request and response details.