WP Manifestindependent plugin directory
manifest / analytics / wordpress_plugin

xSeek AEO Tracking

Server-side AI bot detection for WordPress. Tracks AI bot visits via xSeek’s API (bots don’t execute JavaScript).

by xSeek · github.com/xseekio/wordpress_plugin

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/xseekio/wordpress_plugin/archive/refs/heads/main.zip
Readme github.com/xseekio/wordpress_plugin ↗

xSeek AEO Tracking WordPress Plugin

AEO integration for WordPress and server-side AI bot detection. Tracks AI bot visits via xSeek’s API (AI bots typically don’t execute JavaScript).

What it does

Most AI bots fetch HTML but do not execute JavaScript, so client-side tracking misses the majority of AI traffic. This plugin detects AI bots server-side (via User-Agent) and sends an event to xSeek when a bot is detected.

API endpoint

POST https://www.xseek.io/api/track-ai-bot

Request body (JSON)

{
  "botName": "string",
  "userAgent": "string",
  "url": "string",
  "websiteId": "string",
  "ip": "string (optional)",
  "referer": "string (optional)"
}

Installation

  1. Upload xseek-aeo-tracking.zip
  2. WordPress → Plugins → Add New → Upload Plugin → Activate
  3. WordPress → Settings → xSeek AI Tracking
  4. Enable xSeek tracking (opt-in)
  5. Paste your xSeek Website ID + API Key (API key must have ai_visits:push)
  6. (Optional) Enable including IP and/or Referer
  7. Click Send Test Event to verify configuration

Privacy

  • Opt-in: disabled by default.
  • Bot-only: sends only for detected AI bots (not every request).
  • Metadata only: no request/response bodies are sent.
  • API key storage: encrypted at rest when possible (WordPress salts + libsodium).

FAQ

Does this track regular visitors?

No. It only sends events when the request User-Agent matches a known AI bot pattern.

What data is sent to xSeek?

Required: botName, userAgent, url, websiteId. Optional (if enabled): ip, referer.

I’m behind a proxy/CDN (Cloudflare, nginx). Will IP be correct?

If you enable “Include IP address”, the plugin uses X-Forwarded-For (left-most) when present, otherwise REMOTE_ADDR.

Troubleshooting

  • If the test event fails, confirm your API key has the ai_visits:push privilege and your Website ID is correct.
  • Some hosts block outgoing HTTP requests; check your server/firewall rules if you never see events.

License

MIT — see LICENSE.