Fix Craft CMS SEO from Codex
Codex reads your real Google Search Console data through SEOmatic, finds what is holding your Craft CMS pages back, and stages the fix. Nothing goes live on Craft CMS until you approve it, and any edit to an existing page can be rolled back.
- Your real Search Console data
- Fixes staged in Craft CMS
- Nothing goes live until you approve
About Craft CMS in SEOmatic
SEOmatic connects to Craft CMS through its GraphQL API with a schema-scoped token. Agents write new entries and improve existing ones, reading the save mutation for each entry type first so they only ever write to fields your layout really has.
Last Updated
October 2026
Requirements
Craft 5 (any edition, including the free Solo edition) or Craft Pro 3.5 to 4.x, with the GraphQL API enabled, and a GraphQL token whose schema can read and save entries in the sections you want agents to work on.
How to Fix Craft CMS SEO from Codex
Step 1: Connect Craft CMS to SEOmatic
SEOmatic connects to Craft with a GraphQL token, then works on the entries you already have.
Step 1: In your Craft control panel, go to GraphQL, then Tokens, click New token, and select a schema with access to your sections. Copy the token.
Step 2: In SEOmatic, go to Connections, select Craft CMS, and enter your site domain and the token. SEOmatic finds your GraphQL endpoint and validates the connection.
Step 3: Agents read your Search Console data, find the entries losing clicks they should be winning, and propose the fixes with the reasoning attached.
Step 4: You approve what you want. Approved work is written to Craft, logged as a diff you can read, and undone in one click if you change your mind.
Step 2: Connect SEOmatic to Codex
Run these two commands in your terminal. The second one opens your browser: sign in to SEOmatic and pick your site. The CLI and the IDE extension share the same config, so this covers both.
codex mcp add seomatic --url https://app.seomatic.ai/api/mcp
codex mcp login seomaticOther ways to connect are on the Codex page.
Step 3: Ask Codex, Then Approve
Paste any of these. Codex answers from your data and stages the fix; you approve it before it reaches Craft CMS.
- “Which of my Craft CMS pages lost the most clicks this month, and why?”
- “Stage new titles for my Craft CMS pages with high impressions and low CTR.”
- “Find Craft CMS pages Google has not indexed and tell me what is blocking them.”
- “Audit my Craft CMS homepage and rank the fixes by impact.”
What Codex Can Change on Craft CMS
New entries from research to finished draft, plus rewrites of the title, body and slug on ones already published.
Content goes into a plain text, CKEditor or Redactor field with a conventional handle, such as body or content, on your entry type. If an entry type has no such field, the body change comes to you instead of being forced somewhere it does not belong.
Matrix and Neo fields drop any block a write leaves out, so agents never write to them. Your page builder content cannot be wiped by an SEO edit.
When your layout has plain fields for the meta title, meta description, canonical URL or a noindex switch, agents fill them and read them back to confirm they saved.
The agent arrives switched off and starts in approval mode. It earns more rope only when you give it.
A before and after view with the reasoning attached, so you see what changed and why.
Any change rolls back to its exact previous value, including clearing an SEO field that was empty before.
Agents see every entry, including disabled and pending ones. If a new entry's slug matches one you already have, they update that entry, snapshotted first so it can be undone, instead of creating a duplicate beside it.
Craft gives you total control over your content model, which means no two sites store SEO the same way. Agents do not assume: they check what each entry type accepts and write only there.
Full details on the Craft CMS integration page.
Requirements
Craft CMS
Craft 5 (any edition, including the free Solo edition) or Craft Pro 3.5 to 4.x, with the GraphQL API enabled, and a GraphQL token whose schema can read and save entries in the sections you want agents to work on.
Codex
Codex (the CLI, the IDE extension or the desktop app) signed in with your ChatGPT account, and a free SEOmatic account. No API key needed for the browser sign-in.
Fix Craft CMS SEO from Another Agent
- Fix Craft CMS SEO from Claude
- Fix Craft CMS SEO from Claude Code
- Fix Craft CMS SEO from Claude Cowork
- Fix Craft CMS SEO from ChatGPT
- Fix Craft CMS SEO from Gemini
- Fix Craft CMS SEO from Grok Bot
- Fix Craft CMS SEO from Perplexity Computer
- Fix Craft CMS SEO from OpenClaw
- Fix Craft CMS SEO from Hermes Agent
- Fix Craft CMS SEO from Manus
- Fix Craft CMS SEO from Cursor
Use Codex on Another Platform
- Fix WordPress SEO from Codex
- Fix Webflow SEO from Codex
- Fix Shopify SEO from Codex
- Fix Ghost SEO from Codex
- Fix Blogger SEO from Codex
- Fix Wix SEO from Codex
- Fix Squarespace SEO from Codex
- Fix Framer SEO from Codex
- Fix Drupal SEO from Codex
- Fix BigCommerce SEO from Codex
- Fix HubSpot CMS SEO from Codex
- Fix Contentful SEO from Codex
- Fix Strapi SEO from Codex
- Fix Sanity SEO from Codex
- Fix Next.js SEO from Codex
- Fix Lovable SEO from Codex
- Fix GitHub SEO from Codex
Frequently Asked Questions
Can Codex fix SEO on my Craft CMS site?
Yes, through SEOmatic. Codex reads your Google Search Console data, finds what is holding your Craft CMS pages back and stages the fix. SEOmatic connects to Craft CMS through its GraphQL API with a schema-scoped token. Agents write new entries and improve existing ones, reading the save mutation for each entry type first so they only ever write to fields your layout really has.
What can Codex change on Craft CMS?
Writes And Improves Entries: New entries from research to finished draft, plus rewrites of the title, body and slug on ones already published. Body Fields It Can Safely Write: Content goes into a plain text, CKEditor or Redactor field with a conventional handle, such as body or content, on your entry type. If an entry type has no such field, the body change comes to you instead of being forced somewhere it does not belong. Matrix Blocks Stay Intact: Matrix and Neo fields drop any block a write leaves out, so agents never write to them. Your page builder content cannot be wiped by an SEO edit. SEO Fields You Already Have: When your layout has plain fields for the meta title, meta description, canonical URL or a noindex switch, agents fill them and read them back to confirm they saved. Nothing Applies Without You: The agent arrives switched off and starts in approval mode. It earns more rope only when you give it. A Diff For Every Change: A before and after view with the reasoning attached, so you see what changed and why.
What do I need to connect Craft CMS?
Craft 5 (any edition, including the free Solo edition) or Craft Pro 3.5 to 4.x, with the GraphQL API enabled, and a GraphQL token whose schema can read and save entries in the sections you want agents to work on.
What do I need on the Codex side?
Codex (the CLI, the IDE extension or the desktop app) signed in with your ChatGPT account, and a free SEOmatic account. No API key needed for the browser sign-in.
Will Codex publish to Craft CMS without asking?
No. By default every change SEOmatic proposes waits for your approval before it touches your site, and your assistant is told never to approve on its own. Approved changes are stored with the page's previous state, so any edit to an existing page can be rolled back. If you later want low-risk fixes to go ahead on their own, you can turn that on in your autonomy settings; changes to your URLs or indexing, and new content, still wait for you.
Is it free?
Connecting is free with no card: 5 questions a month from your own data, plus 10 once you connect Search Console, and site audits of up to 30 pages. Staging and publishing fixes is part of paid plans, which start with a 14-day free trial.