=== AI-Ready WP === Contributors: studiomeyerio Donate link: https://studiomeyer.io Tags: ai, seo, chatgpt, llms-txt, schema Requires at least: 6.9 Tested up to: 7.1 Requires PHP: 8.0 Stable tag: 4.5.2 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Make your WordPress site discoverable by AI agents: agents.json, agent-card.json, llms.txt, JSON-LD schemas, and a full SEO module. == Description == **Auf Deutsch:** AI-Ready WP macht Ihre WordPress-Website für KI-Agenten und KI-Suchmaschinen auffindbar. Das Plugin erzeugt automatisch die Dateien und Metadaten, nach denen ChatGPT, Claude, Perplexity und andere KI-Systeme suchen: agents.json, agent-card.json, llms.txt, JSON-LD-Schemas, ein vollständiges SEO-Modul, IndexNow und ein KI-Bot-Management für über 20 Crawler. So spricht Ihre Seite die Sprache der KI — ohne Cloud-Zwang, alles läuft auf Ihrem eigenen Server. Die Bedienoberfläche gibt es auf Englisch, Deutsch und Spanisch. **AI-Ready WP** makes your WordPress site discoverable by AI agents and search engines. It generates the files and metadata that AI systems look for when trying to understand what your site offers. As AI agents become the new way people find businesses online, your site needs to speak their language. AI-Ready WP handles this automatically. = What It Does = **AI Discovery** * **agents.json** — AI Agent Discovery standard (/.well-known/agents.json). Tells AI systems what your site offers and how to interact with it. * **agent-card.json** — A2A Protocol (Agent-to-Agent) for agent interoperability (/.well-known/agent-card.json). * **mcp.json** — Optional MCP server discovery manifest (/.well-known/mcp.json). Off by default; point AI clients to the MCP servers you list in the settings. * **llms.txt** — LLM-readable content index (/llms.txt + /llms-full.txt). Like a sitemap for AI. * **JSON-LD schemas** — Organization/LocalBusiness, WebSite with SearchAction, BreadcrumbList, FAQPage. * **REST API** — Endpoints for AI agents (/wp-json/airewp/v1/). * **AI Bot Management**: names all 27 known AI crawlers in robots.txt and allows each of them by default, with Content Signals (contentsignals.org) that say what they may do with your content. Blocking training or retrieval crawlers is one checkbox. * **AI Crawler Analytics** — Track which AI bots visit your site and how often. * **IndexNow** — Instant indexing notifications to Bing and Yandex on content changes. * **WP Abilities API** — Machine-readable abilities for the WordPress MCP Adapter (WP 6.9+). * **AI-Readiness Score**: dashboard widget with up to 12 readiness checks. * **16 industry presets** — Restaurant, real estate, e-commerce, SaaS, agency, medical, legal, and more. * **Auto-regeneration** — Files update automatically on content changes and daily via WP-Cron. **SEO** * Meta title and description per page/post (editor meta box). * OpenGraph tags (og:title, og:description, og:image, og:type). * Twitter Card tags (summary_large_image). * Canonical URL override per page. * Robots meta (noindex/nofollow) per page. * XML Sitemap generation (/sitemap.xml). * Focus keyword analysis with 6-point checklist (title, URL, meta, density, length, intro). = Who Is This For? = * **Business owners** who want their site found by ChatGPT, Claude, Perplexity, and other AI assistants. * **Agencies** building client sites that need to be future-proof for AI discovery. * **Developers** who want a lightweight, well-coded AI discovery solution. = How It Works = 1. Install and activate the plugin. 2. Go to Settings > AI-Ready. 3. Fill in your business information. 4. Enable the features you need. 5. Everything generates and updates automatically. Your site immediately becomes discoverable by AI agents through standardized protocols. = Connect your AI (MCP) = Let Claude, ChatGPT or any other MCP client work with this site through the hosted AI-Ready WP server at [wp.studiomeyer.io](https://wp.studiomeyer.io). Sign in there, create an application password in your WordPress profile, add the connector `https://wp.studiomeyer.io/mcp` to your AI client and ask it to connect the site. From then on your AI reads the readiness score, the pages and robots.txt and explains what to do. With AI-Ready WP Pro it may also write: settings, titles and descriptions per page, rebuilds, IndexNow pings. The five steps are on the settings page. On the plugin side this is an administrator-only REST API under `/wp-json/airewp/v1/admin/`. It answers only to a signed-in administrator, application passwords included, and it is there whether or not the public REST routes are switched on. The plugin itself never contacts wp.studiomeyer.io; the connection runs the other way, from the server you signed in to, to this site. = More free plugins by StudioMeyer = * [SmartBot](https://wordpress.org/plugins/smartbot-ai-chatbot/) — an AI chatbot that answers your visitors' questions 24/7. * [Agent Discovery for WooCommerce](https://wordpress.org/plugins/studiomeyer-agent-discovery-for-woocommerce/) — expose UCP, A2A, and agents.json endpoints so AI shopping agents can find your products. * [StudioMeyer Barrierefrei-Check](https://wordpress.org/plugins/studiomeyer-barrierefrei-check/) — find WCAG/BFSG accessibility problems and generate the required accessibility statement. * [Transparency Toolkit for the EU AI Act](https://wordpress.org/plugins/studiomeyer-ai-transparency-toolkit/) — add EU AI Act Article 50 transparency: chatbot disclosure, AI-content labels, and a DE/EN/ES notice generator. == Installation == = Quick start (about 2 minutes) = 1. In WordPress, go to **Plugins → Add New**, search for "AI-Ready WP", then click **Install Now** and **Activate**. 2. Open **Settings → AI-Ready** and fill in your business name, description, and contact details. 3. Choose your industry preset and save. That is it — agents.json, llms.txt, JSON-LD, and the SEO files generate automatically and keep themselves up to date. Check the **AI-Readiness Score** widget on your Dashboard to see what is live and what to improve. = Manual installation = 1. Download the plugin ZIP. 2. Go to **Plugins → Add New → Upload Plugin**, upload the ZIP, then click **Install Now** and **Activate**. = SEO settings (optional) = Edit any page or post and open the **SEO Settings** box below the editor to set a custom meta title, description, focus keyword, and canonical URL. OpenGraph and Twitter Cards are handled for you. == Frequently Asked Questions == = What is agents.json? = agents.json is an emerging standard for AI agent discovery. It tells AI systems what your website offers and how to interact with it — like a machine-readable menu of your site's capabilities. = What is llms.txt? = llms.txt is a structured text file that gives LLMs (Large Language Models) a concise overview of your website content — like a sitemap for AI. = What is the A2A Protocol? = A2A (Agent-to-Agent) is a protocol by Google (now under the Linux Foundation) for AI agent interoperability. The agent-card.json file lets agents discover and communicate with your site. = Does this replace Yoast SEO? = For most sites, yes. AI-Ready WP provides meta titles/descriptions, OpenGraph, Twitter Cards, canonical URLs, robots meta, XML Sitemaps, and focus keyword analysis. If you need advanced features like redirect managers or internal linking suggestions, keep a dedicated SEO plugin. AI-Ready WP notices it and stands down. = Does this work with existing SEO plugins? = Yes. When Yoast SEO, Rank Math, All in One SEO, SEOPress, The SEO Framework, Squirrly, SmartCrawl or Slim SEO is active, AI-Ready WP leaves titles, descriptions, social tags, the sitemap and the Organization, WebSite and breadcrumb schemas to that plugin, so your pages do not end up with two of each. The FAQ schema stays, none of those plugins builds it from your headings. The settings page says which plugin it found, and a checkbox brings the output back if you want it. The AI Discovery features (agents.json, llms.txt, JSON-LD, robots.txt, IndexNow) are not affected. Other SEO plugins can be added with the `airewp_competing_seo_plugin` filter. = Does this work with WooCommerce? = Yes. If WooCommerce is active, the plugin automatically adds product catalog tools to agents.json, making your products discoverable by AI agents. = Why should I care about AI discovery? = AI assistants like ChatGPT, Claude, and Perplexity are increasingly used to find businesses and services. If your site isn't AI-discoverable, you're invisible to this growing channel. AI-Ready WP makes your site speak the language AI agents understand. = Can I let Claude or ChatGPT configure the plugin? = Yes. Connect your AI through the hosted MCP server at wp.studiomeyer.io; the settings page lists the five steps. Reading is free: score and checks, settings, pages with their SEO fields, robots.txt, crawler statistics and a diagnosis with fixes. Writing needs AI-Ready WP Pro on this site: settings, titles and descriptions per page, rebuilds and IndexNow pings, plus the SEO tools. Every change your AI makes goes through the same validation as the settings page, and it needs an administrator's application password, which you can revoke in your profile at any time. = Does this make external connections? = The only external connection is IndexNow (optional), which notifies search engines about content changes. All other features work entirely locally. See the Third-Party Services section below. = Which AI crawlers does the plugin allow? = All of them, by default. robots.txt names 27 AI crawlers (GPTBot, ClaudeBot, Claude-SearchBot, PerplexityBot, Google-Extended, Applebot, Meta-ExternalAgent, Amazonbot, DuckAssistBot, the Mistral crawlers and more) and allows each one explicitly, with a Content-Signal line that says what they may do with your content. A crawler reads only the group that names it, so every group repeats your site's own Disallow rules; naming a bot never opens a directory you keep closed. A bot that another plugin or a hand-written rule already addresses is left alone. = Can I block AI crawlers instead? = Yes. The AI Bot Policy section has two checkboxes: one turns away the training crawlers (your content then stays out of future models), the other the retrieval crawlers (your site then no longer appears in AI answers; not recommended). The Content-Signal line follows your choice. = The status table says a document is built on the fly. Is that a problem? = No. The plugin writes `agents.json`, `agent-card.json`, `agent.json` and `mcp.json` into the `.well-known` directory of your site, and `llms.txt` and `llms-full.txt` into the site root, and when that works your web server hands them out without starting PHP. When it cannot write there, the same documents are built from your settings and content instead, the two text files from a cache that is refreshed whenever your content changes. Visitors and AI crawlers get exactly the same answer either way. The only difference is a little PHP per request, so it is worth fixing, but nothing is broken while you do. = Which file permissions does the plugin need? = The `.well-known` directory in the root of your site has to belong to the user your PHP runs as, usually `www-data`, `nginx`, `apache` or your hosting account name, with mode 755. The plugin writes files into it with mode 644. If the directory does not exist yet, the site root has to be writable so the plugin can create it. On servers with a Let's Encrypt certificate this directory very often belongs to `root`, because certbot created it before WordPress ever got there. That is the single most common reason for a write failure. The settings page names the directory, the owner and the PHP user, and gives you the exact `chown` command to hand your host. = My discovery URLs answer 404. What now? = That is a different problem from a failed write, and the settings page tells the two apart. A 404 means something in front of WordPress is answering the request. On nginx it is almost always a `location` block for `/.well-known/` left behind by the SSL setup, which serves that path straight from disk and never reaches PHP. Ask your host to restrict that block to `/.well-known/acme-challenge/`. The rest of `/.well-known/` then reaches WordPress again and the documents answer. == Screenshots == 1. Settings page with the AI-Readiness Score and business information fields. 2. SEO Settings meta box in the block editor — title, description, focus keyword, canonical URL, noindex/nofollow. 3. Dashboard widget with AI-Readiness Score checklist — 12 checks at a glance. 4. Feature toggles and AI bot policy — switch on the discovery features you need and choose which AI bots may crawl your content. == Third-Party Services == This plugin connects to the following external service: = IndexNow API = When IndexNow is enabled, the plugin notifies search engines about content changes for faster indexing: * **Service URLs:** * `https://api.indexnow.org/indexnow` * `https://www.bing.com/indexnow` * **Data sent:** Your site URL, the URLs of changed pages, and your IndexNow key * **When:** On content publish or update * **Purpose:** Faster search engine indexing by Bing, Yandex, and other participating search engines * **IndexNow:** [https://www.indexnow.org](https://www.indexnow.org) * **IndexNow Terms of Use:** [https://www.indexnow.org/terms](https://www.indexnow.org/terms) * **IndexNow Privacy:** [https://www.indexnow.org/privacy](https://www.indexnow.org/privacy) * **Bing IndexNow:** [https://www.bing.com/indexnow](https://www.bing.com/indexnow) * **Microsoft Privacy Statement:** [https://privacy.microsoft.com/en-us/privacystatement](https://privacy.microsoft.com/en-us/privacystatement) IndexNow is enabled by default but can be disabled in Settings > AI-Ready. The plugin itself makes no other external connection. = AI-Ready WP MCP server (optional) = The plugin makes no connection to wp.studiomeyer.io. If you connect your AI through that server (see "Connect your AI (MCP)"), the server calls this site's REST API over HTTPS with the application password you created there, and stores those credentials encrypted. Nothing leaves this site until you sign in there and connect it; removing the application password in your profile ends the access. * **Service URL:** `https://wp.studiomeyer.io` * **Data exchanged:** the plugin settings, the readiness score, the discovery documents, your pages' titles, descriptions and text, robots.txt and the crawler statistics; with Pro also the Pro module settings * **Terms:** [https://studiomeyer.io/en/terms](https://studiomeyer.io/en/terms) * **Privacy:** [https://studiomeyer.io/en/privacy](https://studiomeyer.io/en/privacy) == Changelog == = 4.5.2 = * Fixed: The readiness check for robots.txt asks your site instead of your settings. robots.txt is the one document this plugin does not write, it is filtered into WordPress's own output, so a static robots.txt in your site root or an SEO plugin answering first leaves the crawler groups, the content signals and the discovery pointers out of the file a crawler actually reads. Every setting still said the feature was on, and the score gave full marks for it. Found on a live site. Your site is not blocked when this happens; it simply gets none of what the feature adds, and now you are told. * New: The diagnosis names that case and what to look for. As everywhere else here, a check that could not run at all still counts as working. = 4.5.1 = * Fixed: Inline JavaScript and CSS no longer read as text. A `