NEWOur agents now make the SEO fixes on your site and check what worked →
Claude Code logoDrupal logo

Fix Drupal SEO from Claude Code

Claude Code reads your real Google Search Console data through SEOmatic, finds what is holding your Drupal nodes back, stages the fix, and tells you whether it worked. In Approval mode nothing goes live on Drupal until you approve it.

  • Your real Search Console data
  • Fixes staged in Drupal, with your approval
  • Each change measured afterwards
Start Trial
SEOmatic astronaut working in Claude Code
Claude Code logo
Claude Code

Last Updated

November 2026

Connect Claude Code

One claude mcp add command, then claude mcp login seomatic to sign in. A plugin adds 21 SEO skills.

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 Drupal SEO from Claude Code

Why Claude Code Needs SEOmatic on Drupal

Your Drupal content lives in Drupal, not in a repo, so Claude Code cannot change it with a file edit. Through SEOmatic it reads your Search Console, picks the nodes losing clicks and stages the change, which SEOmatic writes through Drupal's JSON:API once you approve. If you keep theme or template code in a repo, Claude Code can still fix that part directly.

What It Looks Like

You: Check /services/sewer-line-inspection in Search Console and fix its title.

Claude Code: From Sep 13 to Oct 10 (28 days), /services/sewer-line-inspection had 980 impressions and 7 clicks at position 9.1 for "sewer line inspection". That is a low click rate for page one, so the title is the first thing to test: it reads "Sewer Line Inspection". I staged a new title, "Sewer Line Camera Inspection: Cost and What We Check", to be written to the node's meta title, through Metatag if your site runs it. Approve it here or in SEOmatic and it goes live on Drupal.

An example on a demo site; your numbers come from your own Search Console.

Step 1: Connect Drupal to SEOmatic

Enable the JSON:API module (it ships with core) and install Simple OAuth. In Drupal, go to Configuration, then Simple OAuth, and create a Consumer. Give it a user with permission to write content, then copy the Client ID and Secret. The full walkthrough, with every screen, is on the Drupal integration page.

Step 2: Connect SEOmatic to Claude Code

Run this in your terminal, then run claude mcp login seomatic. Sign in to SEOmatic in the browser and pick your site. Add --scope user to the command to use SEOmatic in every project, not just this one.

Connect Claude Code
claude mcp add --transport http seomatic https://app.seomatic.ai/api/mcp

Other ways to connect are on the Claude Code page.

Step 3: Ask Claude Code, Then Approve

Paste any of these into Claude Code. It answers from your data and stages the fix; you approve it before it reaches Drupal.

  • “Stage new meta titles for nodes with high impressions and low CTR.”
  • “Which nodes compete for the same query?”
  • “Which Drupal nodes lost the most clicks in the last 28 days?”

More that work well in Claude Code:

  • “Audit my live site and find the code behind each issue”
  • “Which pages ship a noindex by mistake?”
  • “Check the preview deploy before I merge”

Did It Work?

After you approve, SEOmatic writes the change through Drupal's JSON: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 Claude Code "Did my Drupal title changes work?" and it answers from those verdicts.

What Claude Code Can Change on Drupal

Writes And Improves Nodes

New nodes written from research, plus rewrites of the title and body content on ones already published.

Path Aliases, Not Node IDs

Agents set the URL alias, so your pages keep readable addresses instead of falling back to /node/123.

You Set The Pace

The agent arrives switched off. Once on, it ships undoable fixes by itself and waits for you on anything larger, unless you choose Approval mode, where every change waits.

Drupal sites differ enormously in which contributed modules they run, so agents check what your content types and modules actually provide before they write, and tell you about the rest instead of guessing at your field set.

Every field, limit and safeguard is on the Drupal integration page.

Requirements

Drupal

A Drupal site with the JSON:API module enabled (it ships with core) and the Simple OAuth module installed. You create a Consumer under Configuration > Simple OAuth whose user has permission to write content, then paste its Client ID and Secret. Meta fields additionally need the Metatag module.

Claude Code

Claude Code and a free SEOmatic account. No API key and no Google Cloud project: the connection signs in through your browser.

Use Claude Code on Another Platform

Frequently Asked Questions

Can Claude Code fix SEO on my Drupal site?

Yes, through SEOmatic. Claude Code reads your Search Console data, finds the nodes losing clicks and stages the fix, which SEOmatic writes to Drupal once you approve. The three setup steps are on this page.

What can Claude Code change on Drupal?

SEOmatic works on your nodes through Drupal's JSON:API. Which fields it can write there, and every limit, are listed on the Drupal integration page.

How do I know if a Drupal 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. Claude Code can read those verdicts for you.

What do I need on the Claude Code side?

Claude Code and a free SEOmatic account. No API key and no Google Cloud project: the connection signs in through your browser.

Will Claude Code publish to Drupal 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.