Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/michaelnotbohm/chat-radar-ai-crawler-tracking/archive/refs/heads/main.zipSee which AI crawlers and AI assistants visit your site, in your Chat Radar dashboard. Requires a Chat Radar or Dental Mentions account.
Description
AI assistants such as ChatGPT, Claude, Perplexity and Gemini send crawlers to read your pages, both to train models and to answer questions in real time. Chat Radar — AI Crawler Tracking records those visits on your WordPress site and reports them in your Chat Radar (or Dental Mentions) dashboard, next to your AI visibility scores.
What it does:
- Recognises requests from known AI crawlers and AI assistants by their user agent (for example GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, Claude-User, PerplexityBot, Google-Extended, Applebot, Amazonbot, Bytespider, CCBot and Meta-ExternalAgent).
- Sends one small event per matched crawler request to your Chat Radar account, where it is verified and added to your crawler report.
- Shows the last 10 matched visits on the settings page, so you can see it working before your dashboard updates.
- Includes a "Send test event" button that confirms the connection end to end.
- Keeps its crawler list current by downloading the latest list once a week.
What it does not do:
- It does not track people. Requests from ordinary browsers are ignored and nothing about them leaves your site.
- It does not track logged-in editors or administrators.
- It does not add scripts, cookies or anything else to your front-end pages.
- A copy installed from the plugin directory sends nothing until you save an ingest key. A zip downloaded from your dashboard connects itself when you activate it.
An account is required
This plugin is the WordPress connector for the Chat Radar service. You need a Chat Radar or Dental Mentions account and the ingest key shown in your dashboard under Settings → Crawler Tracking. Without a key the plugin stays inactive.
Installation
- Install the plugin from Plugins → Add New (search for "Chat Radar"), or upload the zip from your dashboard, and activate it.
- In your Chat Radar or Dental Mentions dashboard, open Settings → Crawler Tracking → WordPress plugin and copy your ingest key.
- In WordPress, go to Settings → AI Crawler Tracking, paste the key and click Save.
- Click "Send test event". The status changes to Connected once the service has received it.
If you downloaded the zip from your dashboard, you can skip steps 2 and 3: activating that zip connects this site to your account and starts tracking. Activating it is your opt-in.
Frequently Asked Questions
Do I need an account?
Yes. The plugin reports to your Chat Radar or Dental Mentions account and needs the ingest key from your dashboard. A copy from the plugin directory does nothing until a key is saved. A zip downloaded from your dashboard fetches its key when you activate it.
Which crawlers are recognised?
AI user-fetch agents (ChatGPT-User, Claude-User, Perplexity-User, MistralAI-User), AI search crawlers (OAI-SearchBot, Claude-SearchBot, PerplexityBot, DuckAssistBot, Amazonbot, Applebot), training crawlers (GPTBot, ClaudeBot, Google-Extended, Applebot-Extended, CCBot, Meta-ExternalAgent, Bytespider) and the classic search crawlers Googlebot and Bingbot. The list is refreshed weekly from the Chat Radar service; a built-in copy is used until then.
Does it slow my site down?
No. Ordinary visitors only go through a quick user-agent check. For matched crawler requests the event is sent at the very end of the request, after the page has been delivered, with a two-second limit, and any error is ignored.
My host uses full-page caching. Will this work?
Full-page caches such as WP Engine's page cache, LiteSpeed Cache or Cloudflare APO can serve cached pages without running PHP, so the plugin never sees those crawler visits. The test event will still work, but your crawler counts will be low. In that case use the Cloudflare Logpush method offered in your dashboard, which records visits at the edge.
What is the mu-plugin loader?
Some sites run plugins that end requests early (for example to serve a cached page from PHP), before regular plugins get a chance to run. The plugin folder contains mu-plugin/crai-loader.php. Copy that file into wp-content/mu-plugins/ (create the folder if it does not exist) and the tracker loads before regular plugins. The loader does nothing if this plugin is removed or deactivated. Delete the file to undo.
My site is behind a proxy or CDN. Which IP address is sent?
By default the plugin uses the connecting IP address (REMOTE_ADDR) and ignores forwarding headers, which can be spoofed. If your site sits behind a proxy that sets a trusted header, name it in wp-config.php, for example define( 'CRAI_TRUST_PROXY_HEADER', 'CF-Connecting-IP' );.
Does it work on multisite?
It has not been tested on multisite yet. It is built to keep each site's key, settings and local table separate, but activate it on one site first and use the Send test event button to check it.
How do I stop tracking?
Click "Remove key and stop tracking" on the settings page, or deactivate the plugin. Deleting the plugin removes all of its settings, scheduled tasks and its local table.
Where do I get support?
Email hello@chatradar.ai or use the help options in your dashboard. The WordPress.org support forum is monitored, but email is the fastest way to reach us.
External services
This plugin connects to the Chat Radar service, operated by Chat Radar, to record AI crawler visits in your account. Installed from the plugin directory, it makes no remote requests of any kind until an administrator saves an ingest key on the settings page. A zip downloaded from your dashboard is different: activating it is the opt-in, so it connects and starts tracking on activation (see Connecting a dashboard zip, below). It loads no remote scripts, styles, fonts or images, and includes no analytics or tracking of people.
Connecting a dashboard zip — POST https://business.chatradar.ai/api/crawler-tracking/plugin/claim (Dental Mentions accounts use the host set in their zip)
- When: once, on activation of a zip downloaded from your dashboard. If the service cannot be reached, it is retried later with a delay of at least five minutes, or when an administrator clicks Retry. Copies from the plugin directory never make this request.
- What is sent: the single-use claim token from the zip and the site hostname.
- What comes back: the ingest key for this site, the ingest host for your account, and the brand name, support email and dashboard link shown on the settings page.
- Why: so the zip never has to contain your key. The file holding the token is deleted once it has been used.
After a key is saved, the plugin makes exactly these requests:
- Crawler visit events —
POST https://ingest.crawlertracking.com/plugin- When: only for a front-end request whose user agent matches a known AI crawler or AI assistant. Requests from ordinary browsers, logged-in editors, the admin area, the REST API, cron and static files are never sent.
- What is sent: the site hostname, the request path (including the query string), the crawler's full user agent, the time of the request, the HTTP response status, and the IP address of the matched crawler request. Your ingest key is sent in a request header to identify your account.
- Why: so the service can verify the crawler (by checking its IP address against the operator's published ranges) and add the visit to your crawler report.
- Test event — the same endpoint, only when an administrator clicks "Send test event". It sends the hostname, the path
/, the brand-neutral user agentCrawlerTracking-Verify/1.0 (+plugin test), a documentation-only IP address (192.0.2.1), the time and status 200, marked as a test. - Crawler list —
GET https://ingest.crawlertracking.com/bots.json, once a week (and once right after a key is saved). Nothing about your site or visitors is sent; the response is the current list of crawler user-agent patterns. - Connection status —
GET https://business.chatradar.ai/api/crawler-tracking/plugin/status, when an administrator opens or saves the settings page (cached for five minutes) or sends a test event. It sends the site hostname and your ingest key. The response contains the connection status, the times of the last test and last visit, the brand name, support email and dashboard link shown on the settings page, and the ingest host, which the plugin saves and uses for the two requests above.
Chat Radar Terms of Service: https://chatradar.ai/terms Chat Radar Privacy Policy: https://chatradar.ai/privacy
Screenshots
- The settings page: ingest key, hostname, connection status and the Send test event button.
- Recent crawler visits recorded on this site, shown on the settings page.
- The result of a successful test event, with the status showing Connected.
Changelog
1.0.0
- Initial release: AI crawler detection, event delivery to Chat Radar, weekly crawler list refresh, settings page with status, test event and recent visits, optional mu-plugin loader.
Upgrade Notice
1.0.0
Initial release.
Credits
The plugin icon, banner and screenshots are original work by Chat Radar, released under the GPLv2 or later together with the plugin.