# AEO Pugmill Intelligence Network

> https://aeopugmill.com

The AEO Pugmill Intelligence Network is a cooperative of WordPress site owners tracking how AI answer engines crawl the web in real time. Site owners install the free AEO Pugmill plugin, opt in to Bot Analytics, and their anonymized bot signal data is aggregated into network-wide trends visible at aeopugmill.com.

**You give signal. You get intelligence.** Every participating site's AEO gets sharper together.

Data is processed every 15 minutes and cached hourly. No personal data is collected. All contributions are anonymous.

---

## The Plugin

URL: https://aeopugmill.com/plugin

AEO Pugmill is a free WordPress plugin that does two things:

**For your site:** It adds AEO metadata to WordPress posts — structured Q&A pairs, named entity mentions, citation links, and machine-readable endpoints like llms.txt. These are the signals AI answer engines look for when deciding what to extract and attribute.

**For the network:** Opting in sends a daily count summary to aeopugmill.com — which bot, which resource type, how many visits. No content, no URLs, no user data. That aggregate powers the intelligence dashboard.

Both features work independently. Bot analytics and AEO outputs are available without contributing to the network.

### Features

- **Bot analytics dashboard** — Which AI crawlers are visiting your site, what they're fetching, and how counts trend over time — directly in the WordPress admin.
- **FAQPage + entity JSON-LD** — Structured Q&A pairs and named entity mentions written to each page's JSON-LD automatically. Readable by AI engines at crawl time.
- **llms.txt endpoints** — Generates /llms.txt and /llms-full.txt automatically — a content map AI crawlers use for structured discovery.
- **AI field generation** — Summaries, Q&A pairs, entity tags, and keywords generated from your own API key (Anthropic, OpenAI, or Gemini). You pay only for the API calls made.
- **robots.txt management** — Per-bot crawler rules — allow or restrict directives for specific bots without editing server configuration.

### What is sent to the network (opt-in only)

Participation is opt-in. The plugin runs fully without ever sending data to the network.

**Sent:**
- A one-way SHA-256 hash of your site URL (cannot be reversed to a domain)
- Bot visit counts by bot name and resource type (html, llms.txt, sitemap, etc.)
- Content signal distributions: word count bucket, freshness, fact density, URL depth
- The date of the summary period

**Never sent:**
- Your domain name or site URL
- Post titles, content, or summaries
- Visitor IP addresses or user agents
- Usernames, email addresses, or any personal data
- Individual page URLs or post IDs

The payload is HMAC-signed before transmission. aeopugmill.com verifies the signature on receipt and discards unsigned requests.

---

## Pricing

URL: https://aeopugmill.com/pricing

### Free Plan — $0

No credit card. No time limit.

- Manual AEO editing — summary, Q&A, entities, keywords
- FAQPage + entity + citation JSON-LD
- llms.txt, XML sitemap & IndexNow
- AEO health score
- Bot analytics dashboard
- SEO plugin compatibility (Yoast, Rank Math, SEOPress, AIOSEO)
- AI field generation (your own API key)
- Network intelligence — opt-in, anonymous

### Pro Plan — $7/month or $49/year (save 42%)

Up to 3 WordPress sites per license.

Everything in Free, plus:
- Generate All — one-click, all AEO fields at once
- Bulk AEO generator — process every post in one run
- AI SEO title & meta description
- AI schema type detection
- Tone check & reading level analysis
- Topic focus, keyword coverage & heading suggestions
- Internal link suggestions
- Headline variants & simplify draft
- Social media drafts, excerpt & featured image alt text

### FAQ

**Q: What does the free plan actually include?**
The free plan includes manual AEO editing (summary, Q&A, entities, keywords), FAQPage and entity JSON-LD output, llms.txt generation, XML sitemap, IndexNow pings, AEO health scoring, bot analytics, SEO plugin conflict detection, and AI field generation using your own API key. Network intelligence contribution is opt-in and anonymous. No features are time-limited or trial-gated.

**Q: What does Pro add?**
Pro is about automation and scale. One-click "Generate All" runs every AEO field at once per post. Bulk AEO Generator processes your entire site in one run. Pro also unlocks AI-generated SEO titles and meta descriptions, schema type detection, tone check, reading level, topic focus, keyword coverage, heading suggestions, headline variants, simplify draft, internal link suggestions, featured image alt text, excerpt generator, and social media drafts.

**Q: Do I need an AI API key?**
Only for AI field generation. Bot analytics, JSON-LD outputs, llms.txt, and network intelligence all work without one. If you add a key — from Anthropic, OpenAI, or Google — you pay the provider directly at their published rates.

**Q: How does the 3-site license work?**
One Pro license covers up to 3 WordPress installs. Activation is tracked by domain. If you need to move a license to a different site, remove the key from the old site first to free up a slot.

**Q: Will this conflict with Yoast or RankMath?**
AEO Pugmill detects active SEO plugins and provides toggles to disable its own meta tags, sitemaps, and breadcrumbs so they don't conflict. Its core AEO outputs — entity mentions, citation markup, llms.txt, post Markdown endpoints, and bot analytics — are features that standard SEO plugins do not provide.

---

## About

URL: https://aeopugmill.com/about

