AgentGarrison – AI Bot Control & LLM Optimizer

AgentGarrison is an AI visibility toolkit for WordPress. It helps your site get discovered, understood, and cited by AI assistants such as ChatGPT, Perplexity, Gemini, and Claude, while giving you precise control over which AI crawlers can access your content. Its standout feature is the Citation Monitor: it queries AI assistants for your target questions and reports whether your site is actually cited, with a per-competitor breakdown, so you can measure and track your AI visibility over time — not only publish signals for AI to read, but see the result. It combines thirteen modules in one plugin: AI bot access control, llms.txt generation with a built-in validator, Markdown output for AI agents, an AI-ready Q&A block, local bot analytics with a live activity feed, LLM referral tracking, an AI readability content scorer, structured data with E-E-A-T trust signals, a citation monitor, a honeypot bot trap, email reports, white-label reports, and a composite AI Visibility Score. Everything runs on your own WordPress install: analytics, logs, and settings are stored in your own database. The only feature that can reach out to an AI provider is the optional Citation Monitor, and it is built for the WordPress 7.0 AI Client: when the site owner configures a provider under Settings → Connectors, AgentGarrison uses the core AI Client and never handles credentials itself. On WordPress 6.x (or when no core provider is set up) it falls back to your own API key. Every other feature works with no account and no external service. How AgentGarrison is organised

• Modular: each feature is a module you can enable or disable individually, so only what you use runs on your site
• Local first: bot analytics, referral logs, and scores are stored in your own database
• Free features work out of the box: no signup, no API key required
• Built on WordPress standards: on WordPress 7.0+ it uses the core AI Client for any AI provider access, so the site owner configures the provider once under Settings → Connectors and credentials are managed by core, not the plugin
• Plays well with SEO plugins: schema output automatically defers overlapping types when another SEO plugin is active, to prevent duplicate markup

🤖 AI Bot Control Take back control of who can crawl your site. AgentGarrison ships with a built-in database of 26+ known AI bots across five categories — AI Trainers, AI Assistants, AI Search Engines, General Scrapers, and SEO Crawlers.

• Category-level rules — allow or block entire categories with one click (e.g. block all AI training bots while keeping AI search bots)
• Per-bot overrides — fine-tune individual bots like GPTBot, ClaudeBot, or Bytespider independently of their category
• Plain-English category notes — each category explains what blocking it means so you can make informed decisions
• robots.txt enforcement — rules are injected into your live /robots.txt automatically via WordPress's native filter
• X-Robots-Tag header injection — optional HTTP header block for bots that ignore robots.txt (noai, noimageai)
• Import wizard — reads your existing robots.txt on first setup and maps it to the known bot list so no previous configuration is lost
• Per-bot "Last Seen" timestamps — see exactly when each bot last visited your site

📄 llms.txt Generator llms.txt is the emerging standard that tells AI models what your site is about and which pages matter most.

• Auto-generated at /llms.txt and /llms-full.txt — always up to date, no manual editing
• Customisable site context — write one sentence describing your site; AI models use it when answering questions about your topic
• Spec-compliant output — proper Markdown with an H1 title, summary blockquote, and [name](url) hyperlink lists, exactly as the llms.txt standard (llmstxt.org) requires
• Excluded section — pages you exclude are listed in their own section so AI models know they're deliberately hidden
• Health check — AgentGarrison pings your llms.txt every 12 hours and alerts you on the dashboard if it returns an error or goes stale
• Auto-respects Yoast and Rank Math noindex — noindexed pages are automatically excluded
• robots.txt discovery line — automatically adds Llms-txt: to your robots.txt
• Custom additions — append your own links or sections (docs, pricing, partner sites) to the end of the auto-generated file, or switch on full manual override to write the entire file yourself
• Validator & insights — checks your file against the spec and shows file size, estimated tokens, and the included/excluded page breakdown
• Live preview — see your generated llms.txt inside the admin panel, with copy and download buttons
• Static file option (opt-in) — for hosts that 404 the virtual file (e.g. WP Engine), optionally write a real llms.txt to your web root; off by default

📝 Markdown for Agents Serve clean, token-efficient Markdown to AI agents on your normal URLs. Runs entirely on your own site, free, on any host. Off by default; enable it in Settings, Modules.

• HTTP content negotiation: when an agent requests a page with Accept: text/markdown, AgentGarrison returns Markdown instead of HTML on the same canonical URL (the correct way, not a separate .md suffix that ignores the header). Roughly 5 to 6 times fewer tokens.
• Discovery: adds a <link rel="alternate" type="text/markdown"> tag and Link header, plus a bookmarkable ?rayetun_ag_md=1 URL, so agents can find the Markdown version.
• YAML frontmatter: optional title, URL, date, author, image, categories, and tags.
• X-Markdown-Tokens header: lets agents budget context before reading.
• Dependency-free conversion: a built-in HTML to Markdown converter (no external library) that preserves headings, lists, links, images, blockquotes, and code.
• Respects your exclusions: honours the same per-post "exclude from llms.txt" flag, and sends Vary: Accept so caches stay correct.

❓ AI Q&A Block A Gutenberg block for question-and-answer content, designed to be extraction-friendly for AI engines.

• Native collapsible block: readers see a clean, accessible question they can expand, built on the standard HTML <details> element (no JavaScript required on the front end).
• Automatic FAQ structured data: the block's markup is picked up by AgentGarrison's Schema module and emitted as FAQPage JSON-LD, the format AI assistants and search engines pull answers from. One emitter, no duplicate schema.
• No build tooling, no bloat: a lightweight, dependency-free block. Enabled by default and completely invisible until you add one.

📊 AI Bot Analytics Know exactly which AI systems are crawling your site, how often, and which pages they're most interested in.

