NEWOur agents now make the SEO fixes on your site and check what worked →
Gemini logoCraft CMS logo

Fix Craft CMS SEO from Gemini

Gemini 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. In Approval mode 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
Start Trial
SEOmatic astronaut working in Gemini
Gemini logo
Gemini

Last Updated

November 2026

Connect Gemini

A custom app in the Gemini web app, or one command in Gemini CLI for Gemini Code Assist and API-key users.

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 Craft CMS SEO from Gemini

Why Gemini Needs SEOmatic on Craft CMS

Gemini cannot reach your Craft CMS admin on its own. With SEOmatic connected, it answers from your real Search Console data, names the entries that are losing clicks, and stages the fix. You approve it in the conversation or in SEOmatic, and SEOmatic writes it to Craft CMS through Craft's GraphQL API.

What It Looks Like

You: Why does /services/repiping get impressions but so few clicks?

Gemini: 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. Approve it here or in SEOmatic and it goes live on Craft CMS.

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 Gemini

At gemini.google.com, open Settings, then Connected Apps, choose Add a custom app and paste this URL, then sign in to SEOmatic. Using Gemini CLI with Gemini Code Assist or a Gemini API key? Run gemini extensions install https://github.com/Minh42/seomatic-mcp in your shell instead.

Connect Gemini
https://app.seomatic.ai/api/mcp

Other ways to connect are on the Gemini page.

Step 3: Ask Gemini, Then Approve

Paste any of these into Gemini. It answers from your data and stages the fix; you approve it before it reaches Craft CMS.

  • “Which Craft entries lost the most clicks in the last 28 days?”
  • “Find Craft pages Google has not indexed.”
  • “Audit my live site and rank the fixes by impact.”

More that work well in Gemini:

  • “Which pages has Google not indexed?”
  • “Audit my homepage”
  • “Do AI answers mention my brand?”

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

What Gemini 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.

Gemini

Gemini web app: a personal Google account, age 18 or over, in the US, in English, with History on. Gemini CLI: a Gemini Code Assist license, a Gemini API key or Vertex AI. Google stopped Gemini CLI for personal Google sign-ins (free, Google AI Pro and Ultra) on June 18, 2026; those accounts use Antigravity, whose terminal agent, Antigravity CLI (agy), replaced it. Plus a free SEOmatic account.

Use Gemini on Another Platform

Frequently Asked Questions

Can Gemini fix SEO on my Craft CMS site?

Yes, through SEOmatic. Gemini 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 Gemini change on Craft CMS?

SEOmatic works on your entries through Craft's GraphQL API. Which fields it can write there, and every limit, are 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, or inconclusive when the data cannot tell yet. Gemini can read those verdicts for you.

What do I need on the Gemini side?

Gemini web app: a personal Google account, age 18 or over, in the US, in English, with History on. Gemini CLI: a Gemini Code Assist license, a Gemini API key or Vertex AI. Google stopped Gemini CLI for personal Google sign-ins (free, Google AI Pro and Ultra) on June 18, 2026; those accounts use Antigravity, whose terminal agent, Antigravity CLI (agy), replaced it. Plus a free SEOmatic account.

Will Gemini publish to Craft CMS 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.