Fix Contentful SEO from Claude
Claude SEO on your real Search Console data, with fixes you approve in the same chat.
Fix Contentful SEO from Codex
Codex reads your real Google Search Console data through SEOmatic, finds what is holding your Contentful entries back, stages the fix, and tells you whether it worked. In Approval mode nothing goes live on Contentful until you approve it.
- Your real Search Console data
- Fixes staged in Contentful, with your approval
- Each change measured afterwards
Codex
Last Updated
November 2026
Connect Codex
codex mcp add with the SEOmatic URL signs you in through the browser; codex mcp login signs you in again if needed. Skills install with npx skills add.
Cost
Free to connect and to read your Search Console. Staged fixes are part of paid plans, with a 14-Day Trial for $1, credited to your first payment. See pricing.
How to Fix Contentful SEO from Codex
Why Codex Needs SEOmatic on Contentful
Contentful is headless, so an SEO problem can live in two places: the entries in Contentful, or the front end that renders them. Codex fixes the front end in your repo. SEOmatic writes title, meta and content changes to the entries through the Contentful Management API, after you approve, so each fix lands where it belongs.
What It Looks Like
You: Check /guides/tankless-water-heater in Search Console and fix its title.
Codex: From Sep 13 to Oct 10 (28 days), /guides/tankless-water-heater had 1,650 impressions and 13 clicks at position 8.4 for "tankless water heater pros and cons". That is a low click rate for page one, so the title is the first thing to test: it reads "Tankless Water Heaters". I staged a new title, "Tankless Water Heater Pros and Cons, Honestly Compared", to be written to the SEO title field of that entry. Approve it here or in SEOmatic and it goes live on Contentful.
An example on a demo site; your numbers come from your own Search Console.
Step 1: Connect Contentful to SEOmatic
In Contentful, go to Settings, then CMA tokens, and generate a personal token with write access. In SEOmatic, go to Connections and select Contentful. Paste the token along with your Space ID and environment, then pick the content type to work in. The full walkthrough, with every screen, is on the Contentful integration page.
Step 2: Connect SEOmatic to Codex
Run these two commands in your terminal. The first one adds SEOmatic and opens your browser: sign in to SEOmatic and pick your site. The second one signs you in if no browser opened. The CLI, the IDE extension and Codex in the ChatGPT desktop app share the same config (~/.codex/config.toml), so this covers all three. Then start a new Codex session.
Connect Codex
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 into Codex. It answers from your data and stages the fix; you approve it before it reaches Contentful.
- “Audit my live site and tell me which issues live in content and which in code.”
- “Stage new SEO titles in the entries behind pages with low CTR.”
- “Which entries rank 5 to 15 and could move up with a refresh?”
More that work well in Codex:
- “Audit the live site and map each issue to a file”
- “Which pages get impressions but no clicks?”
- “Check the preview deploy before I merge”
Did It Work?
After you approve, SEOmatic writes the change through the Contentful Management API and checks that it is live. Then it measures the result against the page's own baseline and your site's trend: 14 days after a title change, 28 after a content refresh, 90 after a new page. Each change is marked verified, ineffective or regressed, and a low-risk change that loses traffic is rolled back on its own. Ask Codex "Did my Contentful title changes work?" and it answers from those verdicts.
What Codex Can Change on Contentful
Writes And Improves Entries
New entries written from research, plus title, slug and meta fixes on ones already published. A body rewrite on a published entry comes to you as text to paste.
Merges, Never Replaces
Contentful overwrites an entry's fields on write. Agents read it first and merge, so unsent fields survive untouched.
Finds Your Real Field Names
If your model calls it seoTitle rather than metaTitle, the change is written where your template actually reads it.
Contentful replaces an entry's fields wholesale on write, which is how integrations quietly delete the parts they were not editing. Agents read the entry first and merge into it, so a meta change stays a meta change.
Every field, limit and safeguard is on the Contentful integration page.
Requirements
Contentful
A Contentful space and a Content Management API token with write access, generated under Settings > CMA tokens. You will also need your Space ID and the environment name, usually master.
Codex
Codex (the CLI, the IDE extension, or Codex inside the ChatGPT desktop app) signed in with your ChatGPT account, and a free SEOmatic account. No API key needed for the browser sign-in.
Use Codex on Another Platform
Codex works the same way on WordPress, Webflow, Shopify, Ghost, Blogger, Wix, Squarespace, Framer, Drupal, BigCommerce, HubSpot CMS, Strapi, Sanity, Next.js, Lovable, GitHub, Craft CMS.
Frequently Asked Questions
Can Codex fix SEO on my Contentful site?
Yes, through SEOmatic. Codex reads your Search Console data, finds the entries losing clicks and stages the fix, which SEOmatic writes to Contentful once you approve. The three setup steps are on this page.
What can Codex change on Contentful?
SEOmatic works on your entries through the Contentful Management API: titles, descriptions and content first, and more where Contentful allows it. Every field and limit is listed on the Contentful integration page.
How do I know if a Contentful fix worked?
SEOmatic measures every change it ships against the page's own baseline and your site's trend, 14 days after a title change, 28 after a content refresh and 90 after a new page, and marks it verified, ineffective or regressed. Codex can read those verdicts for you.
What do I need on the Codex side?
Codex (the CLI, the IDE extension, or Codex inside the ChatGPT 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 Contentful 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. Search Console reports, page checks and 30-page site audits are free, as often as you like; live market data uses free questions, 5 a month plus a one-time 10 when you connect Search Console. Staging and publishing fixes is part of paid plans, which start with a 14-Day Trial for $1, credited to your first payment.
Fix Contentful SEO From Another Agent
The same SEOmatic server and approval rules, from the agent you prefer.
Fix Contentful SEO from Claude Code
One command connects your Search Console to the terminal, so Claude Code fixes SEO in the code.
Fix Contentful SEO from Claude Cowork
Hand Claude Cowork the SEO grunt work: it pulls your real numbers, writes the report into your files, and stages fixes you approve.
Fix Contentful SEO from ChatGPT
ChatGPT SEO on your real Search Console data, with fixes you approve in the same chat.
Fix Contentful SEO from Gemini
Your real Search Console data in the Gemini app and in Gemini CLI, with fixes you approve.
Fix Contentful SEO from Grok Bot
An always-on SEO teammate: routines that read your Search Console and speak up when something changes.