• Real-time bot identification — matches incoming User-Agent strings against all 26+ known bots and logs every visit
• Visit deduplication — prevents database bloat when a bot crawls 500 pages in one session
• Traffic spike alerts — email notification when any bot's 24-hour visit rate is 3× above its 7-day baseline
• Interactive charts — timeline and donut charts (Chart.js, bundled locally) show bot traffic trends over 7, 30, and 90-day windows
• Top pages table — see exactly which of your pages AI bots are targeting most
• CSV export — download your raw bot visit data for further analysis

🔗 LLM Referral Tracker When someone asks ChatGPT a question and it recommends your article, that visitor clicks through to your site. AgentGarrison catches those visits.

• Detects referrals from ChatGPT, Perplexity, Gemini, Claude, and Copilot — via HTTP Referer header and UTM source parameters
• Platform breakdown — see which AI platform sends the most traffic and which pages get cited
• Post list column — an "AI Citations" count badge appears next to each article in your post list
• CSV export — download your full referral log

✍️ Content Readability Scorer AI models prefer content that is clear, well-structured, and fact-dense. The Content Scorer gives every post a 0–100 AI Readability Score across five dimensions:

1. Answer Density (25%) — does your content directly answer the topic in the first 150 words?
2. Header Hierarchy (20%) — is your H2/H3 structure logical and sequential?
3. Fact Density (20%) — do you include specific numbers, dates, and named entities?
4. Reading Level (20%) — approximate grade level optimised for AI comprehension
5. Clarity (15%) — penalises vague language that confuses AI models

Scores appear in a post editor sidebar metabox, an "AI Score" post list column, and a bulk dashboard with filtering and pagination. Fix the lowest-scoring posts first for the fastest gains. 🗂️ Schema & Structured Data Help AI models and Google understand your content with a connected JSON-LD @graph — nodes linked by @id the way Yoast and Rank Math do it, which LLMs parse best.

• Article — applied to posts, pages, and custom post types
• Product — price, availability, SKU, and ratings for WooCommerce products
• FAQPage — auto-detected from question headings, paragraphs, and <details>/<summary> blocks, no shortcodes needed
• HowTo — auto-detected from "How to" titles with an ordered step list
• BreadcrumbList — generated from page hierarchy or primary category
• WebSite + SearchAction — site-wide node enabling Google's sitelinks search box
• Speakable — marks the title and intro for voice assistants and AI answer extraction
• LocalBusiness — optional node with business type, address, geo, hours, and price range for sites with a physical location
• Organization — declare your brand, URL, description, and logo once; it appears site-wide
• Author (Person) — structured author data linked to articles, with optional credentials (job title, expertise, profile links) from the user profile
• Trust & Editorial signals (E-E-A-T) — publishingPrinciples, ethicsPolicy, correctionsPolicy, ownership/funding, founding date, and official profile links (sameAs), plus per-post "reviewed by / last reviewed" — the trust signals AI engines and Google use to decide whether to cite you
• Per-post control — a Schema metabox lets you exclude any post, disable specific types, or set a content reviewer, with a live JSON-LD preview
• Full-page preview — see the complete @graph for any post right in the admin
• Schema validator — reports which types are emitted, flags missing recommended properties, shows a Yoast/Rank Math conflict report, and links straight to Google's Rich Results Test
• Smart conflict detection — automatically skips Article schema when Yoast SEO or Rank Math is active to prevent duplicate markup

🔍 AI Visibility Score A single composite 0–100 score — shown on the dashboard as a ring gauge — that reflects your overall AI-readiness across five pillars: Bot Access, llms.txt quality, Analytics activity, Content Quality, and Schema setup. Grade A–F at a glance with an actionable checklist to improve each pillar. Compatible With

• Yoast SEO
• Rank Math
• AEO God Mode
• All in One SEO
• WooCommerce (product post type support in llms.txt)
• All major WordPress themes

1.0.0

• Initial public release.
• AI Bot Control: category-level and per-bot allow/block for 26+ known AI bots, robots.txt enforcement, optional X-Robots-Tag header, per-bot last-seen timestamps, and a robots.txt import wizard.
• llms.txt Generator: auto-generated /llms.txt and /llms-full.txt with a spec validator, health check, custom additions, manual override, drift detection, and an opt-in static file for hosts that serve .txt statically.
• Markdown for Agents (opt-in): serves clean, token-efficient Markdown to AI agents via Accept: text/markdown content negotiation, with discovery links, YAML frontmatter, and a dependency-free HTML to Markdown converter.
• AI Q&A block: a Gutenberg block for question-and-answer content that renders as a native collapsible block and is auto-detected as FAQ structured data.
• AI Bot Analytics: local bot-visit logging with timeline and donut charts, visit deduplication, traffic-spike email alerts, and CSV export.
• LLM Referral Tracker: detects human visits arriving from ChatGPT, Perplexity, Gemini, Claude, and Copilot.
• Content Readability Scorer: a 0-100 AI readability score per post across five dimensions, with an editor metabox and bulk dashboard.
• Schema and Structured Data: a connected JSON-LD @graph with Article, Product, FAQPage, HowTo, Breadcrumb, and E-E-A-T author trust signals, plus a validator.
• Citation Monitor: track whether AI assistants cite your pages for your questions, with a visibility scorecard and competitor leaderboard. Uses the WordPress 7.0 core AI Client, or your own OpenAI, Anthropic, or Perplexity key; runs in demo mode without a key.
• Honeypot bot trap, email reports, white-label PDF-ready reports, onboarding wizard, multisite network view, and a composite AI Visibility Score with an improvement checklist.
• Privacy: suggested privacy-policy text and integration with WordPress Export/Erase Personal Data tools. Everything runs locally on your own site.