Adriano GEO Context and Crawl Monitor
| 开发者 | |
|---|---|
| 更新时间 | 2026年8月7日 03:12 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0.2 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
/ai-context.json endpoint (no physical files created) that serves a structured JSON summary of your site to AI crawlers. Includes site metadata, recent content, post types, and taxonomy information. Responses are cached via the WordPress object cache for optimal performance.
Module 2 – JSON-LD Semantic Markup
Automatically injects structured data (JSON-LD format) into your page <head>. Supported schemas include:
WebSitewith SearchActionOrganizationwith logoArticlewith author, publisher, and featured imageBreadcrumbListfor navigation contextFAQPageauto-detected from Gutenberg H3/paragraph blocks
/ai-context.json endpoint includes full, AI-readable content for every featured page or post:
- Full body text (HTML stripped, shortcodes rendered, truncated to a configurable length)
- Heading outline (H1–H4) for instant structural understanding
- Featured image URL
- Author, categories, tags, publish and modified dates
- Two modes: Automatic (most recently modified N pages) or Manual (Pro feature: pick exactly which pages to expose)
- Weekly Automated Email Digest: Scheduled WP-Cron HTML report featuring hit totals, week-over-week percentage change, top 3 crawlers, and full breakdown.
- White-Label Printable PDF Reports: Clean, print-optimized HTML report with agency branding and custom logo upload, printable directly to PDF from your browser.
- One-Click CSV Export: Download complete crawler visit logs as a CSV file for deep offline analysis.
- Total AI crawler hit count (unlimited in Free and Pro)
- Per-crawler breakdown with visual distribution bars (unlimited in Free and Pro)
- Recent log entries (last 25 for Free, last 1,000 for Pro)
- Export buttons for PDF/Print report and CSV download (Pro)
- One-click log clearing
- No phone home: Zero crawler tracking data is ever sent to external servers (all tracking logs remain strictly local)
- IP anonymization: SHA-256 hashing with subnet truncation (/24 IPv4, /48 IPv6) and site-specific salt (enabled by default)
- Storage limitation: Configurable log retention (7 days for Free, up to 10 years for Pro), automatically pruned via WP-Cron
- Right to erasure: Delete all data with one click or upon plugin uninstallation
- Data minimisation: Only necessary fields required for crawler analytics are stored
- Yoast SEO
- RankMath
- All in One SEO (AIOSEO)
- SEOPress When any of these plugins are active, Adriano GEO Context and Crawl Monitor automatically:
- Detects their presence and prevents injecting duplicate core schemas (such as WebSite, Article, and Breadcrumbs).
- Injects only AI-specific semantic metadata (
#ai-markupblock containing LLM targeting, context mapping, and structured entity associations) that traditional SEO plugins do not generate. - If no SEO plugin is active, Adriano GEO Context and Crawl Monitor injects full standard schemas (JSON-LD WebSite/Article) along with its AI-specific metadata.
- Total Hit Counter & Breakdown: Unlimited in both Free and Pro versions.
- Recent Event Log: Free shows the 25 most recent crawler hits; Pro shows up to 1,000 entries.
- Log Retention: Free is fixed at 7 days; Pro supports retention periods up to 10 years (3,650 days).
- Content Selection Mode: Free includes Automatic mode (most recently modified pages); Pro unlocks Manual mode to pick specific pages/posts.
- Weekly Email Report: Pro feature (automatically delivers weekly activity summary via email).
- Printable PDF Reports: Pro feature (generates white-label printable PDF reports with custom logo & agency name).
- CSV Export: Pro feature (export all crawler logs to CSV).
- WordPress Coding Standards compliant
- PHP 8.x compatible
- All database queries use
$wpdb->prepare()with placeholders - All inputs sanitized, all outputs escaped
- Nonce-protected AJAX handlers
register_activation_hook+dbDelta()for safe table creation & idempotent updates- Freemius SDK integration for license & opt-in management
安装:
- Upload the
adriano-geo-context-crawl-monitor-v2folder to the/wp-content/plugins/directory. - Activate the plugin through the 'Plugins' menu in WordPress.
- Navigate to GEO AIEngineer → Dashboard to view crawler stats.
- Go to GEO AIEngineer → Settings to configure modules and privacy options.
- Visit your site's
/ai-context.jsonURL to verify the endpoint is working.
/ai-context.json endpoint returns a 404, go to Settings → Permalinks and click Save Changes to flush rewrite rules.屏幕截图:
常见问题:
What is Generative Engine Optimization (GEO)?
GEO is the practice of optimizing your website's content and technical structure so that AI-powered search engines and LLMs (like ChatGPT, Perplexity, Claude, and Gemini) can better understand, index, and reference your content in their answers.
What does the AI context endpoint include?
The endpoint (/ai-context.json) returns a rich JSON document with:
- Site info: name, description, URL, language
- Featured content (configurable number of pages/posts): title, URL, dates, author, categories, tags, featured image, heading outline, and full body text (HTML-stripped)
- Recent posts: the 5 most recent articles in brief
- Content types and taxonomies registered on the site
Can I choose which pages appear in the endpoint?
In the Free version, the plugin automatically selects the N most recently modified published pages/posts (default 15) to include in the endpoint. The Pro version unlocks Manual selection mode, allowing you to choose exactly which pages or posts to expose.
How much body text is extracted per page?
The default is 1,500 characters per page. You can set any value from 200 to 10,000 characters in Settings → Content & Pages → Max Body Text Length. Longer values give AI crawlers more context but produce a larger JSON file.
Does this plugin conflict with Yoast SEO or RankMath?
No. Adriano GEO Context and Crawl Monitor automatically detects if Yoast SEO, RankMath, SEOPress, or All in One SEO are active, and skips injecting any JSON-LD schemas those plugins already handle (WebSite, Article, BreadcrumbList). There is no duplicate markup.
Does this plugin send crawler data to external servers?
No. All crawler logs and visitor analytics are stored exclusively in your WordPress database on your server. The optional Freemius SDK provides opt-in diagnostic & licensing telemetry compliant with WordPress.org guidelines.
What AI crawlers are tracked?
The plugin detects 19+ crawlers including: GPTBot (OpenAI/ChatGPT), ChatGPT-User, ClaudeBot and anthropic-ai (Anthropic), Google-Extended (Google Gemini), Googlebot, Bingbot (Microsoft Copilot), PerplexityBot, YouBot, CCBot, DataForSeoBot, Bytespider, PetalBot, Applebot, FacebookBot, LinkedInBot, Timpibot, DuckAssistBot, and Amazonbot.
How is GDPR compliance ensured?
IP addresses are never stored in plain text. When anonymization is enabled (default), the IP is truncated to the network subnet (/24 for IPv4, /48 for IPv6) and then hashed with SHA-256 using a site-specific salt. Logs are automatically pruned based on your configured retention period. A full GDPR notice and suggested Privacy Policy text are available in the plugin's Privacy page.
Can I customize the AI context endpoint URL?
Yes. Go to GEO AIEngineer → Settings and change the Endpoint Slug field. The URL will update accordingly. After saving, WordPress rewrite rules are flushed automatically.
What happens when I uninstall the plugin?
Upon uninstallation via WordPress, the plugin cleans up its database table, removes stored settings options, and unschedules all WP-Cron tasks, leaving your site clean.
更新日志:
- New: Automated Weekly Email Digest (Pro) with hit totals, week-over-week percentage change, top 3 crawlers, and full breakdown.
- New: White-Label Printable PDF/Print Reports (Pro) with custom logo upload and agency branding.
- New: One-click CSV Export (Pro) for offline log analysis.
- New: Manual Content Selection mode (Pro) allowing explicit page selection for the
/ai-context.jsonendpoint. - New: Expanded AI crawler detection to 19+ crawlers, adding
DuckAssistBotandAmazonbot. - New: Review request notice after 5 days of usage with permanent dismiss option.
- Improved: Rebalanced Free and Pro features — total crawler hit counter and per-crawler breakdown are now unlimited for all users (Free & Pro).
- Improved: IP anonymization now truncates IPs to subnets (/24 IPv4, /48 IPv6) prior to SHA-256 hashing.
- Improved: DB migration logic (
maybe_migrate()) for seamless, non-destructive upgrades.
- Fixed WordPress.Security.EscapeOutput errors in admin checkbox and radio field rendering.
- Fixed WordPress.WP.I18n.MissingTranslatorsComment errors on translated strings with placeholders.
- Improved WPCS compliance throughout admin class.
- New: Automatic head discovery link tag (
<link rel="alternate" ...>) pointing to the custom endpoint URL, updating dynamically. - New: Full body text extraction for each page/post in the AI context endpoint (HTML-stripped, shortcodes rendered).
- New: Heading outline (H1–H4) extraction for structural AI understanding.
- New: Featured image URL included per page.
- New: Content & Pages settings section with auto-selection count.
- New: Configurable max body text length (200–10,000 chars, default 1,500).
- New: Configurable auto-select count (default 15).
- New: Endpoint object cache is automatically busted when any relevant setting changes.
- Improved: Recent content now always shows the 5 most recent posts independently of featured content.
- Fixed:
recentContentnow always uses post date order;featuredContentuses modified date.
- Initial release.
- Module 1: Virtual
/ai-context.jsonendpoint with object cache. - Module 2: JSON-LD schema injection (WebSite, Organization, Article, BreadcrumbList, FAQPage).
- Module 3: AI crawler tracking with SHA-256 IP anonymization.
- Admin dashboard with crawler stats, log table, and GDPR documentation.
- WP-Cron based log pruning.
- Full uninstall cleanup.
- Compatible with Yoast SEO, RankMath, SEOPress, and All in One SEO.