WordPress.org
Get WordPress
WordPress.org

Plugin Directory

Adriano GEO Context and Crawl Monitor

Adriano GEO Context and Crawl Monitor

By adriano
Download

Description

Adriano GEO Context and Crawl Monitor is a professional Generative Engine Optimization (GEO) plugin designed to help your WordPress site rank better in AI-powered search engines like ChatGPT, Perplexity, Bing Copilot, and Google AI Overviews.

Unlike traditional SEO plugins that focus on ranking in classic SERP results, GEO AIEngineer focuses on how Large Language Models (LLMs) and AI crawlers discover, understand, and reference your content.

Core Features

Module 1 – Virtual AI Context Endpoint
Creates a virtual /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:

  • WebSite with SearchAction
  • Organization with logo
  • Article with author, publisher, and featured image
  • BreadcrumbList for navigation context
  • FAQPage auto-detected from Gutenberg H3/paragraph blocks

Intelligently detects active SEO plugins (Yoast SEO, RankMath, SEOPress, All in One SEO) and avoids injecting duplicate schema that would conflict with them.

Module 3 – AI Crawler Tracking
Identifies and logs visits from 18+ AI crawlers including GPTBot (ChatGPT), ClaudeBot (Anthropic), Google-Extended, PerplexityBot, Bingbot, YouBot, CCBot, and more. All data is stored locally in your WordPress database. IP addresses are anonymized using one-way SHA-256 hashing.

Module 4 – Rich Content Extraction
The /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)

Dashboard

A clean, modern admin dashboard provides:

  • 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

Privacy & GDPR

  • 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

SEO Plugin Compatibility (No Duplicate Tags)

Adriano GEO Context and Crawl Monitor is designed to work out-of-the-box alongside all major SEO plugins:
* Yoast SEO
* RankMath
* All in One SEO (AIOSEO)
* SEOPress

When any of these plugins are active, Adriano GEO Context and Crawl Monitor automatically:
1. Detects their presence and prevents injecting duplicate core schemas (such as WebSite, Article, and Breadcrumbs).
2. Injects only AI-specific semantic metadata (#ai-markup block containing LLM targeting, context mapping, and structured entity associations) that traditional SEO plugins do not generate.
3. 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.

Free vs Premium Comparison

  • 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.

Technical Highlights

  • 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 creation
  • uninstall.php for clean removal

Installation

  1. Upload the adriano-geo-context-crawl-monitor folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Navigate to Adriano GEO Context and Crawl Monitor Dashboard to view crawler stats.
  4. Go to Adriano GEO Context and Crawl Monitor Settings to configure modules and privacy options.
  5. Visit your site’s /ai-context.json URL to verify the endpoint is working.

After activation, if the /ai-context.json endpoint returns a 404, go to Settings Permalinks and click Save Changes to flush rewrite rules.

FAQ

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

You control which content appears via Adriano GEO Context and Crawl Monitor Settings Content & Pages.

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.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Adriano GEO Context and Crawl Monitor” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Adriano GEO Context and Crawl Monitor” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.2

  • 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.

1.1.0

  • 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: recentContent now always uses post date order; featuredContent uses modified date.

1.0.0

  • Initial release.
  • Module 1: Virtual /ai-context.json endpoint 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.

Meta

  • Version 1.1.2
  • Last updated 11 hours ago
  • Active installations Fewer than 10
  • WordPress version 6.0 or higher
  • Tested up to 7.0
  • PHP version 8.0 or higher
  • Tags
  • Advanced View

Ratings

No reviews have been submitted yet.

Your review

See all reviews

Contributors

Support

Got something to say? Need help?

View support forum