senols

PufferSights monitors 100+ known AI crawler and AI agent user agents, hashes IP addresses, groups traffic by bot, provider, crawl purpose, content type, and response status, tracks human referrals from AI surfaces, and can publish a dynamic llms.txt content map for public site content.
The dashboard summarizes:
<ul>
<li>HTTP traffic by bot.</li>
<li>Crawl purpose.</li>
<li>Content type.</li>
<li>Response status.</li>
<li>AI referrals and crawl-to-refer ratio.</li>
<li>Top crawled content.</li>
<li>Tracked agent count.</li>
<li>Dynamic llms.txt content map.</li>
<li>robots.txt audit and policy snippets.</li>
</ul>
The crawler registry is based on current public operator documentation and industry references for OpenAI, Anthropic, Perplexity, Google, Apple, Common Crawl, Meta, ByteDance, Microsoft, Amazon, and related AI crawler operators.
The plugin does not contact any external service. All analytics data is stored in your own WordPress database.
robots.txt publishing is off by default. The plugin can generate and optionally publish policies for:
<ul>
<li>Monitor only.</li>
<li>Block training crawlers.</li>
<li>Allow AI search/user-action bots while blocking training crawlers.</li>
<li>Block all known AI bots.</li>
</ul>
llms.txt publishing is on by default and can be disabled in the PufferSights settings. The generated <code>/llms.txt</code> file lists selected published public pages and posts in Markdown so AI assistants can find the site’s main public content more easily.
<h3>Important Notes</h3>
User-agent detection is not bot verification. User agents can be spoofed. Raw IP addresses are not stored; the plugin stores a salted hash for rough uniqueness.
robots.txt is voluntary. Use a WAF, CDN, or server-level controls when technical enforcement is required.
Google-Extended and Applebot-Extended are robots.txt control tokens rather than normal request user agents, so they appear in robots.txt audits and policy snippets but usually do not appear in request logs.
llms.txt is a content map, not an access-control policy. It does not replace robots.txt and does not force AI systems to use or cite your content.
<h3>Privacy</h3>
PufferSights stores local analytics for public, logged-out requests only. It does not track wp-admin pages, logged-in users, AJAX requests, or WP-Cron requests.
The plugin stores:
<ul>
<li>Request time and date.</li>
<li>Event type, such as AI crawler request or AI referral.</li>
<li>HTTP method.</li>
<li>Request path without query string.</li>
<li>HTTP response status.</li>
<li>MIME/content group.</li>
<li>Matched crawler or AI referral provider.</li>
<li>User-agent string and user-agent hash.</li>
<li>Salted one-way hash of the request IP address.</li>
<li>Referrer origin only, such as <code>https://chatgpt.com</code>, without referrer path or query string.</li>
</ul>
The plugin does not store raw IP addresses, cookies, browser local storage, or complete referrer URLs. It does not send analytics, telemetry, crawler records, or site data to third-party services.
If llms.txt publishing is enabled, the plugin serves a Markdown overview of selected published public posts and pages at <code>/llms.txt</code>. Drafts, private posts, and password-protected posts are not included.
Administrators can disable tracking, clear captured events, and configure retention from the PufferSights admin page. The default retention period is 90 days. On uninstall, the plugin removes its custom analytics table, saved options, and scheduled cleanup hook.
The plugin also adds suggested disclosure text to WordPress’ Privacy Policy Guide.

PufferSights – AI Crawler Insights

Monitor 100+ known AI crawler and AI agent user agents with local analytics, AI referrals, llms.txt, and opt-in robots.txt policy tools.

Azey

