=== AgentReadyScan - AI Visibility, llms.txt & Schema === Contributors: ianaguirre Tags: ai visibility, llms.txt, chatgpt, structured data, seo Requires at least: 6.0 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.0.7 License: GPL-2.0-or-later License URI: https://www.gnu.org/licenses/gpl-2.0.html Help ChatGPT, Claude, and Perplexity understand your business with AI-ready schema, llms.txt, and agent-facts.html in minutes. == 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. == 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. == Frequently Asked Questions == = 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. == Screenshots == 1. Main settings screen showing business details, service fields, and publish controls 2. File status panel confirming JSON-LD, `llms.txt`, `agent-facts.html`, and `robots.txt` output 3. Example `llms.txt` file published from plugin settings 4. Example `agent-facts.html` page and Q&A output for AI retrieval == 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). == 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 `