{"id":398515,"date":"2026-11-03T23:28:32","date_gmt":"2026-11-03T23:28:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/referenced-ai-crawler-tracking\/"},"modified":"2026-11-04T00:52:38","modified_gmt":"2026-11-04T00:52:38","slug":"referenced-ai-crawler-tracking","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/referenced-ai-crawler-tracking\/","author":23598635,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.1.4","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Referenced \u2013 AI Crawler Tracking","header_author":"Referenced","header_description":"Counts visits from known AI crawlers and reports daily totals to Referenced.","assets_banners_color":"ee6c4d","last_updated":"2026-11-04 00:52:38","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/Referenced-AI\/referenced-ai-crawler-tracking","header_author_uri":"https:\/\/getreferenced.ai","rating":0,"author_block_rating":0,"active_installs":0,"downloads":154,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"referenced","date":"2026-11-04 00:52:38","revision":3782885}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3782885,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3782885,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3782885,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3782885,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3782885,"resolution":"1","location":"assets","locale":"","width":1575,"height":1966},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3782885,"resolution":"2","location":"assets","locale":"","width":1575,"height":1780},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3782885,"resolution":"3","location":"assets","locale":"","width":1008,"height":426}},"screenshots":{"1":"Settings \u2192 Referenced: what the plugin sends, your connection status, and the AI crawlers that visited in the last 7 days.","2":"Every AI crawler that visited in the last 7 days, with its visits and how many pages it read.","3":"The dashboard widget: AI crawler visits this week at a glance."}},"plugin_section":[262246],"plugin_tags":[2353,232,4866,12928,186],"plugin_category":[36,55],"plugin_contributors":[290589,290588],"plugin_business_model":[],"class_list":["post-398515","plugin","type-plugin","status-publish","hentry","plugin_section-dashboard-widgets","plugin_tags-ai","plugin_tags-analytics","plugin_tags-bots","plugin_tags-crawlers","plugin_tags-seo","plugin_category-analytics","plugin_category-seo-and-marketing","plugin_contributors-bmillerz","plugin_contributors-referenced","plugin_committers-bmillerz","plugin_committers-referenced"],"banners":{"banner":"https:\/\/ps.w.org\/referenced-ai-crawler-tracking\/assets\/banner-772x250.png?rev=3782885","banner_2x":"https:\/\/ps.w.org\/referenced-ai-crawler-tracking\/assets\/banner-1544x500.png?rev=3782885","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/referenced-ai-crawler-tracking\/assets\/icon-128x128.png?rev=3782885","icon_2x":"https:\/\/ps.w.org\/referenced-ai-crawler-tracking\/assets\/icon-256x256.png?rev=3782885","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/referenced-ai-crawler-tracking\/assets\/screenshot-1.png?rev=3782885","caption":"Settings \u2192 Referenced: what the plugin sends, your connection status, and the AI crawlers that visited in the last 7 days."},{"src":"https:\/\/ps.w.org\/referenced-ai-crawler-tracking\/assets\/screenshot-2.png?rev=3782885","caption":"Every AI crawler that visited in the last 7 days, with its visits and how many pages it read."},{"src":"https:\/\/ps.w.org\/referenced-ai-crawler-tracking\/assets\/screenshot-3.png?rev=3782885","caption":"The dashboard widget: AI crawler visits this week at a glance."}],"raw_content":"<!--section=description-->\n<p>Referenced \u2013 AI Crawler Tracking counts visits from known AI crawlers, such as GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot and Googlebot, and posts hourly day totals to your Referenced AI account. You can then see which AI engines are reading which pages of your site.<\/p>\n\n<p>The plugin is a reporter only. It writes nothing to your pages or content, and it records no visitor data: no IP addresses, cookies or user accounts. For each known crawler it keeps a count per bot, path and day in one small table of its own.<\/p>\n\n<p>You need a <a href=\"https:\/\/getreferenced.ai\">Referenced AI<\/a> account and a connection token. Until you save a token, nothing is sent anywhere.<\/p>\n\n<h3>External Services<\/h3>\n\n<p>This plugin sends crawler visit totals to <a href=\"https:\/\/getreferenced.ai\">Referenced AI<\/a>, the service whose account you connect it to.<\/p>\n\n<ul>\n<li>Service: <a href=\"https:\/\/getreferenced.ai\">Referenced AI<\/a><\/li>\n<li>Endpoint: https:\/\/getreferenced.ai\/api\/ingest\/bot-hits<\/li>\n<li>What is sent: the bot name, the page path, the date, the visit count, the plugin version, the WordPress version and your site's home URL.<\/li>\n<li>When: once an hour, and when you press \"Send now\" on Settings \u2192 Referenced. Nothing is sent until a connection token has been saved.<\/li>\n<\/ul>\n\n<p>Privacy policy: <a href=\"https:\/\/getreferenced.ai\/privacy\">getreferenced.ai\/privacy<\/a>\nTerms of service: <a href=\"https:\/\/getreferenced.ai\/terms\">getreferenced.ai\/terms<\/a><\/p>\n\n<h3>Credits<\/h3>\n\n<ul>\n<li>Geist and Geist Mono fonts, SIL Open Font License 1.1 (see assets\/fonts\/OFL.txt).<\/li>\n<li>Interface icons from Heroicons, MIT licence, copyright Tailwind Labs, Inc.<\/li>\n<li>AI company logos from Lobe Icons, MIT licence, copyright 2023 LobeHub; the Amazon mark is from Simple Icons, CC0.<\/li>\n<li>Full notices are in THIRD-PARTY-NOTICES.txt. The logos belong to their respective owners and are used only to identify those crawlers.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin zip under Plugins \u2192 Add New \u2192 Upload Plugin, or install it from Plugins \u2192 Add New once it is listed. Then activate it.<\/li>\n<li>In Referenced AI, open Settings \u2192 Connections and create a WordPress token.<\/li>\n<li>In WordPress, open Settings \u2192 Referenced and paste the token.<\/li>\n<li>The first report arrives within about an hour of your site's next visits (WordPress runs scheduled tasks on traffic). Use \"Send now\" in Settings \u2192 Referenced to send at once.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"why%20do%20some%20crawler%20visits%20not%20appear%3F\"><h3>Why do some crawler visits not appear?<\/h3><\/dt>\n<dd><p>Pages served from a full-page cache or a CDN never reach PHP, so the plugin cannot count them. Static files such as images, scripts and PDFs are served without PHP too, so they are not counted either. This is a known blind spot: the numbers are a floor, not an exact total.<\/p><\/dd>\n<dt id=\"what%20leaves%20my%20site%3F\"><h3>What leaves my site?<\/h3><\/dt>\n<dd><p>Only the following, and only after you have saved a token: the bot name, the page path, the date, the visit count, the plugin version, the WordPress version and your site's home URL. No visitor IP addresses, cookies, user agents or personal data are sent.<\/p><\/dd>\n<dt id=\"does%20it%20slow%20my%20site%20down%3F\"><h3>Does it slow my site down?<\/h3><\/dt>\n<dd><p>No. Each request costs a handful of cheap string comparisons (about twenty substring checks) and one small row write only when a known crawler matched.<\/p><\/dd>\n<dt id=\"why%20does%20every%20page%20show%20as%20%22%2F%22%20with%20plain%20permalinks%3F\"><h3>Why does every page show as \"\/\" with plain permalinks?<\/h3><\/dt>\n<dd><p>With plain permalinks (<code>\/?p=123<\/code>) the page is identified by its query string, and query strings are not sent. Every page is then reported as <code>\/<\/code>. Pretty permalinks (Settings \u2192 Permalinks) give each page its own path.<\/p><\/dd>\n<dt id=\"can%20i%20stop%20it%3F\"><h3>Can I stop it?<\/h3><\/dt>\n<dd><p>Yes. Use Disconnect on Settings \u2192 Referenced to remove the token and stop all reporting, or deactivate the plugin. Deleting the plugin removes its table and options.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release.<\/li>\n<\/ul>","raw_excerpt":"See which AI crawlers (GPTBot, ClaudeBot, PerplexityBot and more) read which pages of your site. No visitor data, no front-end changes.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/398515","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=398515"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/referenced"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=398515"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=398515"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=398515"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=398515"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=398515"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=398515"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}