EdgeShaping Lite – AI Bot Visibility vs Human Traffic
| 开发者 | mareinterno |
|---|---|
| 更新时间 | 2026年10月9日 13:41 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
EdgeShaping Lite is a WordPress implementation of the EdgeShaping AI bot observation framework developed by mare interno. Product details: edgeshap.ing
This plugin answers one question:
Which AI bots are reading which pages of your site, and when?What it does
- Detects AI bot visits using a dictionary of known AI crawlers
- Records bot name, visited URL, and timestamp
- Dashboard with bot visit frequency ranking and most AI-visited pages
- Full access log with date filter and CSV export
- AHQG Matrix — visualizes AI bot visits vs. human search clicks (requires Google Search Console integration)
- AHTG Matrix — visualizes AI bot visits vs. human page views (WordPress's own pageview tracking). Unlike AHQG, no Google Search Console connection required.
- It does not block AI bots
- It does not modify your content
- It does not send data externally — all data stays in your WordPress database
安装:
- Upload the plugin files to
/wp-content/plugins/edgeshaping-lite/or install via the WordPress plugin screen - Activate the plugin through the Plugins menu in WordPress
- Navigate to EdgeShaping Lite in the admin menu to view your dashboard
屏幕截图:
常见问题:
Does this plugin slow down my site?
The plugin adds a lightweight database write on each request matched to an AI bot. Non-bot traffic is not logged and has zero performance impact.
How often is the bot dictionary updated?
The dictionary is updated via plugin updates.
Can I export the data?
Yes. CSV export is available from the access log screen with date filter applied.
What about GDPR?
The plugin logs only requests whose User-Agent matches the bot dictionary: time, URL, User-Agent and IP address. The IP address is used to verify that a request really comes from the bot it claims to be. The plugin sets no cookies, does not track human visitors, and sends nothing externally. If you prefer not to store IP addresses, turn off "IP address recording" in Settings: stored IP addresses are deleted and none are stored from then on (bot verification is turned off as well).
What is the AHQG Matrix?
AHQG Matrix is a framework that classifies pages into four quadrants based on AI bot visits and human search clicks. Requires Google Search Console integration.
What is the AHTG Matrix?
AHTG Matrix uses the same four-quadrant model as AHQG, but the human axis is WordPress's own page views instead of Google Search Console clicks — no external connection required, and it reflects all traffic sources, not just search.
更新日志:
2026.10.0
- Changed: the bot dictionary now lists only crawlers that their operators officially document. Bots without an official statement are no longer recorded. Existing log entries are kept.
- Changed: the bots used for the AI axis of the AHQG/AHTG matrices follow the updated dictionary, so matrix results for past periods may differ from what you saw before.
- Added: on sites running the MCP Adapter plugin (WordPress 6.9+), a read-only ability
edgeshaping/get-dailylets an MCP client signed in as a user with the Contributor role or higher read the daily summary. The plugin itself still sends nothing externally. - Added: a setting to turn off IP address recording. Turning it off deletes all stored IP addresses; bot verification stops, and the dashboard and matrices then count every dictionary-matched visit.
- Fixed: uninstalling the plugin now removes all of its tables (they are kept while the other edition is installed).
- Fixed: unnecessary database work on every page load.
- Removed: the CDN period note on the dashboard and matrix screens.
- Added: IP verification support for CDN environments.
- Fixed: the dashboard summary tables now read from verified data.
- Fixed: Access Log and CSV export now output all rows, unfiltered.
- Changed: log cleanup is now unified with the daily aggregation batch.
- Changed: version numbering moved to CalVer (
YYYY.M.PATCH), since releases are driven by the monthly bot dictionary update. - Added: IP verification. Bot IP ranges published by each vendor are bundled with the plugin and matched against the recorded IP in the nightly batch. The dashboard and matrices now count only verified visits, so a request merely claiming to be a known crawler no longer inflates your numbers. The access log is unfiltered as before.
- Added: the client IP is now recorded for bot requests and shown in the access log and CSV export. Only bots matched by the dictionary are logged, so no visitor data is stored.
- Changed: the dashboard and matrices now end at yesterday, matching the nightly batch. The access log still shows today.
- Fixed: the dashboard scorecards included noise paths (robots.txt, sitemaps, archives) and did not match the tables below them.
- Changed: bot dictionary updated.
- Fixed: in the AHQG and AHTG matrices, the same page could appear as two separate rows (with and without a trailing slash), splitting its counts. Both axes are now normalized consistently.
- Fixed: category, author, and pagination archive URLs (e.g. /category/, /author/, /page/2/) are no longer mixed into the matrices.
- Changed: the top page is now excluded from both the AHQG and AHTG matrices (it always lands in the same quadrant and only skews the thresholds).
- Changed: the AHQG date range now ends a few days before today, because Search Console data for the most recent days is not yet final. This keeps the human axis from being understated.
- Added: Search Console click data is now imported once per day and stored in your WordPress database, so the human axis remains available even beyond Search Console's own retention window.
- Changed: expanded the spam/scan path filtering used by Inferred Path (dot-files, config files, API and GraphQL probes, etc.).
- Changed: bot dictionary reviewed and corrected; a few entries added and a few unverifiable ones removed.
- Fixed: the upsell notices shown for paid-edition-only screens (REST API, Category Analysis, Access Log detail) referenced an outdated API structure and pricing. Simplified to a generic notice pointing to the purchase page.
- Changed: internal bot-signature data file renamed (no functional change).
- Changed: increased the rolling row limit from 20,000 to 100,000.
- Changed: statistics are now pre-aggregated in a daily batch instead of being computed on every page view, improving admin screen performance.
- Added AHTG Matrix — visualizes AI bot visits vs. human page views. Unlike AHQG, no Google Search Console connection required.
- Added general-purpose bot exclusion list (SEO tools, uptime monitors, scrapers) to keep human traffic counts clean.
- Changed: increased the rolling row limit from 10,000 to 20,000.
- Fixed: full-page cache compatibility (WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed) — AI-crawler hits are now recorded reliably.
- Changed: previously-excluded noise paths (robots.txt, sitemap, etc.) are now kept in the access log instead of being discarded.
- Fixed: uninstalling this plugin while the paid edition is active no longer deletes shared observation data
- Bug fixes (i18n: missing translators comments, escaping, placeholder ordering)
- Bug fixes (internationalization: hardcoded strings wrapped in translation functions)
- Bug fixes (upsell links for paid edition, plugin URL correction)
- Bug fixes (plugin installation path correction, broken documentation link fix)
- Added Inferred Path detection (AI-visited URLs not in sitemap)
- Added Dark Pages detection (sitemap URLs with no AI or human traffic)
- Added sitemap fetching via robots.txt directive
- Added /category/, /tag/, /author/ to default exclude paths
- Added AHQG Matrix with Google Search Console integration
- Added date filter (7 days, 30 days, this month, last month, custom)
- Added CSV export
- Added settings screen for GSC OAuth connection
- Added automatic data cleanup (retention period and row limit)
- Updated bot dictionary to 2026.05 version
- Added path exclusion filter (robots.txt, sitemap, wp-, feed)
- Added data retention settings (120 days default)
- Added rolling row limit (10,000 rows default)
- Added date filter to dashboard and log
- Initial release