SEOmatic
SEO agent: GSC, keyword, backlink and AI-visibility insights, plus approval-gated site actions
Open source Repository Open in the app JSON README (API)
About
SEO agent: GSC, keyword, backlink and AI-visibility insights, plus approval-gated site actions
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- ai.seomatic
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-09-11T15:24:43Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-31 21:00:07
- Updated
- 2026-09-11 19:05:32
- Origin id
ai.seomatic/seomatic
README
# SEOmatic MCP Server
SEO agent for your own website, as a **hosted (remote) MCP server**. Connect it
and your AI agent can read your real SEO data and stage fixes that always wait
for your approval.
- **Endpoint:** `https://app.seomatic.ai/api/mcp` (Streamable HTTP)
- **Auth:** OAuth 2.1 (interactive clients) or a `Bearer` API key (headless)
- **Docs:** https://seomatic.ai/developers/mcp
There is nothing to clone, build, or run: this repository documents how to
connect to the hosted server.
## What you can ask
- Which keywords am I close to ranking on page 1 for?
- Which pages are losing traffic, and why?
- What backlinks did I gain this month? Who links to my competitors but not me?
- Does ChatGPT mention my site when people ask about my topic?
- Are my Google Ads and SEO fighting over the same keywords?
On a paid SEOmatic plan, the agent can also **stage** SEO fix tasks, content
campaigns, and article drafts. Nothing touches your site until a human
approves it in SEOmatic, and every change shows before-and-after results.
## Tools
14 consolidated tools, each annotated (read-only vs staging) and scoped to the
connected workspace: `gsc_performance`, `gsc_insights`, `gsc_indexing`,
`keyword_research`, `keyword_clusters`, `backlink_profile`, `serp_competitors`,
`traffic_analytics`, `local_presence`, `site_pages`, `dataset_library`,
`strategy_insights`, `task_manage`, `campaign_manage`. The roster you see
depends on your plan and connected data sources. Full reference:
https://seomatic.ai/developers/mcp
## Install in Cline
1. Create a SEOmatic account at https://app.seomatic.ai (free tier works) and
mint an API key: **Settings -> API Keys -> Create key**. Copy the
`smk_live_...` value.
2. Add this to your Cline MCP settings file (`cline_mcp_settings.json`):
```json
{
"mcpServers": {
"seomatic": {
"url": "https://app.seomatic.ai/api/mcp",
"type": "streamableHttp",
"headers": {
"Authorization": "Bearer smk_live_YOUR_KEY_HERE"
}
}
}
}
```
3. Ask Cline something like: "What are my striking-distance queries? Use
SEOmatic." Tools are already scoped to your connected site, so no domain
parameter is ever needed.
## Install in other clients
- **Claude (web/desktop):** Settings -> Connectors -> Add custom connector ->
URL `https://app.seomatic.ai/api/mcp` (OAuth, no key needed)
- **Claude Code:** `claude mcp add --transport http seomatic https://app.seomatic.ai/api/mcp`
- **Cursor:** add `{"mcpServers": {"seomatic": {"url": "https://app.seomatic.ai/api/mcp"}}}` to `mcp.json`
- **Grok Bot (x.ai/bot):** always-on SEO teammate with weekly routines - full
template in [grok-bot/](./grok-bot/)
## Free vs paid
The free tier includes the insight tools with a monthly question quota shared
with SEOmatic chat. Acting tools (staging tasks, campaigns, articles) need a
paid plan and always keep the human-approval gate.
## The SEO Audit skill
`skills/seomatic-seo-audit/` is an Agent Skill that turns the connector into
a guided, senior-SEO-grade audit: baseline, CTR mismatches, striking-distance
keywords, decay diagnosis with competitors, indexation, backlinks, AI
visibility, and a verdict-first report ranked by business impact. Every claim
comes from your data; acting is always approval-gated.
**Install in Claude Code:**
```bash
git clone https://github.com/Minh42/seomatic-mcp.git
mkdir -p ~/.claude/skills
cp -r seomatic-mcp/skills/seomatic-seo-audit ~/.claude/skills/
```
Then in any session with the SEOmatic connector active, just ask:
"Run a full SEO audit of my site." The skill is also on
[Smithery](https://smithery.ai/skills).
## Support
- Docs: https://seomatic.ai/developers/mcp
- Site: https://seomatic.ai