Fix Craft CMS SEO from Cursor
Cursor 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 Cursor
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 Cursor
Add this to ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one repo, or add the same URL in Settings, Tools & MCP. Approve the SEOmatic sign-in in your browser and pick your site. Or install SEOmatic from the Cursor Marketplace by typing /add-plugin seomatic in Agent chat.
{
"mcpServers": {
"seomatic": { "url": "https://app.seomatic.ai/api/mcp" }
}
}Other ways to connect are on the Cursor page.
Step 3: Ask Cursor, Then Approve
Paste any of these. Cursor 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 Cursor 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.
Cursor
Cursor and a free SEOmatic account, which you can create during sign-in. Use OAuth, not an API key: Cursor does not send a configured Authorization header.
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 Codex
- 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
Use Cursor on Another Platform
- Fix WordPress SEO from Cursor
- Fix Webflow SEO from Cursor
- Fix Shopify SEO from Cursor
- Fix Ghost SEO from Cursor
- Fix Blogger SEO from Cursor
- Fix Wix SEO from Cursor
- Fix Squarespace SEO from Cursor
- Fix Framer SEO from Cursor
- Fix Drupal SEO from Cursor
- Fix BigCommerce SEO from Cursor
- Fix HubSpot CMS SEO from Cursor
- Fix Contentful SEO from Cursor
- Fix Strapi SEO from Cursor
- Fix Sanity SEO from Cursor
- Fix Next.js SEO from Cursor
- Fix Lovable SEO from Cursor
- Fix GitHub SEO from Cursor
Frequently Asked Questions
Can Cursor fix SEO on my Craft CMS site?
Yes, through SEOmatic. Cursor 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 Cursor 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 Cursor side?
Cursor and a free SEOmatic account, which you can create during sign-in. Use OAuth, not an API key: Cursor does not send a configured Authorization header.
Will Cursor 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.