Description
AI bots are on your website right now. This plugin shows you which ones, and which pages they read.
GPTBot, ClaudeBot, PerplexityBot, OAI-SearchBot and Google-Extended crawl your pages every day. What they take feeds the answers ChatGPT, Perplexity, Gemini and Google’s AI surfaces give to millions of people.
Your analytics tool shows none of it. Bot traffic is filtered out by design.
So the crawl that decides whether your brand shows up in an AI answer is the one source of traffic you cannot see.
Agent Analytics makes it visible.
What you get
Every AI agent request to your site, captured as it happens and sent to your OtterlyAI brand report. Three views:
- Overview: total agent visits, pages crawled, top engines, trends over time, and your most-crawled URLs broken down per engine
- Pages: a searchable list of every URL agents have hit, with visit counts and engine distribution
- Agents: a catalog of every bot identified on your site, categorized and counted
What you can do with it
- See whether the pages you want cited are the pages AI actually reads
- Catch the opposite problem: bots burning crawl budget on pages that will never earn you a mention
- Spot an engine that stopped crawling you, before your visibility drops
- Prove to your team that AI traffic is real, with numbers from your own site
Requirements
An OtterlyAI account.
Note the plan needed, and whether the free tier covers this.
External service
This plugin sends data to OtterlyAI Agent Analytics (https://analytics.otterly.ai), a service operated by OtterlyAI. Nothing is sent until a site administrator saves an Agent Analytics key.
When something is sent: only for a request whose User-Agent matches one of the AI-agent signatures bundled with the plugin.
What is sent, for such a request — exactly five fields:
- the requested URL,
- the matched User-Agent string,
- the timestamp of the request,
- the referer, if the request had one,
- the HTTP response status the server returned for the request.
What is not sent: No IP address is collected or transmitted — the plugin does not read any IP header at all. No cookies. No visitor, user or account data. No page content. Nothing at all for ordinary visitor traffic.
The key itself is also sent, as an HTTP Authorization header, to authenticate the report and to check the key when you press Save and validate.
Service terms: https://otterly.ai/terms
Privacy policy: https://otterly.ai/privacy
The AI agent list
The list of AI-agent signatures is bundled with the plugin, not fetched from anywhere. It is kept current by publishing new plugin versions here, so updating the plugin is how you get newly-appeared crawlers.
Privacy
This plugin transmits request metadata for AI-agent traffic only, as listed under “External service” above. It stores one option in your database, containing your Agent Analytics key and the result of its last validation. That option is readable only by administrators, is never exposed to visitors or through the REST API, and is deleted when the plugin is uninstalled.
Installation
- Install and activate the plugin.
- In OtterlyAI, sign in and open General Data sources.
- Add WordPress as a logs provider for this site’s domain, and copy the Agent Analytics key it shows you.
- In WordPress, open Settings OtterlyAI, paste the key, and press Save and validate.
The status turns to Connected once OtterlyAI has confirmed the key. From then on, AI-agent requests are reported automatically.
FAQ
-
Where do I find my Agent Analytics key?
-
In OtterlyAI, under General Data sources: add WordPress as a logs provider and copy the key it gives you. The key is shown once, so copy it before you close the dialog.
-
Is this the same as my OtterlyAI REST API key?
-
No. The Agent Analytics key belongs to the WordPress data source and can only be used to report crawler requests. Your public REST API key is separate and is not used by this plugin.
-
Does it collect my visitors’ IP addresses?
-
No. The plugin never reads an IP header and never sends one.
-
It says “Not verified”. What does that mean?
-
Your key was saved, but no usable answer came back, so nothing is known about the key either way. Reporting stays active, because the key is probably fine. Press Save and validate again later to confirm it.
Common causes: a temporary network problem, an outbound firewall on your host, or the OtterlyAI validation service being briefly unavailable. The plugin deliberately reports this as “Not verified” rather than blaming your key, because a problem on our side must never look like a bad key.
-
It says OtterlyAI rejected my key.
-
The key is wrong, incomplete, or its data source was deleted in OtterlyAI. Copy it again from General Data sources. While a key is rejected, the plugin stops reporting rather than repeatedly sending requests that will be refused.
-
It says “Domain mismatch”.
-
Every Agent Analytics key belongs to one domain — the data source it was created for. The key you entered belongs to a different domain than this site, so crawler visits recorded here would be filed under that other domain, where you would never see them.
The key is not saved in this case, so nothing is reported until you enter the right one. In OtterlyAI, open General Data sources, add WordPress as a data source for this site’s own domain, and use the key it gives you.
-
It says “Domain not verified”.
-
OtterlyAI could not tell which domain this site is, so it did not save the key. Nothing is wrong with the key itself.
WordPress normally includes the site address in the requests it makes to other services. Something on this site is removing or rewriting it — most often a security or performance plugin that edits outgoing request headers, or a host that strips them. Disable that behaviour for outgoing requests and press Save and validate again.
-
Will it slow down my site?
-
No. Detection is a substring check against a bundled list, and the report is sent on the
shutdownhook — after the response has already been delivered — without waiting for a reply. -
How do I stop it?
-
Open Settings OtterlyAI, tick “Remove the saved key and stop reporting”, and save. Deactivating or deleting the plugin also stops it, and deleting it removes the stored key. Disabling the data source in OtterlyAI revokes the key on the server side.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“OtterlyAI Agent Analytics” is open source software. The following people have contributed to this plugin.
Contributors
Translate “OtterlyAI Agent Analytics” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- Reports now include the HTTP response status of the request, so pages an AI agent could not fetch are separated from pages that were served.
1.0.0
- First release. Configure your Agent Analytics key from Settings OtterlyAI, with server-side reporting of AI crawler requests.