Title: Adriano GEO Context and Crawl Monitor
Author: adriano
Published: 25 de junio de 2026
Last modified: 5 de octubre de 2026
---
Buscar plugins
# Adriano GEO Context and Crawl Monitor
Por [adriano](https://profiles.wordpress.org/adriano79/)
[Descargar](https://downloads.wordpress.org/plugin/adriano-geo-context-crawl-monitor.2.1.0.zip)
* [Detalles](https://es-ar.wordpress.org/plugins/adriano-geo-context-crawl-monitor/#description)
* [Valoraciones](https://es-ar.wordpress.org/plugins/adriano-geo-context-crawl-monitor/#reviews)
* [Instalación](https://es-ar.wordpress.org/plugins/adriano-geo-context-crawl-monitor/#installation)
* [Desarrollo](https://es-ar.wordpress.org/plugins/adriano-geo-context-crawl-monitor/#developers)
[Soporte](https://wordpress.org/support/plugin/adriano-geo-context-crawl-monitor/)
## Descripción
**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, Adriano
GEO 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 ``. 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 19+ AI crawlers
including GPTBot (ChatGPT), ClaudeBot (Anthropic), Google-Extended, PerplexityBot,
Bingbot, YouBot, CCBot, DuckAssistBot, Amazonbot, and more. Total hit counts and
per-crawler breakdowns are unlimited in both Free and Pro versions. All tracking
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 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)
**Module 5 – Pro Reports & Exports (Pro)**
* **Weekly Automated Email Digest**:
Scheduled WP-Cron HTML report featuring hit totals, week-over-week percentage change,
top 3 crawlers, full breakdown, and AI referral traffic. * **White-Label Printable
PDF Reports**: Clean, print-optimized HTML report with agency branding, custom logo
upload, and AI referral traffic section — printable directly to PDF from your browser.***
One-Click CSV Export**: Download complete crawler visit logs, or AI referral visit
logs, as CSV files for deep offline analysis.
**Module 6 – AI Referral & Citation Analytics**
Tracks real human visits that land
on your site after clicking a link cited by a conversational AI answer engine (ChatGPT,
Perplexity, Gemini, Copilot, Claude, Meta AI, Grok, You.com, Phind, Arc Search,
DeepSeek, and more) — the metric that proves a concrete return on your GEO efforts,
distinct from crawler activity. Detects the referring domain server-side (with an
automatic client-side beacon fallback for sites running a full-page caching plugin),
and displays a dedicated “AI Visibility Real Traffic” funnel widget comparing crawler
hits vs. real referral visits on the dashboard. Same privacy-first design as crawler
tracking: no cookies, SHA-256 IP anonymization, local storage only. The list of
recognised AI domains is extendable via the `gaie_ai_referrer_domains` filter, and
Pro users can add their own custom domains directly from Settings.
#### Dashboard
A clean, modern admin dashboard provides:
* 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
#### Privacy & GDPR
* **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
#### 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 Pro Comparison
* **Total Hit Counter & Breakdown**: Unlimited in both Free and Pro versions (crawler
tracking and AI referral tracking).
* **Recent Event Log**: Free shows the 25 most recent crawler hits; Pro shows up
to 1,000 entries.
* **AI Referral Recent Visits**: Free shows the 25 most recent AI referral visits;
Pro shows unlimited history.
* **Custom AI Referrer Domains**: Pro feature — extend the built-in AI answer-engine
domain list with your own custom domains directly from Settings.
* **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, including AI referral traffic).
* **Printable PDF Reports**: Pro feature (generates white-label printable PDF reports
with custom logo & agency name, including an AI referral traffic section).
* **CSV Export**: Pro feature (export crawler visit logs and AI referral visit
logs to CSV).
#### Technical Highlights
* 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
## Capturas
[⌊Dashboard – Overview of AI crawler activity with stat cards, distribution bars,
and recent log table.⌉⌊Dashboard – Overview of AI crawler activity with stat cards,
distribution bars, and recent log table.⌉[
**Dashboard** – Overview of AI crawler activity with stat cards, distribution bars,
and recent log table.
[⌊Settings – Module toggles, endpoint configuration, content mode, email digest
options, and privacy controls.⌉⌊Settings – Module toggles, endpoint configuration,
content mode, email digest options, and privacy controls.⌉[
**Settings** – Module toggles, endpoint configuration, content mode, email digest
options, and privacy controls.
[⌊Privacy & GDPR – Full data documentation and suggested policy text.⌉⌊Privacy &
GDPR – Full data documentation and suggested policy text.⌉[
**Privacy & GDPR** – Full data documentation and suggested policy text.
[⌊Free vs Pro – Detailed feature breakdown table.⌉⌊Free vs Pro – Detailed feature
breakdown table.⌉[
**Free vs Pro** – Detailed feature breakdown table.
[⌊AI Context Endpoint – Example JSON response served to AI crawlers.⌉⌊AI Context
Endpoint – Example JSON response served to AI crawlers.⌉[
**AI Context Endpoint** – Example JSON response served to AI crawlers.
[[
[[
## Instalación
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 Dashboard** to view crawler stats.
4. Go to **Adriano GEO 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.
## Preguntas frecuentes
### 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
You control which content appears via **Adriano GEO 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 (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 **Adriano GEO 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.
## Reseñas
No hay reseñas para este plugin.
## Colaboradores y desarrolladores
“Adriano GEO Context and Crawl Monitor” es un software de código abierto. Las siguientes
personas han colaborado con este plugin.
Colaboradores
* [ adriano ](https://profiles.wordpress.org/adriano79/)
[Traduce “Adriano GEO Context and Crawl Monitor” a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/adriano-geo-context-crawl-monitor)
### ¿Interesado en el desarrollo?
[Revisa el código](https://plugins.trac.wordpress.org/browser/adriano-geo-context-crawl-monitor/),
echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/adriano-geo-context-crawl-monitor/),
o suscríbete al [log de desarrollo](https://plugins.trac.wordpress.org/log/adriano-geo-context-crawl-monitor/)
por [RSS](https://plugins.trac.wordpress.org/log/adriano-geo-context-crawl-monitor/?limit=100&mode=stop_on_copy&format=rss).
## Registro de cambios
#### 2.1.0
* **New**: AI Referral & Citation Analytics — tracks real human visits arriving
from AI answer engines (ChatGPT, Perplexity, Gemini, Copilot, Claude, Meta AI,
Grok, You.com, Phind, Arc Search, DeepSeek), with server-side detection and an
automatic client-side beacon fallback for sites behind full-page caching.
* **New**: “AI Visibility Real Traffic” funnel widget on the dashboard, comparing
crawler hits vs. real AI referral visits over the last 7 days.
* **New**: Dedicated dashboard panel with AI referral breakdown by platform, top
landing pages, and recent visits (last 25 for Free, unlimited for Pro).
* **New** (Pro): Custom AI referrer domain list, editable from Settings, on top
of the built-in list (also extendable via the `gaie_ai_referrer_domains` filter
for developers).
* **New** (Pro): AI referral traffic sections added to the weekly email digest
and the printable PDF report; dedicated AI referral CSV export.
* **Fixed**: Log pruning via WP-Cron (`gaie_prune_logs_cron`) is now registered
directly at bootstrap instead of opportunistically inside the crawler-logging
code path, ensuring retention cleanup actually runs on schedule for both crawler
and AI referral logs.
#### 2.0.3
* **Fixed**: Defensive file_exists checks implemented for Freemius SDK and all
dependency classes.
* **Fixed**: Complete inclusion of vendor and includes directories in release archive.
* **Compatibility**: Tested up to WordPress 7.0.2.
#### 2.0.1
* **Fixed**: Added file_exists safety check before requiring Freemius SDK to prevent
fatal errors during updates.
* **Fixed**: Ensured Freemius SDK files are bundled in the release package.
#### 2.0.0
* **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.json` endpoint.
* **New**: Expanded AI crawler detection to 19+ crawlers, adding `DuckAssistBot`
and `Amazonbot`.
* **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.
#### 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 (``) 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.
* Compatible with Yoast SEO, RankMath, SEOPress, and All in One SEO.
## Meta
* Versión **2.1.0**
* Última actualización **hace 2 días**
* Instalaciones activas **20+**
* Versión de WordPress ** 6.2 o superior **
* Testeado hasta **7.1.3**
* Versión de PHP ** 8.0 o superior **
* Idioma
* [English (US)](https://wordpress.org/plugins/adriano-geo-context-crawl-monitor/)
* Etiquetas:
* [AI Crawlers](https://es-ar.wordpress.org/plugins/tags/ai-crawlers/)[ai seo](https://es-ar.wordpress.org/plugins/tags/ai-seo/)
[geo](https://es-ar.wordpress.org/plugins/tags/geo/)[JSON-LD](https://es-ar.wordpress.org/plugins/tags/json-ld/)
[LLM](https://es-ar.wordpress.org/plugins/tags/llm/)
* [Vista avanzada](https://es-ar.wordpress.org/plugins/adriano-geo-context-crawl-monitor/advanced/)
## Valoraciones
Todavía no se enviaron reseñas.
[Your review](https://wordpress.org/support/plugin/adriano-geo-context-crawl-monitor/reviews/#new-post)
[Ver todas las reseñas](https://wordpress.org/support/plugin/adriano-geo-context-crawl-monitor/reviews/)
## Colaboradores
* [ adriano ](https://profiles.wordpress.org/adriano79/)
## Soporte
¿Tenés algo que decir? ¿Necesitás ayuda?
[Ver el foro de asistencia](https://wordpress.org/support/plugin/adriano-geo-context-crawl-monitor/)