RokthamBot

Description

RokthamBot is an AI bot management plugin for WordPress. It identifies, fingerprints, rate-limits, and blocks AI scrapers while protecting your search engine visibility. With 148+ AI bots in its database, per-bot policy controls, verified bot detection, emergency lockdown, and AI referral traffic tracking, RokthamBot gives you complete control over who accesses your content.

Why You Need This

AI crawlers including GPTBot, ClaudeBot, PerplexityBot, Bytespider, CCBot, and 140+ others scrape WordPress sites every day, causing:

  • CPU spikes from repeated database queries
  • Bandwidth bloat from automated scraping
  • Content theft — your content used to train AI models without consent
  • Rising hosting costs from bot traffic

robots.txt is advisory only — AI bots can choose to ignore it. RokthamBot enforces real technical blocks.

Free Features

  • 148+ AI Bot Detection and Blocking — Pre-loaded with GPTBot, ClaudeBot, PerplexityBot, Bytespider, CCBot, and 140+ others from OpenAI, Anthropic, Google, Meta, Amazon, ByteDance, Perplexity, Cohere, Mistral, and more
  • Per-Bot Policy Controls — Allow / Block / Log Only / Use Default for each bot independently
  • Master “Block All AI Bots” Panic Button — One-click blanket block for all detected AI crawlers
  • Emergency Lockdown Mode (HTTP 451) — Instantly lock down your entire site with a single action, returning HTTP 451 (Unavailable For Legal Reasons)
  • IP and User Agent Whitelist (CIDR Support) — Whitelist trusted IPs using CIDR notation and specific User-Agent strings
  • Verified Bot Detection — Multi-layer verification using IP ranges and reverse-DNS lookup to confirm bot identity
  • “Block Only Fakes” Feature — Automatically block spoofed bots while allowing verified real ones through
  • AI Referral Traffic Tracking — Track referrals from ChatGPT, Perplexity, Gemini, Claude, Copilot, Meta AI, and other AI-powered services
  • robots.txt Manager with Live Preview — Manage and preview your robots.txt rules directly from the admin
  • Per-Page Protection Control — Enable or disable bot protection on individual pages via a meta box in the editor
  • Content Poisoning for AI Scrapers — Serve corrupted data to detected scrapers to degrade training value
  • Rate Limiting per Bot Category — Apply sliding window rate limits with exponential backoff per bot category
  • Search Engine Visibility Guard — Google, Bing, DuckDuckBot, Applebot, and YandexBot protected from accidental blocks
  • CDN Auto-Detection — Auto-detect Cloudflare, AWS CloudFront, Bunny CDN, Fastly, Sucuri, Akamai, StackPath, and KeyCDN
  • AI Readiness Score Diagnostic — Get a 0-100 score evaluating how well your site is prepared for the AI era
  • RSL 1.0 Machine-Readable Licensing Framework — Define machine-readable licensing terms for AI consumption
  • Meta Tags Protection — Automatic noai and noimageai meta tags to signal AI restrictions
  • WooCommerce Product Protection — Dedicated protection for WooCommerce product pages and REST API endpoints
  • Email Notification System — Blocked alert notifications and daily digest summaries
  • REST API Endpoints — Programmatic access to bot analytics, policies, and controls
  • WP-CLI Commands — Manage bot policies and view analytics from the command line
  • Setup Wizard for First-Time Configuration — Guided onboarding with CDN detection, policy selection, and search engine protection
  • Admin Dashboard with Traffic Analytics — Real-time stats with hero cards showing blocked, allowed, and logged bot traffic
  • Bot Control Panel with Per-Bot Policy Management — Dedicated panel for managing individual bot policies
  • Search Engine Monitor — Verify Googlebot, Bingbot, and other search engine access in real-time
  • Full Multisite Support — Managed per-site or synced across the network using JSON export/import
  • Clean Uninstall — Removes all data completely when the plugin is deleted

How It Works

  1. Install & Activate — No configuration required for basic protection
  2. Run Setup Wizard — CDN detection, default policy selection (60 seconds)
  3. Monitor Dashboard — See AI bot traffic in real-time
  4. Adjust Policies — Per-bot Allow/Block/Log-only controls

Per-Bot Granular Control

One company runs multiple crawlers. OpenAI alone operates GPTBot (training), OAI-SearchBot (search), and ChatGPT-User (live fetch). Blocking one does not block the others. RokthamBot lists each bot separately so you can:

  • Block training data extraction (GPTBot)
  • Allow search indexing (OAI-SearchBot)
  • Monitor live fetches (ChatGPT-User)

