NEWOur agents now make the SEO fixes on your site and check what worked →
Hermes Agent logoContentful logo

Fix Contentful SEO from Hermes Agent

Hermes Agent 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
Start Trial
SEOmatic astronaut working in Hermes Agent
Hermes Agent logo
Hermes Agent

Last Updated

November 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 for $1, credited to your first payment. See pricing.

How to Fix Contentful SEO from Hermes Agent

Why Hermes Agent Needs SEOmatic on Contentful

Hermes Agent is built for work that runs without you watching, so it suits a recurring check on your Contentful site: compare your entries against Search Console every week, speak up only when something moved, and stage the fix. In Approval mode nothing reaches Contentful until you approve it, and SEOmatic writes it through the Contentful Management API.

What It Looks Like

You: Every Monday, check my Contentful site and flag pages that lose clicks.

Hermes Agent: This week's check: 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. 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 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 Hermes Agent

Run this in your terminal. Hermes registers the server, opens your browser to sign in to SEOmatic, and stores the token. Answer Y when it asks to enable all tools. Then run hermes mcp test seomatic.

Connect Hermes Agent
hermes mcp add seomatic --url https://app.seomatic.ai/api/mcp --auth oauth

Other 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 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 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 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 (inconclusive when the data cannot tell yet), and a low-risk change that loses traffic is rolled back on its own. Ask Hermes Agent "Did my Contentful title changes work?" and it answers from those verdicts.

What Hermes Agent 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.

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

Frequently Asked Questions

Can Hermes Agent fix SEO on my Contentful site?

Yes, through SEOmatic. Hermes Agent 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 Hermes Agent change on Contentful?

SEOmatic works on your entries through the Contentful Management API. Which fields it can write there, and every limit, are 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, or inconclusive when the data cannot tell yet. 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 Contentful without asking?

No. Every fix your assistant stages 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. SEOmatic's own scheduled agents can ship reversible work, including single new articles, without a click unless you pick Approval mode in your autonomy settings; changes to your URLs or indexing, and new page sets, always 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 5 the first time you sign in from an assistant, and 10 more 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.

digi-business-uk

Each local area page used to take us half a day to create and optimize.


With SEOmatic, we can create hundreds of pages in the same time, which helps our clients make the best use of their budget.


It's transformed how we deliver scalable SEO solutions.

will-hawkins

Will Hawkins

Marketing Director, Digi-Business UK

Give Your Site an SEO Team

Agents read your Search Console data, do the work, and prove what actually moved. You decide what ships.

  • You decide what ships
  • Verified live
  • One-click rollback

14-Day Trial for $1, credited to your first payment.