Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/mjs-media/mjs-ai-ready/archive/refs/heads/main.zipUpdates itself. It ships its own updater, so new versions appear under Dashboard → Updates.
A WordPress plugin and a report tool for the AI Ready Upgrade: a one-off job that makes an existing client's WordPress site easy for search engines and AI search tools (ChatGPT, Claude, Perplexity, Copilot, Google) to reach and describe correctly.
- The plugin (
mjs-ai-ready.php,inc/,assets/) goes on the client's site. It works on any WordPress site (block themes, Divi, Elementor, Yoast, Rank Math) and doesn't need the MJS Client Kit. - The report tool (
bin/report,report/) runs on Matt's Mac only. It audits a site over SSH and from outside, asks Claude what AI search knows about the business, and writes a branded HTML + PDF report. API keys stay on the Mac.
New builds on the MJS themes already do the basics in the theme (inc/seo.php); the MJS Websites theme hands robots.txt, llms.txt and the business schema to this plugin when it's active, so the plugin can go on those sites too.
Installing on a site
- Without SSH: run
bin/build-zip, then in WP admin go to Plugins → Add New → Upload Plugin and choosedist/mjs-ai-ready.zip. Activate, then fill in Settings → AI ready. The same zip is attached to every GitHub release. - With SSH:
./deploy.sh <ssh-host> <wp-path>/wp-content/plugins/mjs-ai-ready, or copy the zip up andwp plugin install mjs-ai-ready.zip --activate. - Updates come from the GitHub release's
mjs-ai-ready.zip. The repo is public, so sites need no token; they check about every six hours and auto-update.wp ai-ready statusshows whether updates are working. - Keep each client's settings in
sites/<domain>.jsonso they can be re-applied withwp ai-ready setup - < sites/<domain>.json. The folder is git-ignored (the repo is public and settings can include addresses kept off the client's site); it lives in Dropbox only.
What the plugin does
| Settings → AI ready | Business name, schema.org type, plain-English summary, services (one line + page each), address (or town only), areas served, opening hours, contact methods, profile links, FAQs, key pages, Search Console / Bing verification codes. A check at the top shows what's good and what isn't. |
| robots.txt | Adds named rules for the 14 search and AI crawlers (same list as the Express Removals theme, inc/bots.php). Choice: allow everything (default), or allow search and AI search but block training crawlers (GPTBot, ClaudeBot, Google-Extended, Applebot-Extended), or leave robots.txt alone. Keeps WordPress's and the SEO plugin's own lines. |
| Physical robots.txt | If a real robots.txt file exists, WordPress's filter never runs. The admin shows a warning, the audit flags it, and wp ai-ready fix-robots backs it up and removes it. |
| /llms.txt | Built from the settings, then the published pages (minus noindex and the privacy page) and the latest posts. Cached for an hour, rebuilt on save. A real llms.txt file (Yoast can write one) wins. |
| Structured data | LocalBusiness (or the chosen subtype) with @id /#business on every page; a Service per service (all on the homepage, each on its own page); FAQPage on pages that show the FAQ block/shortcode. With Yoast the nodes go into wpseo_schema_graph, with Rank Math into rank_math/json_ld, so there's one graph and no duplicates. Otherwise its own ` |