Search Engine Protection

Search engines (Googlebot, Bingbot, Applebot, DuckDuckBot, YandexBot) are protected by default. Their policy dropdowns are locked. To override, you must explicitly disable the Search Engine Guard in Settings with a warning.

Verified Bot Detection

RokthamBot goes beyond User-Agent string matching. It verifies bots using IP ranges and reverse-DNS lookup (FCrDNS) to confirm the bot is actually who it claims to be. Spoofed bots are flagged and can be blocked separately using the “Block Only Fakes” feature.

Emergency Lockdown

When you need to instantly shut down all AI bot access, Emergency Lockdown mode blocks all AI crawlers and returns HTTP 451 (Unavailable For Legal Reasons). This is ideal for legal disputes or when you need to stop scraping immediately.

AI Referral Traffic Tracking

Track which AI-powered services are sending traffic to your site. RokthamBot tracks referrals from ChatGPT, Perplexity, Gemini, Claude, Copilot, Meta AI, and other AI services, giving you insight into AI-driven discovery.

Privacy & Security

  • All bot detection works locally — DNS verification uses your server’s resolver (see External Services above)
  • IP addresses can be anonymized in logs
  • No data is sent to third parties
  • Clean uninstall removes all data

External Services

This plugin performs DNS lookups (reverse DNS verification) to verify bot authenticity through FCrDNS (Forward-Confirmed reverse DNS). This is used by the “Verified Bot Detection” feature to confirm that claimed bots are genuine.

What data is sent: IP addresses of incoming requests are looked up via DNS to verify bot identity.
When: Only when a known bot (GPTBot, ClaudeBot, PerplexityBot, etc.) makes a request to your site.
Service: Standard DNS resolution (no third-party service; uses your server’s configured DNS resolver).
This lookup is passive and does not send any user data to external servers.

Third Party Domain Verification

For FCrDNS verification, the plugin checks that bot IP addresses resolve to domains owned by the bot operator. The following domain patterns are used for verification:

  • OpenAI: openai.com, azure.com
  • Anthropic: anthropic.com, amazonaws.com
  • Google: googlebot.com, google.com, googlehosted.com
  • Microsoft: search.msn.com, bing.com, microsoft.com
  • Perplexity: perplexity.ai, perplexity.com
  • Meta: facebook.com, fb.com, meta.com
  • Apple: apple.com, applebot.ai
  • Amazon: amazonaws.com, amazon.com
  • Yandex: yandex.net, yandex.ru, yandex.com
  • DuckDuckGo: duckduckgo.com
  • ByteDance: bytedance.com, byteoversea.com
  • Common Crawl: commoncrawl.org

These domain checks are performed locally on your server using standard DNS resolution. No data is transmitted to these services.

Privacy

RokthamBot does not collect, store, or transmit any personal data. All bot detection and rate limiting runs entirely on your local server. No external API calls are made. IP addresses can be anonymized in logs through the plugin settings. The plugin stores only bot traffic logs locally in the WordPress database. You have full control over data retention and can purge logs at any time. When the plugin is uninstalled, all data is completely removed.= Minimum Requirements =

  • WordPress 5.8 or higher
  • PHP 7.4 or higher
  • MySQL 5.6 or higher

Credits

RokthamBot is developed and maintained by Muhammad Sadiq Ali.

Contributing

Bug reports and contributions are welcome via the plugin’s GitHub repository.

Installation

  1. Download the RokthamBot plugin zip file.
  2. Log in to your WordPress admin dashboard.
  3. Navigate to Plugins > Add New and click Upload Plugin.
  4. Choose the downloaded zip file and click Install Now.
  5. Click Activate Plugin after installation completes.
  6. The Setup Wizard will auto-launch on first activation.
  7. Follow the wizard: CDN detection, policy selection, search engine protection, and summary.
  8. Wait 2-6 hours for AI bot hits to populate the dashboard.

FAQ

What is RokthamBot?

RokthamBot is a comprehensive AI bot management plugin for WordPress. It detects, blocks, and logs 148+ AI crawlers including GPTBot, ClaudeBot, PerplexityBot, Bytespider, and many others. It provides per-bot policy controls, verified bot detection, emergency lockdown, and AI referral traffic tracking.

How does bot blocking work?

RokthamBot intercepts incoming requests and identifies the bot using a multi-layer approach: User-Agent string matching, IP range verification (CIDR), and forward-confirmed reverse DNS (FCrDNS) verification. Once a bot is identified, the configured policy (Allow, Block, Log Only) is applied. Blocks are enforced at the server level before any WordPress processing occurs.

