Fix Craft CMS SEO from Claude
Claude SEO on your real Search Console data, with fixes you approve in the same chat.
Fix Craft CMS SEO from Hermes Agent
Hermes Agent reads your real Google Search Console data through SEOmatic, finds what is holding your Craft CMS entries back, stages the fix, and tells you whether it worked. By default nothing goes live on Craft CMS until you approve it.
- Your real Search Console data
- Fixes staged in Craft CMS, with your approval
- Each change measured afterwards
Hermes Agent
Last Updated
October 2026
Connect Hermes Agent
One hermes mcp add with OAuth. Tools show up as mcp_seomatic_ and work from the CLI or chat.
Cost
Free to connect and to read your Search Console. Staged fixes are part of paid plans, with a 14-day trial. See pricing.
How to Fix Craft CMS SEO from Hermes Agent
Why Hermes Agent Needs SEOmatic on Craft CMS
Hermes Agent is built for work that runs without you watching, so it suits a recurring check on your Craft CMS site: compare your entries against Search Console every week, speak up only when something moved, and stage the fix. Nothing reaches Craft CMS until you approve it, and SEOmatic writes it through Craft's GraphQL API.
What It Looks Like
You: Every Monday, check my Craft CMS site and flag pages that lose clicks.
Hermes Agent: This week's check: from Sep 13 to Oct 10 (28 days), /services/repiping had 1,120 impressions and 9 clicks at position 8.0 for "whole house repiping cost". That is a low click rate for page one, so the title is the first thing to test: it reads "Repiping". I staged a new title, "Whole House Repiping Cost and Timeline", to be written to the entry's SEO title field. It waits for your approval, and I will report the verdict once the change has had time to settle.
An example on a demo site; your numbers come from your own Search Console.
Step 1: Connect Craft CMS to SEOmatic
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. 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. The full walkthrough, with every screen, is on the Craft CMS integration page.
Step 2: Connect SEOmatic to Hermes Agent
Run this in your terminal. Hermes registers the server, opens your browser to sign in to SEOmatic, and stores the token. Then run hermes mcp test seomatic.
Connect Hermes Agent
hermes mcp add seomatic --url https://app.seomatic.ai/api/mcp --auth oauthOther ways to connect are on the Hermes Agent page.
Step 3: Ask Hermes Agent, Then Approve
Paste any of these into Hermes Agent. It answers from your data and stages the fix; you approve it before it reaches Craft CMS.
- “Audit my live site and rank the fixes by impact.”
- “Stage new SEO titles for entries with high impressions and low CTR.”
- “Which entries rank 5 to 15 and could reach the top three?”
More that work well in Hermes Agent:
- “Every Friday, send me what changed on Google”
- “Which pages lost clicks this month?”
- “Is /drain-cleaning-cost indexed?”
Did It Work?
After you approve, SEOmatic writes the change through Craft's GraphQL 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 Hermes Agent "Did my Craft CMS title changes work?" and it answers from those verdicts.
What Hermes Agent Can 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.
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.
Every field, limit and safeguard is 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.
Hermes Agent
Hermes Agent installed and set up, and a free SEOmatic account. For a server with no browser, create an API key in Settings, AI Agents, API Keys.
Use Hermes Agent on Another Platform
Hermes Agent works the same way on WordPress, Webflow, Shopify, Ghost, Blogger, Wix, Squarespace, Framer, Drupal, BigCommerce, HubSpot CMS, Contentful, Strapi, Sanity, Next.js, Lovable, GitHub.
Frequently Asked Questions
Can Hermes Agent fix SEO on my Craft CMS site?
Yes, through SEOmatic. Hermes Agent reads your Search Console data, finds the entries losing clicks and stages the fix, which SEOmatic writes to Craft CMS once you approve. The three setup steps are on this page.
What can Hermes Agent change on Craft CMS?
SEOmatic works on your entries through Craft's GraphQL API: titles, descriptions and content first, and more where Craft CMS allows it. Every field and limit is listed on the Craft CMS integration page.
How do I know if a Craft CMS 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. Hermes Agent can read those verdicts for you.
What do I need on the Hermes Agent side?
Hermes Agent installed and set up, and a free SEOmatic account. For a server with no browser, create an API key in Settings, AI Agents, API Keys.
Will Hermes Agent 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. 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 free trial.
Fix Craft CMS SEO From Another Agent
The same SEOmatic server and approval rules, from the agent you prefer.
Fix Craft CMS SEO from Claude Code
One command connects your Search Console to the terminal, so Claude Code fixes SEO in the code.
Fix Craft CMS 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 Craft CMS SEO from ChatGPT
ChatGPT SEO on your real Search Console data, with fixes you approve in the same chat.
Fix Craft CMS SEO from Codex
Two commands give Codex your Search Console data, so it fixes SEO where the bug lives: in your code.
Fix Craft CMS SEO from Gemini
Your real Search Console data in the Gemini app and in Gemini CLI, with fixes you approve.