springvoiceswell / semrush-ai-tool

# 🚀 semrush-ai-tool
### AI-Powered Semrush SEO Analysis — MCP Server & CLI for Keyword Research, Backlinks & Competitor Intelligence
**Turn any AI assistant into a professional SEO analyst.** Connect Claude, Cursor, or any MCP-compatible AI client directly to live Semrush data — keyword research, domain analytics, backlink analysis, traffic insights, and competitor intelligence — with a single install.
⚡ Quick Install · 🤖 Connect Your AI · ⌨️ CLI Usage · 🧰 All 18 Tools · 👩‍💻 Developers
---
## 🎯 What is semrush-ai-tool?
**semrush-ai-tool** is a free, open-source **Semrush SEO analysis tool** that gives AI assistants real-time access to the **Semrush API** through the **Model Context Protocol (MCP)** — the open standard for connecting AI models to external data.
Instead of exporting CSVs and pasting them into a chat window, you simply ask your AI:
> *"Analyze the top organic keywords for mysite.com, compare them with competitor.com, score the keyword difficulty, and tell me which backlinks I'm missing."*
The AI calls the Semrush API for you, reads the results, and delivers a complete **SEO analysis** — keyword gaps, backlink opportunities, traffic trends, and competitor strategy — in plain English.
It ships as **two tools in one package**:
| Entry point | Who it's for | What it does |
|---|---|---|
| 🤖 **MCP Server** (`semrush-ai-mcp`) | Marketers, SEOs, founders | Gives Claude Desktop, Cursor & other AI clients **18 Semrush tools** |
| ⌨️ **CLI** (`semrush-ai`) | Developers, power users, AI coding agents | Run Semrush reports straight from the terminal |
✅ **No build step** — pure JavaScript, installs in seconds
✅ **No Homebrew required** — works with a standard Node.js setup
✅ **Self-hosted & private** — your API key never leaves your machine
✅ **MIT licensed** — free for personal and commercial use
---
## ✨ Features
- **🔍 Keyword Research** — search volume, CPC, competition, trends, related keywords, question keywords (People Also Ask gold), and batch **Keyword Difficulty** scoring for up to 100 keywords at once
- **🌐 Domain Analytics** — organic & paid keywords, traffic estimates, rank history, and visibility for any domain in any regional database (US, UK, DE, FR, and 100+ more)
- **🕵️ Competitor Analysis** — discover organic and paid competitors, reverse-engineer their keyword portfolios, and find the gaps in yours
- **🔗 Backlink Analysis** — backlink profile overviews, individual backlinks with anchors, and referring domains sorted by authority for link-building prospecting
- **📈 Traffic Analytics** — visits, unique visitors, bounce rate, and session duration via Semrush .Trends
- **📊 SERP Snapshots** — see exactly which domains and URLs rank for any keyword
- **💳 API Units Tracking** — check your Semrush API units balance before big jobs
- **⚡ Built-in rate limiting** — never trip Semrush's API limits
- **🧩 Works everywhere MCP works** — Claude Desktop, Cursor, Windsurf, Cline, and any MCP-compatible client
---
## ⚡ Installation
Choose your