WordPress.org

Taiwan 正體中文

取得 WordPress
WordPress.org

Plugin Directory

Adriano GEO Context and Crawl Monitor

Adriano GEO Context and Crawl Monitor

由 adriano 開發
下載

外掛說明

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

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

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

螢幕擷圖

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.
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.
AI Context Endpoint – Example JSON response served to AI crawlers.
AI Context Endpoint – Example JSON response served to AI crawlers.

安裝方式

  1. Upload the adriano-geo-context-crawl-monitor-v2 folder to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Navigate to GEO AIEngineer Dashboard to view crawler stats.
  4. Go to GEO AIEngineer 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.

常見問題集

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 GEO AIEngineer 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 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.

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈Adriano GEO Context and Crawl Monitor〉的開發相關工作。

參與者

將〈Adriano GEO Context and Crawl Monitor〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣？

任何人均可瀏覽程式碼、查看 SVN 存放庫，或透過 RSS 訂閱開發記錄。

變更記錄

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 (<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.
  • Compatible with Yoast SEO, RankMath, SEOPress, and All in One SEO.

中繼資料

  • 版本 2.0.3
  • 最後更新 2 天前
  • 啟用安裝數 20+
  • WordPress 版本需求 6.0 或更新版本
  • 已測試相容的 WordPress 版本 7.0.3
  • PHP 版本需求 8.0 或更新版本
  • 語言
    English (US)
  • 標籤:
  • 進階檢視

評分

這個項目尚無任何評論記錄。

Your review

查看全部使用者評論

參與者

技術支援

使用者可在技術支援論壇提出意見反應或使用問題。

檢視技術支援論壇