Bluerails Agent Traffic Capture
WordPress plugin: AI-bot crawl-traffic capture for Bluerails Discovery Agent Traffic (BLUE-1346)
by Bluerails · github.com/bluerails-2-0/bluerails-agent-traffic · website
★ 0stars
23release downloads
≈10active sites
0forks
Install
The author publishes release zips, so WP-CLI can install straight from GitHub:
wp plugin install https://github.com/bluerails-2-0/bluerails-agent-traffic/releases/download/v1.3.2/bluerails-agent-traffic.zipDeclares an update source (https://github.com/Bluerails-2-0/bluerails-agent-traffic), so updates arrive through the plugin's own updater.
From the readme
Bluerails Agent Traffic Capture
WordPress plugin that detects AI-bot crawler traffic (GPTBot, ClaudeBot, PerplexityBot, etc.)
on a WordPress site and reports it into your Bluerails Discovery Agent Traffic dashboard —
an additional ingestion method for hotel customers who have no server or CDN log access
(Linear: BLUE-1346).
Install via wp-admin (Plugins → Add New → Upload Plugin, zip upload) or a WP.org listing.
No build step, no Composer, no npm — plain PHP, installable as-is.
What it does
1. Hooks wploaded (not templateredirect — see "Why wploaded" below) on every
front-end request.
2. Checks $SERVER['HTTPUSERAGENT'] against a static, local list of known AI-crawler
substrings (see includes/class-bluerails-bot-detector.php).
3. On a match, builds a small JSON payload (bot name, matched UA substring, page path/URL,
timestamp, referer) and sends it to your configured ingest endpoint via wpremotepost()
with blocking = false — this never delays or blocks the page response for the visitor
(or bot) that triggered it.
4. If the UA matches nothing, checks $SERVER['HTTPREFERER'] against a small allow-list of
AI-assistant domains (ChatGPT, Perplexity, Claude, Gemini —
Read the full README on GitHub →
Releases
| Tag | Published | Asset | Downloads |
|---|---|---|---|
| v1.3.2 | Aug 31, 2026 | bluerails-agent-traffic-1.3.2.zip | 1 |
| v1.3.2 | Aug 31, 2026 | bluerails-agent-traffic.zip | 5 |
| v1.3.1 | Aug 31, 2026 | bluerails-agent-traffic.zip | 2 |
| v1.3.1 | Aug 31, 2026 | bluerails-agent-traffic-1.3.1.zip | 0 |
| v1.3.0 | Aug 31, 2026 | bluerails-agent-traffic.zip | 0 |
| v1.3.0 | Aug 31, 2026 | bluerails-agent-traffic-1.3.0.zip | 0 |
| v1.2.0 | Aug 29, 2026 | bluerails-agent-traffic-1.2.0.zip | 0 |
| v1.2.0 | Aug 29, 2026 | bluerails-agent-traffic.zip | 7 |
| v1.0.0 | Aug 24, 2026 | bluerails-agent-traffic-1.0.0.zip | 8 |
Active-site estimate ≈10 comes from the v1.0.0 cohort. Method.