AI agents from ChatGPT, Claude, Perplexity, and others read your content to generate answers — but they parse through HTML, JavaScript, and navigation just to reach it. Serve Markdown gives them a direct path: clean Markdown with structured metadata. When a crawler requests it — via an <code>Accept: text/markdown</code> header or a <code>.md</code> URL — your site responds instantly. No noise, no guesswork.
<h4>How It Works</h4>
Serve Markdown adds three capabilities to your WordPress site:
1. Content Negotiation 
When an AI crawler sends <code>Accept: text/markdown</code>, your site returns Markdown instead of HTML — no URL changes needed.
2. .md URL Suffix 
Append <code>.md</code> to any post or page URL (e.g. <code>example.com/my-article.md</code>) to get the Markdown version directly.
3. Markdown Auto-Discovery 
Every page includes a <code><link rel="alternate" type="text/markdown"></code> tag in the HTML head so crawlers can find your Markdown automatically.
<h4>What the Markdown Output Looks Like</h4>
Every Markdown response includes YAML frontmatter with structured metadata followed by your post content. Here is a real example:
<pre>
---
url: 'https://akumarjain.com/textexpander-year-in-review-2025/'
title: TextExpander Year in Review 2025
author:
 name: Ajay
 url: 'https://akumarjain.com/author/akumarjain/'
date: '2026-01-05T09:05:00+05:30'
modified: '2026-01-10T14:30:06+05:30'
type: post
categories:
 - 2025
 - Year in Review
tags:
 - '#ToolsIUse'
 - Productivity
 - Remote Work
image: 'https://akumarjain.com/wp-content/uploads/text-expander-year-in-review-2025.webp'
published: true
---

# TextExpander Year in Review 2025

In my daily work, I need to type the same words and phrases repeatedly...
</pre>
<h4>Features</h4>
Content Serving
<ul>
<li>Content negotiation via <code>Accept: text/markdown</code> header</li>
<li><code>.md</code> URL suffix on any post or page</li>
<li>Auto-discovery <code><link rel="alternate"></code> tag in page head</li>
<li>Each feature can be toggled independently</li>
<li>Choose which post types are exposed (posts, pages, custom post types)</li>
</ul>
Frontmatter and Metadata
<ul>
<li>YAML frontmatter with title, author, date, categories, tags, featured image, and more</li>
<li>Toggle individual metadata fields on or off</li>
<li>Add custom static key-value pairs (e.g., <code>license</code>, <code>language</code>)</li>
<li>Map WordPress custom fields (post meta) into the frontmatter</li>
</ul>
Access Control
<ul>
<li>Per-post opt-out via a sidebar checkbox in the editor</li>
<li>Exclude entire categories from Markdown serving</li>
<li>Exclude entire tags from Markdown serving</li>
<li>Only published posts are served — drafts and private posts are never exposed</li>
</ul>
Crawler Insights
<ul>
<li>Request log showing every Markdown request with timestamp, URL, bot name, and method</li>
<li>Automatic bot detection: ClaudeBot, GPTBot, ChatGPT, OAI-SearchBot, PerplexityBot, Googlebot, Bingbot, Cohere, Meta AI, Bytespider, Applebot, and more</li>
<li>Stats dashboard: total requests, requests today, unique bots</li>
<li>Filter log by individual bot</li>
<li>Configurable retention period with automatic pruning</li>
<li>One-click log clearing</li>
</ul>
Editor Integration
<ul>
<li>“Preview Markdown” button in the post editor sidebar</li>
<li>“View Markdown” link in the Posts and Pages list table</li>
<li>Meta box shows on all enabled post types</li>
</ul>
<h4>Performance</h4>
Markdown conversion only runs when specifically requested — regular visitors see the same HTML pages they always have. The crawler log uses a lightweight custom table with three safeguards against unbounded growth: time-based retention, a row count cap, and a table size cap.
<h4>Privacy</h4>
The crawler log stores IP addresses and user-agent strings from Markdown requests. This data stays in your WordPress database and is never sent to external services. You can disable logging entirely, configure a retention period, or clear the log at any time from the settings page.

Serve Markdown

Serve Markdown versions of your posts and pages to AI agents and crawlers. Content negotiation, .md URLs, auto-discovery, and crawler logging.

PufferSights – AI Crawler Insights vs Serve Markdown