Documentation

ForGEO Documentation

Version 1.x  ·  WordPress 6.3+  ·  PHP 8.1+

Installation

ForGEO is a standard WordPress plugin. Install it via the WordPress plugin repository or by uploading the zip file directly.

From WordPress.org

  1. In your WordPress admin, go to Plugins → Add New
  2. Search for ForGEO
  3. Click Install Now, then Activate

From zip upload

  1. Download the ForGEO zip from your purchase confirmation email
  2. In WordPress admin, go to Plugins → Add New → Upload Plugin
  3. Upload the zip file and click Install Now
  4. Activate the plugin

Requirements

  • WordPress 6.3 or higher
  • PHP 8.1 or higher
  • Rank Math (Free or Pro) installed and active
  • WP-Cron enabled (or an external cron job)
  • An API key from Anthropic, OpenAI, or DeepSeek

ForGEO requires Rank Math to be active. It writes directly to Rank Math's post meta keys. If Rank Math is not installed, ForGEO will display a notice and won't run.

Connecting your API key

After activating ForGEO, go to ForGEO → Settings in your WordPress admin.

Supported providers

  • Anthropic (Claude Haiku, Claude Sonnet) — recommended for Fast mode
  • OpenAI (GPT-4o mini, GPT-4o)
  • DeepSeek — lowest cost option

Adding your key

  1. Select your preferred provider from the dropdown
  2. Paste your API key in the field provided
  3. Click Save & Test — ForGEO will make a test call to confirm the key is valid
  4. Select your preferred model for Fast mode and Thorough mode separately

Your API key is stored encrypted in your WordPress database. It is never sent to ForGEO's servers. All AI calls are made directly from your server to your chosen provider.

First optimisation run

Go to ForGEO → Optimise to run your first batch.

  1. Select content: Choose posts, pages, or a specific category. Use the filter to narrow by date or status.
  2. Choose mode: Fast (recommended for first runs) or Thorough.
  3. Set overwrite behaviour: By default, overwrite protection is on — ForGEO won't touch fields that already have content. Toggle off to allow overwrites.
  4. Queue: Click Run optimisation. ForGEO adds items to the queue and processes them via WP-Cron.
  5. Check progress: The progress bar in ForGEO → Dashboard updates in real time. A 100-post batch on Fast mode typically completes in 15–20 minutes.

What gets written

ForGEO writes to the following locations:

Rank Math post meta (per post)

  • rank_math_title — AI-optimised meta title
  • rank_math_description — AI-optimised meta description
  • rank_math_focus_keyword — Focus keyphrase suggestion
  • rank_math_schema — FAQ, Article, HowTo, and Speakable schema (JSON-LD, merged with existing)
  • rank_math_og_title — Open Graph title
  • rank_math_og_description — Open Graph description
  • rank_math_canonical_url — Canonical URL (audit only — only written if missing)

Site root files

  • /llms.txt — Site-level LLM index file
  • /llms-full.txt — Full content LLM file

WordPress options

  • forgeo_robots_rules — AI bot allow rules (injected into robots.txt via WordPress filter)
  • forgeo_crawler_log — AI crawler visit log (30-day rolling window)

Processing modes

Fast mode

A single AI call per post generates all optimisations in one pass. Recommended for initial site-wide runs and regular refresh cycles. Typical cost: $0.40–$0.60 per 100 posts depending on provider.

Thorough mode

Multiple AI calls per post with specialised prompts for each output type. Higher quality schema generation and more nuanced keyphrase selection. Recommended for pillar content, cornerstone pages, and final-pass quality checks. Higher per-post API cost.

AI crawler logging

ForGEO automatically logs requests from known AI crawlers by inspecting the User-Agent header on every incoming request. Detected crawlers are logged to the database with a timestamp and user-agent string.

The ForGEO Dashboard shows:

  • Total AI crawler visits in the last 30 days
  • Distinct bots detected
  • Per-crawler activity signals: Active (visited in last 7 days), Occasional (last 30 days), Rare (older)

Crawlers currently detected include: GPTBot, ClaudeBot, OAI-SearchBot, PerplexityBot, Google-Extended, GrokBot, CCBot, and others.

llms.txt

ForGEO generates and maintains two files in your site root:

/llms.txt

An index file listing your key pages with titles and short descriptions, in the standard llms.txt format. ForGEO updates this file whenever you run a new optimisation batch.

/llms-full.txt

A complete content file with the full text of your posts in a clean, LLM-readable format. No HTML, no navigation — just headings and prose.

llms.txt and llms-full.txt are written to your site root using WordPress file functions. If your server doesn't allow file writes to the root, you can enable the WordPress option-based version, which serves the files via a custom route instead.

robots.txt AI bot rules

ForGEO hooks into WordPress's robots_txt filter to append explicit Allow directives for all major AI crawlers. This runs automatically — no file editing required.

The injected rules look like:

User-agent: GPTBot
Allow: /

User-agent: ClaudeBot
Allow: /

User-agent: OAI-SearchBot
Allow: /

User-agent: PerplexityBot
Allow: /

User-agent: Google-Extended
Allow: /

User-agent: GrokBot
Allow: /

User-agent: CCBot
Allow: /

You can customise which bots are allowed, or set specific Disallow rules, in ForGEO → Settings → Crawler Rules.

Troubleshooting

ForGEO isn't processing posts

Check that WP-Cron is running. If your server disables WP-Cron, you'll need to set up an external cron job that calls wp-cron.php every minute. See the WordPress Cron documentation.

API key error

Use Settings → Save & Test to verify your key. Common issues: key has been revoked, wrong provider selected, or insufficient API credits.

Rank Math not detected

ForGEO requires Rank Math to be installed and active. If you've recently switched SEO plugins, deactivate and reactivate ForGEO to refresh the dependency check.

llms.txt not appearing at site root

Check that your WordPress installation has write permissions to the site root directory. Alternatively, enable the Serve via WordPress route option in Settings.

Getting help

For support, post on the WordPress.org support forum or email hello@agentsmith.uk.