Claude Code
One command connects your Search Console to the terminal, so Claude Code fixes SEO in the code.
OpenCode SEO: Real Search Data for Any Model You Run
OpenCode lets you pick the model: Claude, GPT, Gemini, DeepSeek, Kimi or a local one. Add SEOmatic to opencode.json and whichever model you run can see which pages lose clicks on Google, which ones Google skipped, and where AI answers leave you out. It fixes the cause in your code, or on paid plans stages the fix in your CMS for your approval.
- Four lines in opencode.json, sign-in opens by itself
- Works the same with every model OpenCode runs
- Finds the problem in Search Console, fixes it in the code
OpenCode
About SEOmatic for OpenCode
SEOmatic is a hosted MCP server that OpenCode adds as a remote server in opencode.json. OpenCode signs in with OAuth on its own, or sends an API key header, and then calls SEOmatic's SEO tools on one workspace with whatever model you run.
Last Updated
October 2026
Requirements
OpenCode installed and set up with a model provider, and a free SEOmatic account. For CI or a machine with no browser, create an API key in Settings, AI Agents, API Keys.
Pricing
Free to connect, with 5 questions a month from your own data (plus 10 once you connect Search Console). Paid plans add agents that stage fixes for your approval. See pricing.
Full Docs
Endpoint, auth, every tool and what it costs: SEOmatic MCP server docs.
OpenCode for SEO, Grounded in Your Search Console
What OpenCode Can Do for Your SEO
Traffic Drops Tied to Commits
OpenCode compares two date ranges in Search Console, then checks the git log for the change that lines up with the drop.
Titles Rewritten From Real Queries
It reads the searches each page appears for and rewrites the title and description in your code to match them.
Index Problems Traced to the Code
For pages Google skipped, OpenCode finds the noindex, canonical or redirect in your repo that explains it.
Pre-Deploy Audit
An audit of up to 30 pages for missing titles, broken links, duplicate descriptions and slow pages, before you ship.
AI Answer Gaps
Which questions ChatGPT, Claude and Google AI Overviews answer without naming you, and which pages they cite instead.
CMS Fixes You Approve
For WordPress, Shopify, Webflow and other CMS sites, OpenCode stages fixes in SEOmatic on paid plans for your approval.
OpenCode already reads your repo and runs your git history. Give it your search data too, and it can tie a drop in clicks to the commit that caused it.
Example: Ask OpenCode About Your Site
An example on the Acme Plumbing demo site. You ask OpenCode:
“Clicks dropped last month. Which pages lost them, and is it something we shipped?”
OpenCode calls SEOmatic:
seomatic gsc_performance: Aug 15 to Sep 11 vs Sep 12 to Oct 9 (28 days each)git log --since=2026-09-01 -- src/pages
OpenCode answers:
Clicks fell from 1,480 to 1,090 (Aug 15 to Sep 11 vs Sep 12 to Oct 9, 28 days each). Two pages explain most of it:
- /drain-cleaning-cost lost 210 clicks. Its position slipped from 4.1 to 9.7 after a Sep 15 commit that moved the price table into a tab Google does not render.
- /water-heater-repair lost 120 clicks with steady rankings. The Sep 18 commit shortened its title to “Water Heaters”, and CTR fell from 4.0% to 2.3%.
I can restore the price table to the page body and put “repair” back in the title. You review the diff; nothing changes live until you deploy.
Also try:
- “Which pages has Google not indexed, and why?”
- “Audit the site before I deploy”
- “Which pages rank on page two?”
- “Do AI answers cite /emergency-plumber?”
One Setup, Any Model
In most tools, the SEO connection and the model come as a pair. OpenCode splits them. You add SEOmatic once, in opencode.json, and every model you run there gets the same tools:
- A fast, cheap model for quick checks, like “is this URL indexed?”
- A stronger model for the work that needs judgment, like planning a month of fixes from a traffic drop.
- A local model for code you would rather keep off a vendor's servers. Only the SEOmatic tool calls leave your machine.
The numbers do not change with the model, because they come from your Search Console through SEOmatic, not from the model's memory.
OpenCode SEO Prompts to Try
Run these in OpenCode from the root of your site's repo:
- “Clicks dropped last month. Which pages lost them, and is it something we shipped?”
- “Which pages get impressions on Google but few clicks? Rewrite their titles in the code.”
- “List the pages Google has not indexed and find the cause in this repo.”
- “Audit the site before I deploy and fix anything that would hurt rankings.”
- “Which keywords rank on page two, and what would move each page up?”
- “Which questions do AI assistants answer without citing us?”
The SEO Tools OpenCode Gets
- Search Console performance and insights: clicks, impressions, CTR and position, period comparisons, CTR outliers and cannibalization, with exact date ranges.
- Indexing checks: whether Google indexed a URL, and why not.
- Site audit and page scores: up to 30 pages per crawl, or a 0 to 100 score for one URL.
- AI visibility and citations: where ChatGPT, Claude and Google AI Overviews mention or cite you.
- Keyword and backlink research on paid plans, with one free keyword preview.
- Tasks and campaigns on paid plans: fixes for CMS sites, staged for your approval.
Run opencode mcp list to see the connection, and the SEO MCP server reference for every tool.
How It Works, Step by Step
- You ask OpenCode a question about your site, from the repo.
- The model you picked calls the SEOmatic tools it needs, such as a period comparison or an indexing check.
- SEOmatic returns your real data and its own analysis, with exact date ranges.
- OpenCode reads the matching files and git history, explains the cause and edits the code. You review the diff.
- For CMS sites on a paid plan, OpenCode stages the fix in SEOmatic instead. You approve it, and SEOmatic applies it with a rollback point.
How to Connect SEOmatic to OpenCode
About a minute, with OpenCode installed and a model set up.
- Open opencode.json. Open opencode.json in your repo, or your global OpenCode config if you want SEOmatic in every project.
- Add the seomatic server. Under mcp, add an entry named seomatic with "type": "remote" and "url": "https://app.seomatic.ai/api/mcp". Keep any servers already there.
- Sign in to SEOmatic. Start OpenCode. When it first reaches SEOmatic, it opens the sign-in in your browser. You can also run opencode mcp auth seomatic. Sign in or create a free account and pick your site.
- Check the connection. Run opencode mcp list and check that seomatic shows as connected and signed in.
- Ask about your site. Ask: “How did my site do on Google over the last 28 days?” The answer should name the date range and your real numbers.
OpenCode setup
// opencode.json
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"seomatic": {
"type": "remote",
"url": "https://app.seomatic.ai/api/mcp"
}
}
}
// sign in (OpenCode also starts this on its own)
opencode mcp auth seomatic
opencode mcp list
// CI or no browser: add an API key header instead
"seomatic": {
"type": "remote",
"url": "https://app.seomatic.ai/api/mcp",
"headers": {
"Authorization": "Bearer {env:SEOMATIC_API_KEY}"
}
}If seomatic shows as connected but not signed in, run opencode mcp auth seomatic again. opencode mcp debug seomatic shows what went wrong, and opencode mcp logout seomatic clears the stored sign-in if you want to switch workspaces.
OAuth, API key or skills?
| Route | Best for | How |
|---|---|---|
| opencode.json with OAuth | Most people working on their own machine | Add the block above. OpenCode opens the sign-in when needed, or run opencode mcp auth seomatic. |
| opencode.json with an API key | CI, servers with no browser, or shared runners | Add "headers": { "Authorization": "Bearer {env:SEOMATIC_API_KEY}" } to the seomatic entry and set the variable. |
| Skills only | Running SEO checks through the SEOmatic CLI | npx skills add Minh42/seomatic-mcp -a opencode, with SEOMATIC_API_KEY set. |
Pick opencode.json with OAuth. It is four lines, no key to copy, and OpenCode stores the sign-in for next time. Switch to the key only where no browser can open.
OpenCode or the Model Inside It: Which One Is This?
OpenCode is the open-source terminal coding agent from Anomaly (the team formerly known as sst), at opencode.ai. It is one of the most-starred coding agents on GitHub. SEOmatic connects to OpenCode, not to the model.
- The model you pick in OpenCode, such as Claude, GPT, Gemini, DeepSeek or Kimi K3, uses the same SEOmatic tools. Switching models needs no new setup.
- Other terminal agents, like Claude Code or Codex, have their own setup on their own pages.
This page covers OpenCode in the terminal.
What Is Free and What Is Paid
Connecting is free, and so is the SEOmatic account behind it: no card. A free account answers 5 questions a month from your own data, plus 10 bonus questions once you connect Google Search Console. Each tool call counts as one question, so a big request can use a few.
Free covers the diagnosis: Search Console reports and insights, site audits of up to 30 pages, live page analysis, and your AI visibility results. Live market data, like keyword volumes, backlink profiles and competitor domains, is part of paid plans, with one free keyword preview per workspace.
Paid plans remove the question limit and add the treatment: agents stage fixes on your site (titles, descriptions, content updates, technical fixes, internal links) and run campaigns and fresh AI visibility scans. Every paid plan starts with a 14-day free trial. See pricing.
Your model provider bills OpenCode's own work, like reading files and writing code, separately. SEOmatic questions count only the SEOmatic tool calls.
Nothing Changes on Your Site Without Your Approval
OpenCode works in two places, and both keep you in charge. In your repo, it edits files and you review the diff before anything ships. In your CMS, it can only stage a fix in SEOmatic. A staged change is a proposal: it says what will change and why, and nothing touches your site until you approve it. The assistant records your decision, and it is told never to approve anything on its own judgment. Approved fixes start within seconds, the page's previous state is stored, and any applied change can be rolled back. Changes that could take a page out of Google, like a noindex, need an extra explicit confirmation.
Keep Exploring
Using another terminal agent? See Claude Code SEO, Codex, goose and Kilo Code. Running an open model? See DeepSeek and Kimi K3. Learn what powers the answers: page indexing checks, technical SEO fixes and meta tags. All agents: AI SEO agents in every assistant. Full reference: SEO MCP server docs.
Using another agent? See Claude Code, Codex, Kilo Code, or every AI agent.
Frequently Asked Questions
How do I connect SEOmatic to OpenCode?
Add a remote server to opencode.json: under mcp, an entry named seomatic with "type": "remote" and "url": "https://app.seomatic.ai/api/mcp". Start OpenCode, and it opens the SEOmatic sign-in in your browser the first time. You can also run opencode mcp auth seomatic.
Do I need an API key?
Not on your own machine. OpenCode signs in with OAuth on its own. For CI or a server with no browser, create an API key in SEOmatic, set it as SEOMATIC_API_KEY, and add an Authorization header that reads Bearer {env:SEOMATIC_API_KEY} to the seomatic entry.
Does it matter which model I use?
Not for the data. Every model in OpenCode gets the same SEOmatic tools, and the numbers come from your Search Console, not from the model. Stronger models tend to plan and explain better, so use one for bigger questions.
Can I keep SEOmatic in just one project?
Yes. Put the seomatic entry in the opencode.json inside that repo. Put it in your global OpenCode config instead to have it everywhere.
Can OpenCode fix SEO problems in my code?
Yes. It reads your Search Console data through SEOmatic, finds the cause in your repo, such as a noindex tag, a weak title template or a recent commit, and edits the files. You review the diff and deploy when you are ready.
Are the numbers real?
Yes. They come from your own Google Search Console through SEOmatic, with exact date ranges such as Sep 12 to Oct 9, 28 days. SEOmatic tells the model to state only numbers that came from a tool result.
Is SEOmatic for OpenCode free?
Yes. Connecting and the SEOmatic account are free, with no card. A free account answers 5 questions a month from your own data, plus 10 bonus questions once you connect Search Console. Paid plans remove the limit and add agents that stage fixes, with a 14-day free trial.
Can it change my site 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.
OpenCode says seomatic needs authentication. What now?
Run opencode mcp auth seomatic and finish the sign-in in the browser. If that does not help, opencode mcp debug seomatic shows the error. On a machine with no browser, use the API key header instead.
Do I need a Google Cloud project?
No. You connect Search Console to SEOmatic once with a normal Google sign-in, and OpenCode reaches it through SEOmatic. There is no service account or API key to set up on the Google side.
SEOmatic in other AI agents
Same server, same tools, same approval rules. Pick the agent that fits the job.
Codex
Two commands give Codex your Search Console data, so it fixes SEO where the bug lives: in your code.
Grok Build
Two commands give Grok Build your real Search Console data, so it can find what costs you clicks and fix it in the code.
Kimi K3
Kimi K3 in Kimi Code CLI, reading your real Search Console and fixing what it finds in your repo.
DeepSeek
DeepSeek, working from your real Search Console data through the SEOmatic plugin for DeepSeek Harness.
Cursor
One mcp.json entry, and Cursor's agent works from your real Search Console data while it edits your code.