seo MCP server
Commit 2. Nov. 2026Führt SEO-Audits, Website-Crawling und Echtzeit-Web-Monitoring via Firehose durch, um technische, inhaltliche und Performance-Probleme zu identifizieren.
Auch bekannt als Stackwise-digital/seo-mcp
- Stars
- 3
- Tools
- 18
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 2. Nov. 2026
- Lizenz
- MIT
Was ist seo MCP?
Führt SEO-Audits, Website-Crawling und Echtzeit-Web-Monitoring via Firehose durch, um technische, inhaltliche und Performance-Probleme zu identifizieren. Er stellt 18 Tools bereit, etwa scan_url, scan_site, get_site_overview.
Zusammenfassung generiert aus dem README des Projekts
Über seo MCP server
seo-mcp ermöglicht es dir, Websites direkt über dein KI-Chat-Interface auf technische und inhaltliche Probleme zu prüfen. Dieser Open-Source Server läuft lokal und verbindet sich mit Clients wie Claude Desktop, Claude Code und Cursor. Er erlaubt es Entwicklern und SEO-Spezialisten, tiefgehende Scans einzelner URLs oder ganzer Domains durchzuführen. Dabei wird Multi-Threaded-Scanning genutzt, um 28 spezifische Regeln zu prüfen, die Meta-Tags, Content-Hierarchie, technische Konfigurationen und Performance-Metriken abdecken.
Nutzer können Site-Crawls mit konfigurierbarer Tiefe und Seitenlimits durchführen, wobei robots.txt-Dateien respektiert werden. Für alle, die Änderungen über die Zeit tracken müssen, integriert sich der Server mit Firehose, um Echtzeit-Web-Monitoring zu bieten. Diese optionale Funktion erfordert einen Firehose Management Key und ermöglicht das Monitoring von Inhaltsänderungen via Lucene-Queries und SSE-Streaming. Die Kern-Scanning-Tools funktionieren ohne jegliche API-Keys, da das verbundene LLM die Analyse auf Basis der vom Server zurückgegebenen strukturierten Daten durchführt.
Was du damit machen kannst
- 1Single-Page-Audit durchführenBitte die KI, eine spezifische URL zu scannen, um SEO-Probleme und Fehler in den Metadaten zu finden.
- 2Eine komplette Website crawlenAnweisung an den Client, eine ganze Domain mit einem spezifischen Seitenlimit zu crawlen, um Duplicate Content oder kaputte Links zu finden.
- 3Inhaltsänderungen der Konkurrenz überwachenRichte einen Echtzeit-Monitor ein, um zu tracken, wann ein Wettbewerber neue Inhalte auf seiner Seite veröffentlicht.
- 4Content-Qualität tiefgehend analysierenFordere eine detaillierte Aufschlüsselung der Keywords und der technischen Struktur einer Seite an.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
seo MCP tools 18
Erkannt aus dem READMEscan_urlscan_siteget_site_overviewanalyze_pagefirehose_monitorfirehose_manage_tapsfirehose_manage_rulesfirehose_streamaddedremovedtitleurl
| scan_url | — | |
| scan_site | — | |
| get_site_overview | — | |
| analyze_page | — | |
| firehose_monitor | — | |
| firehose_manage_taps | — | |
| firehose_manage_rules | — | |
| firehose_stream | — | |
| added | — | |
| removed | — | |
| title | — | |
| url | — |
Alle 18 Tools anzeigenWeniger Tools anzeigen
domainpage_categorypage_typelanguagepublish_timerecent
| domain | — | |
| page_category | — | |
| page_type | — | |
| language | — | |
| publish_time | — | |
| recent | — |
Konfiguration
FIREHOSE_MANAGEMENT_KEY
| Name | Beschreibung | Typ |
|---|---|---|
| FIREHOSE_MANAGEMENT_KEY | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarstackwise-digital/seo-mcp is public and reachablegithub.com/stackwise-digital/seo-mcp ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-02github.com/stackwise-digital/seo-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell18 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenseo-mcp
Free, open-source MCP server for scanning websites for SEO issues — runs locally and integrates directly with Claude Desktop, Claude Code, Cursor, and other MCP clients.
No API keys required for core functionality. The conversation LLM performs AI analysis directly.
Website: seo-mcp.dev · Built by larch, a product studio that ships MVPs, mobile apps and AI tools.
Features
- 28 SEO rules across meta, content, technical, and performance categories
- Multi-threaded scanning with
worker_threadsfor parallel page analysis - Site crawling with configurable depth, page limits, and robots.txt respect
- Deep page analysis — returns structured data for the conversation LLM to analyze (no API key needed)
- Real-time web monitoring via Firehose (Ahrefs) — track content changes with Lucene queries and SSE streaming
- Structured results with severity levels and actionable recommendations
Getting Started
Prerequisites
- Node.js >= 20.0.0
- An MCP client: Claude Desktop, Claude Code, Cursor, or any MCP-compatible client
Installation
git clone https://github.com/Stackwise-digital/seo-mcp.git
cd seo-mcp
npm install
npm run build
Setup
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"seo-mcp": {
"command": "node",
"args": ["/path/to/seo-mcp/dist/index.js"]
}
}
}
Claude Code
Add to your Claude Code MCP settings (~/.claude/.mcp.json):
{
"mcpServers": {
"seo-mcp": {
"command": "node",
"args": ["/path/to/seo-mcp/dist/index.js"]
}
}
}
Cursor
Add to your Cursor MCP settings:
{
"mcpServers": {
"seo-mcp": {
"command": "node",
"args": ["/path/to/seo-mcp/dist/index.js"]
}
}
}
That's it — the 4 core SEO tools are ready to use. No API keys needed.
Enable Real-Time Monitoring (optional)
To use the Firehose real-time web monitoring tools:
- Sign up at firehose.com (free during beta, no credit card)
- Create a management key (starts with
fhm_) - Add it to your MCP config:
{
"mcpServers": {
"seo-mcp": {
"command": "node",
"args": ["/path/to/seo-mcp/dist/index.js"],
"env": {
"FIREHOSE_MANAGEMENT_KEY": "fhm_your_key_here"
}
}
}
}
Tools
SEO Scanning
| Tool | Description |
|---|---|
scan_url |
Scan a single URL for SEO issues. Returns score, issues by severity, metadata, links, and images. |
scan_site |
Crawl and scan an entire website. Includes duplicate content detection, robots.txt and sitemap analysis. |
get_site_overview |
Summary of a previously scanned domain — overall score, top issues, worst pages. |
analyze_page |
Deep analysis returning structured data + HTML for the LLM to provide keyword, content quality, and technical insights. |
Real-Time Monitoring (Firehose)
Powered by Ahrefs' crawler (8B+ pages/day). Requires FIREHOSE_MANAGEMENT_KEY.
| Tool | Description |
|---|---|
firehose_monitor |
Quick setup — create a tap and monitoring rule in one step. Ideal after an SEO audit. |
firehose_manage_taps |
Create, list, or delete monitoring taps. |
firehose_manage_rules |
CRUD rules using Lucene query syntax (e.g., domain:example.com AND added:"pricing"). |
firehose_stream |
Consume real-time change events. Supports replay via 24h buffer. |
| Field | Type | Description |
|---|---|---|
added |
text | Newly inserted content (default search field) |
removed |
text | Deleted content |
title |
text | Page title |
url |
keyword | Full URL (exact match) |
domain |
keyword | Domain (e.g., example.com) |
page_category |
keyword | ML category (e.g., /News, /Finance) |
page_type |
keyword | ML type (e.g., /Article/How_to) |
language |
keyword | ISO 639-1 code (e.g., en) |
publish_time |
keyword | ISO-8601 datetime |
recent |
filter | Recency filter (e.g., 24h, 7d) |
Supports: AND, OR, NOT, phrases ("..."), wildcards (*, ?), ranges ([... TO ...]). Max 25 rules per org.
Example Workflows
Audit a single page:
"Scan https://example.com for SEO issues"
Crawl an entire site:
"Scan site example.com with max 100 pages"
Deep analysis:
"Analyze https://example.com focusing on keywords and content quality"
Monitor a competitor after audit:
"Set up a Firehose monitor for competitor.com" "Stream the latest events from that monitor"
Track specific content changes:
"Create a Firehose monitor with query: domain:example.com AND added:"pricing" AND language:"en""
SEO Rules (28 total)
| Category | Rules |
|---|---|
| Meta (10) | Title exists, title length, description exists, description length, canonical URL, Open Graph tags, Twitter card, viewport, hreflang, favicon |
| Content (7) | H1 exists, H1 count, heading hierarchy, image alt text, word count, internal links, broken links |
| Technical (7) | HTTPS, status code, robots meta/noindex, structured data, redirect chains, lang attribute, DOCTYPE |
| Performance (4) | Page size, response time, compression, cache headers |
Configuration
All configuration is via environment variables. Defaults work out of the box.
| Variable | Default | Description |
|---|---|---|
WORKER_POOL_SIZE |
4 |
Number of worker threads |
DEFAULT_MAX_PAGES |
50 |
Default max pages for site crawl |
DEFAULT_MAX_DEPTH |
3 |
Default max crawl depth |
REQUEST_TIMEOUT_MS |
15000 |
HTTP request timeout |
REQUESTS_PER_SECOND |
5 |
Rate limit for outbound requests |
FIREHOSE_MANAGEMENT_KEY |
— | Firehose management key (optional, for firehose_* tools) |
See .env.example for a template.
Development
npm install # Install dependencies
npm run dev # Run in dev mode (no build needed)
npm run build # Build
npm run typecheck # Type check
npm test # Run tests
Architecture
src/
├── index.ts # MCP server entry point
├── config/ # Environment-based configuration
├── types/ # TypeScript type definitions
├── tools/ # MCP tool registrations (8 tools)
├── scanner/ # Core scanner engine, fetcher, parser, crawler
├── rules/ # 28 SEO rules across 4 categories
├── workers/ # worker_threads pool for parallel scanning
├── firehose/ # Firehose real-time monitoring client
├── store/ # In-memory result storage
└── utils/ # Rate limiter, URL utils, logger
Companion Tools
Bridddge — Desktop LinkedIn automation built by the same team. If you use seo-mcp to audit your content and want to amplify it on LinkedIn, Bridddge handles outreach, connection requests, and follow-ups with AI-driven personalization. Privacy-first, runs locally.
License
MIT · Built by larch
seo MCP Fragen
Welche Tools bietet seo MCP?
Er stellt 18 Tools bereit, darunter scan_url, scan_site, get_site_overview, analyze_page, firehose_monitor.
Benötige ich einen API-Key, um die SEO-Scanning-Funktionen zu nutzen?
Nein, für die Kernfunktionen des SEO-Scannings und Crawlings sind keine API-Keys erforderlich.
Welche Arten von SEO-Regeln prüft der Server?
Der Server prüft 28 Regeln in den Kategorien Meta, Content, Technik und Performance.
Welche MCP-Clients werden unterstützt?
Es funktioniert mit Claude Desktop, Claude Code, Cursor und jedem anderen MCP-kompatiblen Client.