{"id":390248,"date":"2026-11-17T17:51:52","date_gmt":"2026-11-17T17:51:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/realbots\/"},"modified":"2026-11-17T17:51:25","modified_gmt":"2026-11-17T17:51:25","slug":"botledger","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/botledger\/","author":17591686,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"0.3.2","stable_tag":"0.3.2","tested":"7.1.4","requires":"6.2","requires_php":"7.4","requires_plugins":null,"header_name":"BotLedger \u2013 Verified AI Bot Analytics","header_author":"lamak25","header_description":"See which AI crawlers (GPTBot, ClaudeBot, PerplexityBot\u2026) really visit your site. Every AI-bot request is checked against the operator's official IP ranges, so fakes are filtered out. Also counts visitors sent by AI assistants.","last_updated":"2026-11-17 17:51:25","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/botledger.website\/","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":19,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":{"0.3.2":{"tag":"0.3.2","author":"lamak25","date":"2026-11-17 17:51:25","revision":3807923}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3807923,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3807923,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3807923,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3807923,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.3.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3807923,"resolution":"1","location":"assets","locale":"","width":1280,"height":900}},"screenshots":{"1":"Dashboard: verified vs fake AI-bot visits, per-bot breakdown, pages real AI crawlers read, visitors sent by AI assistants."}},"plugin_section":[],"plugin_tags":[264107,232,22770,9837,247966],"plugin_category":[36],"plugin_contributors":[293448],"plugin_business_model":[],"class_list":["post-390248","plugin","type-plugin","status-publish","hentry","plugin_tags-ai-bots","plugin_tags-analytics","plugin_tags-bot-detection","plugin_tags-crawler","plugin_tags-gptbot","plugin_category-analytics","plugin_contributors-lamak25","plugin_committers-lamak25"],"banners":{"banner":"https:\/\/ps.w.org\/botledger\/assets\/banner-772x250.png?rev=3807923","banner_2x":"https:\/\/ps.w.org\/botledger\/assets\/banner-1544x500.png?rev=3807923","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/botledger\/assets\/icon-128x128.png?rev=3807923","icon_2x":"https:\/\/ps.w.org\/botledger\/assets\/icon-256x256.png?rev=3807923","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/botledger\/assets\/screenshot-1.png?rev=3807923","caption":"Dashboard: verified vs fake AI-bot visits, per-bot breakdown, pages real AI crawlers read, visitors sent by AI assistants."}],"raw_content":"<!--section=description-->\n<p>Anyone can put \"GPTBot\" or \"ClaudeBot\" in a request. On real servers a large share of \"AI bot\" traffic is vulnerability scanners in disguise. This plugin checks every AI-bot visit against the IP ranges that OpenAI, Anthropic, Perplexity, Google, Microsoft, Apple, Common Crawl, DuckDuckGo and Mistral publish, and shows you:<\/p>\n\n<ul>\n<li>Real vs fake visits per AI bot (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-SearchBot, PerplexityBot, Google-Extended, Amazonbot, Meta and more)<\/li>\n<li>Which pages verified AI crawlers read<\/li>\n<li>Visitors sent to you by AI assistants (ChatGPT, Perplexity, Claude, Gemini, Copilot\u2026)<\/li>\n<li>Signed AI agents: verifies Web Bot Auth (IETF draft, HTTP Message Signatures) signatures from agents that sign their requests<\/li>\n<li>Optional: block fake AI bots (safe \u2014 a genuine request from the operator can't fail the IP check)<\/li>\n<\/ul>\n\n<p>Crawlers don't run JavaScript, so script-based analytics can't see them. This plugin runs on your server and stores only daily counts in your own database.<\/p>\n\n<h4>External services<\/h4>\n\n<p>Nothing is downloaded until you switch it on in Tools \u2192 AI Bot Analytics \u2192 Settings. There are two separate options, both off by default:<\/p>\n\n<ul>\n<li><p>\"Download the bot list\": once a day, the bot list (<code>https:\/\/botledger.website\/data\/v1\/ranges.json<\/code>): bot names, user-agent patterns and the operators' official IP ranges. No visitor data is sent; it's a plain download. The request shows your server's IP address and the user-agent <code>BotLedger\/&lt;version&gt;<\/code> (not your site address or WordPress version). <a href=\"https:\/\/botledger.website\/privacy\">Privacy policy<\/a>, <a href=\"https:\/\/botledger.website\/terms\">terms<\/a>.\nThe same file also contains Cloudflare's published edge IP ranges, so the real visitor IP can be read safely when your site is behind Cloudflare.<\/p><\/li>\n<li><p>\"Check signed AI agents\": when a request carries a Web Bot Auth signature, the plugin downloads that agent's public key directory from the HTTPS address the agent names (<code>https:\/\/&lt;agent host&gt;\/.well-known\/http-message-signatures-directory<\/code>) to check the signature. Because the address comes from the incoming request, any visitor can make your server look up a host they choose; only that public file is requested, with the user-agent <code>BotLedger\/&lt;version&gt;<\/code> (no site address, WordPress version or visitor data), and the host sees your server's IP address. Requests to private\/internal addresses are refused, results are cached for a day, and at most 20 new agents are looked up per hour.<\/p><\/li>\n<\/ul>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20it%20slow%20my%20site%20down%3F\"><h3>Does it slow my site down?<\/h3><\/dt>\n<dd><p>Normal visitors only cost one string check. AI-bot requests add one small database write.<\/p><\/dd>\n<dt id=\"my%20bots%20all%20show%20as%20%22can%27t%20verify%22\"><h3>My bots all show as \"can't verify\"<\/h3><\/dt>\n<dd><p>Your site is behind a proxy or CDN that hides the visitor IP. Make sure it forwards the client IP (CF-Connecting-IP or X-Forwarded-For).<\/p><\/dd>\n<dt id=\"is%20google-extended%20a%20crawler%3F\"><h3>Is Google-Extended a crawler?<\/h3><\/dt>\n<dd><p>No. Google documents it as a robots.txt token without its own user agent, so requests claiming it are counted as fake.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>0.3.2<\/h4>\n\n<ul>\n<li>Bot list and links now use the project's own domain, botledger.website.<\/li>\n<\/ul>\n\n<h4>0.3.1<\/h4>\n\n<ul>\n<li>Shorter primary key for the stats table (works on older MySQL with the 767-byte index limit).<\/li>\n<li>Own downloads send the user-agent BotLedger\/ instead of WordPress's default (no site address).<\/li>\n<li>Agent key lookups are a separate opt-in setting; stricter validation of request headers.<\/li>\n<\/ul>\n\n<h4>0.3.0<\/h4>\n\n<ul>\n<li>Renamed to BotLedger \u2013 Verified AI Bot Analytics.<\/li>\n<li>Remote downloads (bot list, agent key directories) only after the admin switches them on in Settings.<\/li>\n<\/ul>\n\n<h4>0.2.0<\/h4>\n\n<ul>\n<li>Verify Web Bot Auth signatures (Ed25519) from signed AI agents; new dashboard section.<\/li>\n<\/ul>\n\n<h4>0.1.1<\/h4>\n\n<ul>\n<li>All admin strings translatable.<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"See which AI bots really visit your site: GPTBot, ClaudeBot and others checked against official IP ranges, fakes filtered out.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/390248","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=390248"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/lamak25"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=390248"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=390248"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=390248"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=390248"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=390248"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=390248"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}