Wopisanje
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.txtas a machine-readable site summary/agent-facts.htmlas a source-of-truth page for AI retrievalrobots.txtadditions 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).
Instalacija
- Install and activate the plugin through Plugins > Add New in WordPress, or upload the zip manually.
- Go to Settings > AgentReadyScan.
- Fill in your business details.
- Click Save & Regenerate Files.
- Verify that
yourdomain.com/llms.txtandyourdomain.com/agent-facts.htmlare live. - If you use the optional Pro service, paste your API key into the Pro license field to connect this site.
Manual upload
- Download the plugin zip.
- Go to Plugins > Add New > Upload Plugin.
- Upload the zip and click Install Now.
- 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.txtandagent-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.
Sobustatkujuce a wuwijarje
„AgentReadyScan – AI Visibility, llms.txt & Schema“ jo software wótwórjonego žrědła. Slědujuce luźe su pśinosowali k toś tomu tykacoju.
SobustatkujuceTranslate “AgentReadyScan – AI Visibility, llms.txt & Schema” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by 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_rawfor URL fields,sanitize_emailfor 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.txtgenerationagent-facts.htmlgeneration- Admin settings page with live file status
- Pro activation field for API-key-based upgrades