Skip to main content
Glama
yagomp

seoagent

by yagomp

SEOAgent

Latest Release GitHub Stars npm downloads Node.js License: MIT

Open-Source, Agent-first SEO-Toolkit — Keyword-Recherche, Ranking-Tracking, Site-Audits, Wettbewerbsanalyse, Content-Gap-Analyse, Domain-Reputation und KI-gestützte Strategieerstellung. Zuerst für KI-Agenten entwickelt, dann für Menschen.

Inhaltsverzeichnis

Related MCP server: seo-stack-mcp

Funktionen

  • Keyword-Recherche — Suchvolumina, Schwierigkeitsgrade, Keyword-Vorschläge via DataForSEO

  • Ranking-Tracking — Verfolgen Sie Keyword-Positionen im Zeitverlauf, Movers-Berichte

  • Site-Audit — Crawlen Sie bis zu 50.000 Seiten, erkennen Sie SEO-Probleme (defekte Links, fehlende Meta-Tags, Thin Content, doppelte Titel, verwaiste Seiten)

  • Wettbewerbsanalyse — Keyword-Überschneidungen, Identifizierung von Content-Lücken

  • Domain-Reputation — DR-Score, Backlink-Profil, verweisende Domains, Link-Möglichkeiten

  • Google Search Console — Klicks, Impressionen, CTR, Top-Seiten und Suchanfragen

  • Strategie-Engine — KI-gestützte (Claude/GPT/Ollama) oder regelbasierte SEO-Strategieerstellung

Schnittstellen

Schnittstelle

Beschreibung

CLI

npm install -g @seoagent/cli — vollständiges Befehlszeilen-Toolkit

MCP-Server

npx seoagent-mcp — 24 Tools für KI-Agenten (Claude, Cursor, etc.)

Dashboard

seoagent dashboard — lokales Web-UI unter http://localhost:3847

Bibliothek

@seoagent/core — importieren Sie Funktionen direkt in Ihren Code

Fragen Sie Ihren Agenten

Sobald SEOAgent über MCP verbunden ist, sprechen Sie einfach natürlich mit Ihrem KI-Agenten. Hier sind Prompts, die gut funktionieren:

Site-Audit

Do a full audit of mysite.com and tell me what SEO issues to fix first.
Crawl mysite.com and find all broken links, missing meta descriptions, and pages with thin content.
Which pages on my site have duplicate title tags?
Are there any redirect chains or orphan pages on mysite.com?

Keyword-Recherche & Ranking-Tracking

Research keywords for "fantasy football app" and show me volume and difficulty.
What keyword suggestions do you have for my niche around project management tools?
Start tracking these keywords for my project: "best fpl app", "fpl tips", "fantasy premier league"
Check current rankings for all tracked keywords and show me what moved this week.
Which keywords did I gain or lose positions on since last check?

Wettbewerbsanalyse

Compare my site against competitor.com — where do they rank that I don't?
What are the content gaps between my site and competitor.com?
Show me which keywords competitor.com ranks for that I'm missing.
What's the domain reputation score for mysite.com?
Show me the backlink profile for mysite.com — referring domains, top links.
Find link building opportunities for my site based on competitor backlinks.
Has my domain reputation changed over the last 30 days?

Google Search Console

What are my top 10 pages by clicks in Search Console this month?
Which queries get the most impressions but have low CTR? Those are quick wins.
Show me GSC performance for the last 3 months — clicks, impressions, average position.

Strategie

Generate an SEO strategy for mysite.com based on current audit results and keyword data.
My site is in the fantasy football niche. What should I focus on for the next 90 days?
Refresh my SEO strategy — we've fixed the audit issues and added new content since last time.
Give me a prioritized action plan: what will move the needle fastest?

Kombiniert / Deep Dives

Do a complete SEO health check on mysite.com: crawl it, check rankings, pull GSC data, and give me a strategy.
I just launched mysite.com. Walk me through setting up SEOAgent and getting my first audit and keyword plan.
My organic traffic dropped 20% last month. Help me diagnose why using audit data and rank history.

Schnellstart

CLI

Einzeilige Installation (installiert Node.js automatisch, falls es fehlt):

