Description
AI Kansoku Lab Tracker detects visits from AI-related crawlers such as GPTBot, ChatGPT-User, ClaudeBot, and PerplexityBot using PHP server-side detection.
AI crawlers often do not execute JavaScript, so JavaScript-based analytics tools such as GA4 may not record these visits as normal pageviews. This plugin helps site owners observe AI crawler activity at the server level.
Detected crawler visits are stored in your WordPress database. Optional external tracking is available only when you explicitly enable it in the settings page.
Features
- 14 AI-related crawler patterns – GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, Anthropic-AI, PerplexityBot, ByteSpider, Meta-ExternalAgent, AppleBot, DeepSeek, Grok, xAI, CopilotBot, and Google-Extended related access patterns
- Local crawler logging – Detected visits are stored in your WordPress database
- 30-day trend analysis – Dashboard with 30-day / 7-day period switching
- AI Exposure Score – Visibility score based on crawler activity
- Crawler breakdown – See which AI-related services visit your site most
- Top pages – Identify which pages AI crawlers focus on
- Explicit opt-in for external tracking – External transmission only activates when you enable it via checkbox
- Minimal performance impact – Optional external requests use non-blocking POST requests
- Front-end only – Does not fire on admin, cron, AJAX, or REST API requests
- WordPress standards – Uses wp_remote_post, register_setting, nonce verification, and proper escaping throughout
日本語の説明
AI Kansoku Lab Tracker は、GPTBot・ChatGPT-User・ClaudeBot・PerplexityBot などの AI 関連クローラーがあなたのサイトを訪問した記録を、WordPress 上で検知・可視化するプラグインです。
AI クローラーは JavaScript を実行しないことが多いため、GA4 などの JavaScript ベースのアクセス解析では通常のページビューとして記録されない場合があります。本プラグインは PHP によるサーバーサイド検知を採用し、AI クローラーの訪問をサーバーレベルで観測できるようにします。
検知したクローラーのログは WordPress のローカルデータベースに保存されます。外部トラッキングを有効にした場合のみ、AI観測ラボへデータを送信します。
主な機能:
- 14種類以上の AI 関連クローラーパターンを検知
- 検知ログを WordPress のローカルDBに保存
- 30日間のトレンド分析(7日間表示への切り替え対応)
- AI露出スコアによる可視化
- クローラー種別の内訳表示
- よく見られているページの可視化
- 外部トラッキングは明示的なオプトイン方式
- 管理画面・AJAX・REST API・WP-Cron では実行しない設計
開発・運営: AI観測ラボ
How It Works
When a front-end page is requested, the plugin checks the User-Agent string against known AI-related crawler patterns.
If a match is found, the detected visit is stored in your WordPress database.
If you have explicitly enabled external tracking and configured a Site ID, the plugin also sends an asynchronous POST request to the AI Kansoku Lab API. This optional external request uses a non-blocking request so that the site visitor experiences no delay.
External Services
This plugin may connect to the following external service:
AI Kansoku Lab
https://www.ai-kansoku.com
External tracking is opt-in only. Data is only transmitted after you explicitly enable external tracking in the plugin settings page.
When an AI-related crawler is detected and external tracking is enabled, the following data is sent to the AI Kansoku Lab API:
- User-Agent string of the detected crawler
- URL path of the visited page
- HTTP referer header, if present
- HTTP status code of the page, such as 200 or 404
- Site ID configured in the plugin settings
No personally identifiable information is collected. This plugin does not collect cookies, account credentials, form contents, or visitor IP addresses.
Service URL: https://www.ai-kansoku.com
Privacy Policy: https://www.ai-kansoku.com/privacy
Terms of Service: https://www.blog.ai-kansoku.com/terms
Requirements
- WordPress 6.0 or higher
- PHP 7.4 or higher
A free AI Kansoku Lab account is optional and only required if you want to use the external dashboard integration.
Privacy Policy
This plugin stores detected crawler visits in your WordPress database.
This plugin can also connect to an external service to log AI-related crawler visits in the AI Kansoku Lab dashboard.
External tracking is opt-in only and only activates after explicit user consent via the settings page.
Data transmitted to AI Kansoku Lab when external tracking is enabled:
- User-Agent string of the detected crawler
- URL path of the visited page
- HTTP referer header, if present
- HTTP status code of the page, such as 200 or 404
- Site ID configured in plugin settings
No personally identifiable information is collected. This plugin does not collect cookies, account credentials, form contents, or visitor IP addresses.
Full privacy policy: https://www.ai-kansoku.com/privacy
Installation
- Upload the plugin ZIP via Plugins > Add New > Upload Plugin
- Activate the plugin
- Go to Settings > AI Kansoku Lab
- Review the local crawler tracking dashboard
- Optional: Enter your Site ID from https://www.ai-kansoku.com/dashboard
- Optional: Check “Enable external tracking to AI Kansoku Lab”
- Click Save Settings
FAQ
-
Where do I find my Site ID?
-
Log in to AI Kansoku Lab at https://www.ai-kansoku.com, register your site, and copy the Site ID shown in your dashboard.
A Site ID is only required if you want to enable external tracking and use the AI Kansoku Lab external dashboard.
-
Will this slow down my site?
-
The plugin performs a lightweight User-Agent check on front-end requests.
When external tracking is enabled, the plugin uses
wp_remote_postwithblockingset tofalse, so the optional HTTP request is fired asynchronously and does not delay page rendering. -
Does it run on every request?
-
No. The plugin is designed for front-end page requests only. Admin pages, AJAX calls, REST API requests, and WP-Cron jobs are excluded.
External tracking only runs when both a Site ID is set and external tracking is explicitly enabled.
-
Can it detect crawlers that do not run JavaScript?
-
Yes. That is the main purpose of this plugin. JavaScript-based analytics tools may miss crawlers that do not execute JavaScript. This plugin detects them at the PHP level using the HTTP_USER_AGENT server variable.
-
GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, Anthropic-AI, ByteSpider, Meta-ExternalAgent, Google-Extended, Grok, xAI, AppleBot, DeepSeek, CopilotBot, and PerplexityBot.
-
What data is stored locally?
-
Detected crawler visits are stored in your WordPress database. The stored data is used to show crawler trends, crawler breakdowns, top pages, and related dashboard information.
-
Is external tracking required?
-
No. Local crawler logging works without enabling external tracking.
External tracking is optional and only activates when you explicitly enable it in the plugin settings page.
-
What happens when I uninstall the plugin?
-
All plugin settings stored in the WordPress database are removed automatically on uninstall.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“AI Kansoku Lab Tracker” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “AI Kansoku Lab Tracker” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.4.7
- Added: 30-day dashboard view as default, previously 7-day only
- Added: Period switching UI with 30-day / 7-day toggle on dashboard
- Improved: KPI cards, charts, and crawler breakdown now respond to period selection
- Improved: Score calculation normalized by daily average for consistent scoring across periods
- Improved: Status panel shows accurate state when no data is available
- Fixed: Insight spike detection now uses actual 7-day data regardless of selected period
1.4.6
- Fixed: secret_key was not saved correctly in some environments
- Fixed: Settings page CSS/JS loading issue in some environments
1.4.5
- Fixed: Local crawler logging now works without external service connection
- Improved: REST API authentication moved to permission_callback with site_id and secret_key verification
- Improved: External API transmission only occurs when site_id is configured
1.4.0
- Removed all PRO/free feature restrictions
- Removed Stripe payment integration
- Removed AI citation checker
- Replaced Chart.js CDN with locally bundled file
- Removed inline script/style output
- Improved output escaping throughout
- Updated readme to disclose transmitted data fields including referer and status_code
1.0.6
- Renamed plugin to Kansoku Lab Tracker for WordPress.org guidelines compliance
- Updated all prefixes from AIK_ to AIKLAB_
- Replaced inline style block with proper enqueued styles
- Updated Terms of Service URL
1.0.4
- Replaced HTML-mixed echo with PHP template syntax in status panel
- Changed Tested up to from 6.9 to 6.8 for accuracy
1.0.3
- Changed hook from init to template_redirect for cleaner front-end-only targeting
- Removed redundant admin, cron, AJAX, and REST guards
- Replaced Markdown link syntax in readme with plain URLs for better compatibility
1.0.2
- Added explicit opt-in checkbox for external tracking
- Unified all URLs to https://www.ai-kansoku.com
- Refined crawler regex
- Updated privacy wording to accurately reflect transmitted data
- Status panel now shows tracking state
1.0.1
- Changed tracking from GET to POST request
- Increased timeout from 0.1s to 1s for better reliability
- Restricted tracking to front-end requests only
- Added explicit External API Notice in settings page
- Added uninstall.php to clean up database options on removal
1.0.0
- Initial release