Title: AgentReadyScan – AI Visibility, llms.txt & Schema
Author: ianaguirre
Published: <strong>April 14, 2026</strong>
Last modified: April 15, 2026

---

Search plugins

![](https://ps.w.org/agentreadyscan/assets/icon-256x256.png?rev=3505661)

# AgentReadyScan – AI Visibility, llms.txt & Schema

 By [ianaguirre](https://profiles.wordpress.org/ianaguirre/)

[Download](https://downloads.wordpress.org/plugin/agentreadyscan.1.0.7.zip)

 * [Details](https://wordpress.org/plugins/agentreadyscan/#description)
 * [Reviews](https://wordpress.org/plugins/agentreadyscan/#reviews)
 *  [Installation](https://wordpress.org/plugins/agentreadyscan/#installation)
 * [Development](https://wordpress.org/plugins/agentreadyscan/#developers)

 [Support](https://wordpress.org/support/plugin/agentreadyscan/)

## Description

When people ask AI tools about your company, your website needs clear, machine-readable
facts they can retrieve and cite.

AgentReadyScan helps WordPress site owners publish those facts without editing theme
files or writing custom schema markup.

#### Why install AgentReadyScan

 * Improve how AI tools interpret your business name, services, location, and contact
   details
 * Publish AI-readable files in minutes from one WordPress settings screen
 * Add structured data and AI-facing files without touching code
 * Keep the output server-rendered so crawlers can access it reliably

#### What the plugin generates

 * JSON-LD structured data for your business
 * `/llms.txt` as a machine-readable site summary
 * `/agent-facts.html` as a source-of-truth page for AI retrieval
 * `robots.txt` additions for AI crawler access through WordPress hooks

#### Why server-side output matters

AI crawlers such as GPTBot, ClaudeBot, and PerplexityBot do not rely on JavaScript
rendering the way browsers do. AgentReadyScan publishes files and schema at the 
PHP and WordPress hook level so they are available directly to crawlers.

#### Best for

 * Local businesses
 * Agencies managing client sites
 * Law firms, healthcare practices, restaurants, and home services
 * SaaS and technology companies
 * Any WordPress site that wants cleaner AI visibility signals

#### Features

 * Single settings page under **Settings > AgentReadyScan**
 * Business fact editor for company details, services, contact info, and Q&A
 * Live status panel showing whether each AI-facing file is active
 * Save and regenerate workflow for publishing updates quickly
 * Optional Pro API key for hosted verification and sync features

#### Free and Pro

The free plugin is fully functional for local publishing.

If you use the optional Pro service, enter a valid Pro API key in the plugin settings.
There is no separate public Pro plugin install.

### External Services

This plugin optionally connects to the AgentReadyScan API (https://www.agentreadyscan.
com) when a Pro API key is saved by the site administrator. The connection is used
to verify service access and retrieve hosted, server-processed sync payloads used
by optional service-backed capabilities (for example, managed rule updates). No 
visitor personal data is transmitted. The connection only occurs when a Pro API 
key is present and when the administrator requests verification/sync or when the
weekly background recheck runs.

 * Service: AgentReadyScan API
 * URL: https://www.agentreadyscan.com
 * Data sent: The Pro API key, site host/domain, and plugin version for service 
   verification and sync requests
 * Data received: Service status metadata and hosted sync payloads (for example,
   rules schema and related service fields)
 * Privacy policy: https://agentreadyscan.com/privacy
 * Terms of service: https://agentreadyscan.com/terms

No external connection is made for free installs (no API key saved).

## Installation

 1. Install and activate the plugin through **Plugins > Add New** in WordPress, or 
    upload the zip manually.
 2. Go to **Settings > AgentReadyScan**.
 3. Fill in your business details.
 4. Click **Save & Regenerate Files**.
 5. Verify that `yourdomain.com/llms.txt` and `yourdomain.com/agent-facts.html` are
    live.
 6. If you use the optional Pro service, paste your API key into the Pro license field
    to connect this site.

#### Manual upload

 1. Download the plugin zip.
 2. Go to **Plugins > Add New > Upload Plugin**.
 3. Upload the zip and click **Install Now**.
 4. Activate and follow the installation steps above.

## FAQ

### What problem does this plugin solve?

It helps WordPress sites publish clear, machine-readable business facts so AI tools
can retrieve more accurate information about the business from the website itself.

### Will this slow down my site?

No. The JSON-LD is a small inline script tag and the file checks use lightweight
PHP file operations.

### Does this affect SEO?

It is intended to help. JSON-LD structured data is already part of modern SEO, and
the AI-facing files add machine-readable clarity without replacing your existing
content.

### What permissions does the plugin need to write files?

PHP needs write access to your WordPress root directory so the plugin can create`
llms.txt` and `agent-facts.html`. If your host blocks this, you may need to adjust
file permissions or upload the generated files manually.

### Will this work with WooCommerce?

Yes. The plugin operates independently of WooCommerce and is designed to coexist
with normal WordPress plugins and themes.

### What is llms.txt?

llms.txt is an emerging machine-readable convention used to summarize high-signal
business facts for AI systems.

### What is the AgentFacts protocol?

AgentFacts is a protocol for creating a machine-readable source-of-truth page that
AI agents can retrieve from directly. In this plugin, that page is published as `
agent-facts.html`.

More information: https://www.agent-facts.com

### Do I need a separate Pro plugin?

No. Install the free AgentReadyScan plugin and, if you use the optional Pro service,
enter your API key in the plugin settings.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“AgentReadyScan – AI Visibility, llms.txt & Schema” is open source software. The
following people have contributed to this plugin.

Contributors

 *   [ ianaguirre ](https://profiles.wordpress.org/ianaguirre/)

[Translate “AgentReadyScan – AI Visibility, llms.txt & Schema” into your language.](https://translate.wordpress.org/projects/wp-plugins/agentreadyscan)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/agentreadyscan/), check
out the [SVN repository](https://plugins.svn.wordpress.org/agentreadyscan/), or 
subscribe to the [development log](https://plugins.trac.wordpress.org/log/agentreadyscan/)
by [RSS](https://plugins.trac.wordpress.org/log/agentreadyscan/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.7

 * Feature: Added website-vs-settings conflict detection for industry, contact details,
   services, and description mismatches
 * Feature: Added quality checks for Golden Questions (minimum count, duplicate 
   question detection, and short-answer warnings)
 * Feature: Added throttled consistency alert emails to site admin/contact addresses
   after save/scan flows when conflicts are detected
 * Fix: Improved industry detection robustness using weighted term scoring and confidence
   guardrails
 * Change: Free starter template now seeds 2 editable Q&A pairs by default instead
   of pre-filling a large question set

#### 1.0.6

 * Fix: Register settings now declares type/default and uses field-appropriate sanitizers(`
   esc_url_raw` for URL fields, `sanitize_email` for email)
 * Fix: Removed local feature restrictions by allowing full Q&A editing in the free
   plugin (all saved rows, add/remove controls)
 * Fix: Restored explicit exclusions input and included those exclusions in generated`
   agent-facts.html`
 * Fix: Removed raw admin `<script>` output and moved deactivation modal/admin behaviors
   to enqueued JS/CSS assets

#### 1.0.5

 * Fix: Q&A editor instructions simplified; link to agent-facts.com for writing 
   guidelines

#### 1.0.4

WP.org compliance fixes: prefix renamed to arscan_, all locally-computed features
ungated, sanitization improved, privacy/terms URLs corrected, contributor added.

#### 1.0.3

 * Feature: Deactivation survey modal — collects reason on deactivate with Skip/
   Submit options
 * Feature: “Upgrade to Pro” link added to plugin row actions (free installs only)
 * Feature: Drift detection (Pro) — detects when settings have changed since last
   file publish and shows amber notice with Republish Now button
 * Feature: Consistency checks (Pro) — flags missing business name, thin description,
   no contact info, or empty services list
 * Feature: Description field fallback chain — pulls from WP tagline, Yoast meta,
   AIOSEO meta, or post excerpt when field is empty
 * Feature: Load Site Data button now available for free-tier users in the scan 
   bar
 * Fix: Industry detection now uses normalized scoring — prevents generic WordPress
   nav terms (menu, delivery) from triggering false Restaurant detection
 * Fix: Re-Scan, Load Site Data, and Verify License no longer overwrite a manually-
   set industry; auto-detect only applies when industry is still General

#### 1.0.2

 * Fix: Site scan now reads meta[name=”description”] and og:description first, then
   WP tagline, before falling back to first paragraph — eliminates garbage nav/header
   text from auto-generated descriptions
 * Fix: Service candidate filter now blocks phone numbers, time strings, “Welcome
   to…”, “New Patient”, and other nav/hero noise
 * Fix: Service candidate max length reduced from 80 to 60 characters
 * Fix: agent-facts.html heading capitalization now matches Agent Facts v2.2 protocol(“
   12 Universal Golden Questions”, “Freshness and Change Control”)
 * Fix: Removed redundant “Business: [name]” paragraph from agent-facts.html (already
   in h1 and dl)
 * Version bump to 1.0.2

#### 1.0.1

 * Fix: decode_json_response now returns WP_Error for HTTP 4xx responses so is_wp_error()
   callers catch server errors correctly
 * Fix: llms.txt format updated to comply with llmstxt.org spec (H1 title, blockquote
   description, H2 sections)
 * Fix: agent-facts.html heredoc now pre-escapes all variables (esc_html/esc_url)
   before output
 * Fix: debug_log replaced file_put_contents with error_log gated on WP_DEBUG (WP.
   org compliance)
 * Fix: Q&A generation now uses primary_contact, founded_on, and pricing_summary
   fields when set
 * Fix: Q&A row index echoed with absint() (WP.org coding standards)
 * Version bump to 1.0.1

#### 1.0.0

 * Initial release
 * JSON-LD injection via `wp_head`
 * AI crawler permissions via `robots_txt`
 * `llms.txt` generation
 * `agent-facts.html` generation
 * Admin settings page with live file status
 * Pro activation field for API-key-based upgrades

## Meta

 *  Version **1.0.7**
 *  Last updated **3 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [ai visibility](https://wordpress.org/plugins/tags/ai-visibility/)[ChatGPT](https://wordpress.org/plugins/tags/chatgpt/)
   [llms.txt](https://wordpress.org/plugins/tags/llms-txt/)[seo](https://wordpress.org/plugins/tags/seo/)
   [structured data](https://wordpress.org/plugins/tags/structured-data/)
 *  [Advanced View](https://wordpress.org/plugins/agentreadyscan/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/agentreadyscan/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/agentreadyscan/reviews/)

## Contributors

 *   [ ianaguirre ](https://profiles.wordpress.org/ianaguirre/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/agentreadyscan/)