curl -fsSL https://raw.githubusercontent.com/yagomp/seoagent/main/scripts/install.sh | sh

Oder, falls Sie bereits Node.js >= 20 haben:

npm install -g @seoagent/cli

# Setup
seoagent project add mysite --domain example.com --niche "tech"
seoagent config set dataforseo.login YOUR_LOGIN
seoagent config set dataforseo.password YOUR_PASSWORD

# Use
seoagent keywords research "seo tips" "content marketing"
seoagent audit crawl --max-pages 500
seoagent audit report
seoagent competitor keywords competitor.com
seoagent content-gaps
seoagent domain reputation
seoagent strategy generate

# Output formats
seoagent keywords research "seo" --format json
seoagent audit report --format markdown

MCP-Server (für KI-Agenten)

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration oder Ihren Claude Code-Einstellungen hinzu:

{
  "mcpServers": {
    "seoagent": {
      "command": "npx",
      "args": ["seoagent-mcp"],
      "env": {
        "SEOAGENT_PROJECT": "mysite"
      }
    }
  }
}

24 Tools verfügbar: seoagent_keyword_research, seoagent_audit_crawl, seoagent_content_gaps, seoagent_strategy_generate und mehr.

Dashboard

seoagent dashboard
# Opens http://localhost:3847

7 Ansichten: Übersicht, Keywords, Ranking-Tracker, Audit, Wettbewerber, Backlinks, Strategie.

Datenquellen

Stufe

Quelle

Kosten

Kostenlos

Google Search Console, PageSpeed Insights, lokaler Crawler

0 $

Kostenpflichtig

DataForSEO (Standard, austauschbar)

~0,001 $/Abfrage

Abgeleitet

Content-Lücken, Ranking-Deltas, Audit-Scores, Strategie

0 $

Konfiguration

# DataForSEO (keyword/SERP/backlink data)
seoagent config set dataforseo.login YOUR_LOGIN
seoagent config set dataforseo.password YOUR_PASSWORD

# LLM for strategy generation (optional)
seoagent config set llm.provider anthropic  # or openai, ollama
seoagent config set llm.apiKey sk-ant-...
seoagent config set llm.model claude-sonnet-4-6

# Google Search Console (optional)
seoagent gsc auth --client-id YOUR_ID --client-secret YOUR_SECRET

Die Konfiguration wird unter ~/.seoagent/config.json gespeichert. Projektspezifische Daten unter ~/.seoagent/projects/<slug>/.

Aktualisierung

CLI

npm install -g @seoagent/cli@latest

MCP-Server

npx ruft automatisch die neueste Version ab. Um eine zwischengespeicherte Version zu aktualisieren:

npx --yes seoagent-mcp@latest

Oder löschen Sie den npx-Cache vollständig:

npx clear-npx-cache

Bibliothek (@seoagent/core)

npm install @seoagent/core@latest

Überprüfen Sie nach der Aktualisierung der CLI die installierte Version:

seoagent --version

Entwicklung

git clone https://github.com/yagomp/seoagent.git
cd seoagent
pnpm install
pnpm build
pnpm test  # 260 tests

Architektur

packages/
  core/       @seoagent/core — all business logic (231 tests)
  cli/        seoagent CLI (16 tests)
  mcp/        seoagent-mcp server (13 tests)
  dashboard/  Local Vite + React web UI

Grundprinzip: Jede Funktion ist zuerst eine Funktion in core. CLI, MCP und Dashboard sind schlanke Wrapper.

Lizenz

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    AI search intelligence + Ahrefs-class SEO suite as 59 MCP tools. Track your brand across ChatGPT, Google AI Overview, Gemini, Claude, and Perplexity with persona-anchored Brand Radar dispatches.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    The complete open-source SEO data stack for AI agents, integrating Google Search Console, Google Analytics 4, Bing Webmaster Tools, and Microsoft Clarity with built-in analyst tools like cannibalization check, low-hanging fruit, and content gap analysis, all self-hosted and free.
    31 PyPI
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to access self-hosted SEO data and workflows, including keyword research, rank tracking, competitor insights, backlinks, site audits, and AI visibility.
    MIT