Will blocking AI bots affect my search rankings?

No. Search engines including Google, Bing, DuckDuckBot, Applebot, and YandexBot are protected by default. Their policies are locked to “Allow” and cannot be accidentally changed. You must explicitly disable the Search Engine Guard to block search engines, which requires a confirmation warning.

What is the panic button?

The “Block All AI Bots” panic button is a master toggle that immediately blocks all detected AI crawlers when activated. It overrides individual bot policies and provides instant blanket protection. It is useful when you notice a sudden surge in scraping or want to stop all AI access immediately.

What is Emergency Lockdown?

Emergency Lockdown mode blocks all AI bot access and returns HTTP 451 (Unavailable For Legal Reasons) for every request from an identified AI crawler. This is the most aggressive protection mode and is useful during legal disputes, when you need to stop scraping immediately, or when you want to send a clear signal that your content is not available for AI use.

What is Verified Bot Detection?

Verified Bot Detection uses multiple verification layers to confirm a bot’s identity beyond just the User-Agent string. It checks the bot’s IP against known IP ranges and performs reverse-DNS lookup to verify the connection is legitimate. This prevents spoofed bots from bypassing your protections by impersonating legitimate crawlers.

What is “Block Only Fakes”?

“Block Only Fakes” is a feature that leverages Verified Bot Detection to allow legitimate, verified bots while blocking spoofed ones. If a bot claims to be GPTBot but fails verification (IP doesn’t match OpenAI ranges, reverse-DNS doesn’t resolve correctly), it is flagged as fake and blocked. Verified bots are allowed through based on their configured policy.

Does it work with WooCommerce?

Yes. RokthamBot includes dedicated WooCommerce product protection. It detects and manages bot access to WooCommerce product pages and REST API endpoints, preventing AI scrapers from harvesting product data, pricing, and descriptions.

Does it work with Cloudflare?

Yes. RokthamBot auto-detects Cloudflare and provides specific guidance on which Cloudflare settings to keep and which to disable for optimal AI bot management. It also auto-detects AWS CloudFront, Bunny CDN, Fastly, Sucuri, Akamai, StackPath, and KeyCDN.

What is AI Referral Tracking?

AI Referral Tracking monitors traffic coming to your site from AI-powered services including ChatGPT, Perplexity, Gemini, Claude, Copilot, Meta AI, and others. This helps you understand how AI services are driving discovery and traffic to your content, so you can make informed decisions about which AI bots to allow or block.

How do I whitelist an IP?

Navigate to the IP Whitelist section in RokthamBot settings. You can add individual IP addresses or CIDR ranges (e.g., 192.168.1.0/24). You can also whitelist specific User-Agent strings. Whitelisted entries bypass all bot detection and blocking rules.

Is it GDPR compliant?

Yes. RokthamBot is fully GDPR compliant. All bot detection and rate limiting runs locally on your server with no external API calls. No personal data is transmitted to third parties. IP addresses can be anonymized in logs through plugin settings. You have full control over data retention and can purge logs at any time.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“RokthamBot” is open source software. The following people have contributed to this plugin.

Contributors

Translate “RokthamBot” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0.0

  • 148+ AI bot database with GPTBot, ClaudeBot, PerplexityBot, Bytespider, and 140+ others
  • Per-bot policy controls (Allow / Block / Log Only / Use Default)
  • Master “Block All AI Bots” panic button
  • Emergency Lockdown mode with HTTP 451 responses
  • IP and User Agent whitelist with CIDR support
  • Verified Bot Detection (IP ranges + reverse-DNS verification)
  • AI Referral Traffic tracking (ChatGPT, Perplexity, Gemini, Claude, Copilot, Meta AI)
  • robots.txt Manager with live preview
  • Per-page protection control via editor meta box
  • Content poisoning for AI scrapers
  • Rate limiting per bot category
  • Search Engine Visibility Guard for Google, Bing, DuckDuckBot
  • AI Readiness Score diagnostic (0-100)
  • RSL 1.0 machine-readable licensing framework
  • Meta tags protection (noai, noimageai)
  • WooCommerce product protection
  • Email notification system (blocked alerts + daily digest)
  • REST API endpoints for programmatic access
  • WP-CLI commands for command-line management
  • Setup wizard for first-time configuration
  • Admin dashboard with traffic analytics
  • Bot control panel with per-bot policy management
  • Search engine monitor
  • Full multisite support
  • Clean uninstall (removes all data)