Claude Code
One command connects your Search Console to the terminal, so Claude Code fixes SEO in the code.
AI SEO Agents for Gemini CLI
Gemini CLI runs where your code and servers are, including places with no browser. Add SEOmatic as an SEO MCP server and Gemini CLI can audit your live site and read your Search Console data from the terminal, over SSH or in a container.
- One gemini mcp add command
- Browser sign-in locally, API key on servers
- Scriptable SEO checks from the terminal
Gemini CLI
About SEOmatic for Gemini CLI
SEOmatic is a hosted MCP server that Gemini CLI adds over HTTP. It signs in with OAuth on a machine with a browser, or with a workspace API key anywhere else.
Requirements
A paid Gemini API key or a Gemini Code Assist licence, and a free SEOmatic account.
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.
SEOmatic in Gemini CLI
What SEOmatic Does in Gemini CLI
Post-Deploy SEO Check
After a release, audit the key pages on production for noindex leaks, canonical mistakes and broken internal links.
Search Console From the Shell
Top queries, top pages and period comparisons without opening a dashboard.
Index Status in Bulk
Inspect up to 50 URLs per call and list the ones Google excluded, with the reason.
Sitemap Health
Check your submitted sitemaps and their status from your Search Console data.
Fix It in the Repo
Point Gemini CLI at the issues and the code that causes them, and review the change it proposes.
Gemini CLI is the pick when SEO checks need to run on a server, not only on a laptop. With the Bearer form, the same SEOmatic tools work over SSH, in a container or on a build machine.
SEO Prompts to Try in Gemini CLI
Try these in a Gemini CLI session:
- “Audit https://example.com with SEOmatic and list anything that blocks indexing.”
- “Compare my Search Console clicks for the last 28 days with the 28 days before.”
- “Inspect these ten URLs and tell me which are not indexed and why.”
- “Are my sitemaps healthy in Search Console?”
- “Find the pages with the most impressions and the lowest CTR.”
How It Works, Step by Step
- You add SEOmatic with one command, with browser sign-in or an API key header.
- You ask Gemini CLI an SEO question.
- It calls SEOmatic for audits, Search Console data, index status or sitemap health.
- It reports back in the terminal and, if you ask, proposes code changes in your repo.
- You re-run the check after deploying to confirm the fix.
How to Connect SEOmatic to Gemini CLI
On your own machine, use the first command and sign in through the browser. On a server, over SSH or in a container, use the Bearer form.
- Add the server. Run: gemini mcp add --transport http seomatic https://app.seomatic.ai/api/mcp
- Sign in. Complete the SEOmatic sign-in in your local browser and pick your site.
- Or use an API key on a server. Create a key in SEOmatic under Settings, AI Agents, API Keys, and add the server with --header "Authorization: Bearer smk_live_..." instead.
- Ask your first question. Try “Audit my site with SEOmatic and rank the fixes by impact.”
Gemini CLI setup
gemini mcp add --transport http seomatic https://app.seomatic.ai/api/mcp # headless or container? use a key instead of the browser flow: gemini mcp add --transport http seomatic https://app.seomatic.ai/api/mcp \ --header "Authorization: Bearer smk_live_..."
The OAuth flow needs a local browser and a localhost redirect, so it will not complete over SSH or inside a container. Use the Bearer form there.
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.
A key from a free workspace covers every read and analysis tool, which is all most server-side checks need.
Nothing Changes on Your Site Without Your Approval
Gemini CLI can read and analyze freely, and any change SEOmatic would make on a live site is staged, never pushed. 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
Other terminal agents: Claude Code and Devin. Explore page indexing, XML sitemaps and the REST API. All assistants: AI assistants. Full reference: MCP docs.
Frequently Asked Questions
Can Gemini CLI do SEO?
With SEOmatic connected, yes. Gemini CLI can audit your live site, read your Search Console data, check index status and sitemaps, and propose code fixes, all from the terminal.
How do I add SEOmatic to Gemini CLI?
Run gemini mcp add --transport http seomatic https://app.seomatic.ai/api/mcp and sign in through your browser. On a server or in a container, add --header "Authorization: Bearer" followed by your SEOmatic API key instead.
Is it free?
The SEOmatic account is free with no card, with 5 questions a month from your own data plus 10 bonus questions once you connect Search Console. Gemini CLI itself needs a paid Gemini API key or a Gemini Code Assist licence.
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 of them 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 still wait for you.
Why does the sign-in fail over SSH?
The OAuth flow needs a local browser and a localhost redirect, which a remote shell or container does not have. Use a SEOmatic API key with the Bearer header form instead.
SEOmatic in other AI assistants
Same server, same tools, same approval rules. Pick the assistant that fits the job.
Cursor
Add one entry to mcp.json and Cursor's agent works from your real SEO data while it edits your code.
GitHub Copilot
Add SEOmatic to .vscode/mcp.json and Copilot's Agent mode works from your real SEO data.
Devin
Hand Devin SEO tasks backed by your real Search Console data and live audits.
Cline
One settings block and an API key give Cline your real SEO data inside VS Code.
Zed
Add SEOmatic as a context server and Zed's agent works from your real SEO data.