Adriano GEO Context and Crawl Monitor
| 开发者 | |
|---|---|
| 更新时间 | 2026年6月26日 16:53 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.0 |
| 版权: | 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 now 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 (you pick exactly which pages to expose)
- Total AI crawler hit count
- Per-crawler breakdown with visual bars
- Recent 50 log entries with crawler name, URI, and timestamp
- One-click log clearing
- No phone home: Zero data is ever sent to external servers
- IP anonymization: SHA-256 hashing with a site-specific salt (enabled by default)
- Storage limitation: Configurable log retention (default 90 days), automatically pruned via WP-Cron
- Right to erasure: Delete all data with one click or by uninstalling the plugin
- Data minimisation: Only the fields required for crawler analytics are collected
- Includes a full GDPR documentation page and suggested Privacy Policy text
- 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.
- SEO Plugin Compatibility: Available in both Free and Premium versions. Standard tags are delegated to your active SEO plugin while adding specialized AI markup.
- AI Crawler Analytics: Free version is limited to 5 events and a maximum of 7 days of history. Premium unlocks unlimited tracking and full history.
- Log Management: Premium unlocks the ability to export crawler logs to CSV for external analysis.
- Content Selection Mode: Free version is limited to Automatic mode (exposing recently modified pages). Premium/Pro version unlocks Manual selection mode (allowing you to search and select specific pages or posts to expose to AI).
- Endpoint Payload Context: Fully exports the site structure along with full body text, heading outlines, and featured image URLs for each page.
- WordPress Coding Standards compliant
- PHP 8.x compatible
- No external dependencies
- 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 creationuninstall.phpfor clean removal
安装:
- Upload the
adriano-geo-context-crawl-monitorfolder to the/wp-content/plugins/directory. - Activate the plugin through the 'Plugins' menu in WordPress.
- Navigate to Adriano GEO Context and Crawl Monitor → Dashboard to view crawler stats.
- Go to Adriano GEO Context and Crawl Monitor → 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?
In version 1.1.0 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 (configurable in Settings, default 15) to include in the endpoint. The Premium/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 data to external servers?
Never. All data collected by Adriano GEO Context and Crawl Monitor is stored exclusively in your WordPress database. The plugin contains no analytics, no tracking pixels, no license checks, and no "phone home" mechanisms of any kind.
What AI crawlers are tracked?
The plugin detects 18+ crawlers including: GPTBot (OpenAI/ChatGPT), ClaudeBot and anthropic-ai (Anthropic), Google-Extended (Google Gemini), Googlebot, Bingbot (Microsoft Copilot), PerplexityBot, YouBot, CCBot, DataForSeoBot, Bytespider, PetalBot, Applebot, FacebookBot, LinkedInBot, and Timpibot.
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 Adriano GEO Context and Crawl Monitor → 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?
The uninstall.php file removes the crawler log database table, all plugin options, and any scheduled cron events. Your site is left completely clean.
更新日志:
- 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 via
uninstall.php. - Compatible with Yoast SEO, RankMath, SEOPress, and All in One SEO.