### The problem

Search engines rank pages. AI engines cite facts. The shift from page-level indexing to fact-level extraction means content structure matters more than ever — but the tools to measure it barely exist. Publishers can see their Google Search Console traffic, but they have almost no visibility into how ChatGPT, Claude, Perplexity, or Gemini are reading their content.

### What the plugin generates

AEO Pugmill adds structured data and machine-readable endpoints to WordPress posts. Some outputs are served as separate URLs that bots can request independently. Others are embedded in the HTML of the page itself.

#### Trackable endpoints (served at their own URLs)

- **llms.txt** (`/llms.txt`) — A plain-text index of the site following the llms.txt specification. AI crawlers use it as a table of contents. Tracked as: `llms_txt`.
- **llms-full.txt** (`/llms-full.txt`) — Full content export for AI crawlers. Tracked as: `llms_full`.
- **Post Markdown** (`/your-post/?aeopugmill_llm=1`) — Structured Markdown rendering of a single post including metadata, AEO summary, entities, Q&A, keywords, and full content. Tracked as: `post_markdown`.
- **Site Summary** (`/?aeopugmill_llm=1`) — Markdown overview of the site with the five most recent posts. Tracked as: `site_summary`.
- **Standalone JSON-LD** (`/aeo/your-post.jsonld`) — FAQPage schema, entity mentions, citations, and associatedMedia link. Tracked as: `aeo_jsonld`.
- **XML Sitemap** (`/sitemap.xml`) — Standard XML sitemap with xhtml:link alternates pointing to Markdown endpoints. Tracked as: `sitemap`.
- **robots.txt additions** — Appends Sitemap and LLMs-Txt directives. Tracked as: `robots_txt`.

#### Embedded in HTML (not separately trackable)

- **FAQPage JSON-LD** — Generated from Q&A pairs in AEO metadata. Same format Google uses for FAQ rich results.
- **Entity mentions with sameAs** — Typed mentions entries in Article JSON-LD with disambiguation URLs.
- **Citation JSON-LD** — External links extracted as citation entries with URL and anchor text.
- **Meta tags** — Description, Open Graph, and Twitter Card tags derived from AEO summary.

### How bot tracking works

On every request, the plugin checks the user-agent against known bot signatures. When matched, it records: the canonical bot name, the resource type requested, and the date. Counts are stored in a daily summary table — no per-request log is kept.

For content-bearing requests, the plugin also records content signals: word count bucket, content freshness, fact density, and URL depth.

The site identifier sent with network payloads is a one-way SHA-256 hash. It cannot be reversed to recover the domain. It exists to deduplicate contributions across days.

### Bot categories tracked

- **AI Answer Engines** — ChatGPT (GPTBot), Claude (ClaudeBot), Perplexity (PerplexityBot), Gemini (Google-Extended), Amazon (Amazonbot), Meta, Mistral
- **Training Data Crawlers** — CCBot (Common Crawl), Bytespider (ByteDance), Grok (xAI), DeepSeek, Cohere
- **Search Engines** — Googlebot, Bingbot, Applebot, DuckDuckBot, YandexBot, BaiduSpider
- **SEO Tools** — SemrushBot, AhrefsBot, DotBot, Majestic

### Content signals tracked

- **Word Count** — `<500`, `500-1500`, `1500+`
- **Content Freshness** — `0-7d`, `8-30d`, `31-90d`, `90d+`
- **Fact Density** — `low`, `medium`, `high`
- **URL Depth** — `shallow`, `medium`, `deep`
- **URL Type** — post, page, category, tag, etc.

---

## Intelligence Dashboard

URL: https://aeopugmill.com/

The homepage is a live dashboard showing aggregated bot activity across all contributing WordPress sites. Data refreshes hourly. The dashboard displays:

- Contributing site count and total bot visits (30-day window)
- Bot activity breakdown by category (AI, Search, SEO, Training, Other, Unclassified)
- Per-bot visit counts and resource type breakdowns
- Crawl Intelligence — how each bot crawls the network (content type preferences, URL depth, freshness, fact density)
- Newly Seen Crawlers — bots first observed within the 30-day window
- Unclassified Crawlers — bots detected but not yet assigned to a category
- 30-day trend chart

---

## API

### GET /api/report

Returns the full aggregated dataset as JSON.

- **Endpoint**: https://aeopugmill.com/api/report
- **Method**: GET
- **Format**: JSON
- **Cache**: 1 hour (s-maxage=3600)

Response includes: `generated`, `sites_contributing`, `last_30_days` (per-bot resource breakdowns), `bot_categories`, `categories` (aggregate totals with trends), `unclassified`, `new_crawlers`, `trends`, `signals` (crawl intelligence distributions), `resource_totals`, `content_coverage`, `daily` (time series).

---

## How to join

1. Download the free AEO Pugmill plugin: https://aeopugmill.com/plugin
2. Upload and activate in WordPress
3. Opt in to Bot Analytics in the plugin settings
4. Your site's anonymized crawler signals begin contributing immediately
5. Return to https://aeopugmill.com to see aggregate trends across the full network

---

## Contact

Built by Janzen Works (https://janzenworks.com).

Feedback, bug reports, and data questions: michael@janzenworks.com