# Metrics Tools

> Metrics Tools ist ein SEO-Analysetool für Deutschland (DE), Österreich (AT) und die Schweiz (CH).
> Wöchentlicher Crawl von ~1 Mio. Keywords pro Markt. Sichtbarkeitsanalyse, Wettbewerbervergleich, Keyword-Recherche.
> Tarife: Basic (24,95 €/M), Professional (49,95 €/M), Professional Plus (99,95 €/M). 14 Tage kostenlos testen — keine Kreditkarte erforderlich.

## Hilfe & Wissen

https://metrics-tools.de/wissen/: Hilfe- und Wissens-Hub mit Praxisleitfäden, FAQ-Kategorien und Neuigkeiten
https://metrics-tools.de/wissen/praxis/: Praxisleitfäden für SEO-Workflows mit Metrics Tools
https://metrics-tools.de/wissen/praxis/seo-tool-domain-analyse: Praxisleitfaden zur Ad-hoc-Domainanalyse mit Rankings, Wettbewerbern, Keyword-Gaps, PAA und AI Overviews
https://metrics-tools.de/wissen/allgemein/: Keyword-Index, Märkte, Datenaktualität, Funktionsumfang
https://metrics-tools.de/wissen/account/: Tarife, Preise, Zahlungsarten, Kündigung, Team-Zugänge, Affiliate
https://metrics-tools.de/wissen/rankings/: Sichtbarkeitskennzahl, Ranking-Positionen, Live Rankings, Index-Aufbau
https://metrics-tools.de/wissen/keywords/: Individuelle Keywords, Suchvolumina, Standort-Tracking, Exporte
https://metrics-tools.de/wissen/search-console/: Google Search Console — Integration, Datenarchiv, Property-Verwaltung
https://metrics-tools.de/changelog/: Vollständige Changelog-Timeline; Detailartikel sind unter /wissen/{slug} kanonisch
https://metrics-tools.de/wissen.json: Alle FAQ- und Changelog-Inhalte als strukturiertes JSON (täglich aktualisiert, maschinenlesbar)

## Onboarding-Flow (Schritt für Schritt)

### Schritt 1: Registrierung

POST https://metrics-tools.de/metricstools/register

Felder (application/x-www-form-urlencoded):
- email — Mailadresse des Nutzers
- password — Passwort
- metrics_tarif — Gewünschter Tarif: `basic`, `professional` oder `professional_plus`

Antwort (JSON): `{"result":"OK"}` bei Erfolg, `{"result":"ERROR"}` wenn Adresse bereits vergeben.

Hinweis: Nach der Registrierung wird eine Aktivierungsmail versandt. Der Nutzer muss den Link in der Mail klicken — dieser Schritt erfordert menschliche Interaktion und kann nicht automatisiert werden.

### Schritt 2: Login

POST https://metrics-tools.de/metricstools/validate

Felder:
- email
- password

Antwort (JSON): `{"result":"OK"}` oder `{"result":"FAILURE"}`. Bei OK ist die Session aktiv (Cookie-basiert).

### Schritt 3: Rechnungsdaten hinterlegen (Voraussetzung für Buchung)

Nach dem Login unter:
https://metrics-tools.de/metricstools/account/bills

Dort trägt der Nutzer Vorname, Nachname, Firma, Adresse und optional Bankverbindung (SEPA) ein. Ohne vollständige Rechnungsdaten kann keine Buchung abgeschlossen werden.

### Schritt 4: Tarif buchen

Tarifauswahl unter:
https://metrics-tools.de/metricstools/account/tarife

Buchung per POST:
POST https://metrics-tools.de/metricstools/subscribe

Feld:
- metrics_tarif — `basic`, `professional` oder `professional_plus`

Nach erfolgreicher Buchung wird der Account sofort freigeschaltet.

## API-Key abrufen (Voraussetzung für MCP)

Nach dem Login unter:
https://metrics-tools.de/metricstools/documentation/api

Der API-Key ist dort vorausgefüllt angezeigt. Er wird für die externe Metrics-Tools-API und den MCP-Server benötigt.

Hinweis: Der API-Key ist ab der Testphase verfügbar — eine bezahlte Buchung ist nicht erforderlich.

## MCP-Server

Metrics Tools bietet einen MCP-Server (Model Context Protocol), der SEO-Daten direkt in KI-Assistenten verfügbar macht.

Endpoint: `https://metrics-tools.de/mcp/{apikey}`
Protokoll: MCP Streamable HTTP (JSON-RPC 2.0)
Verfügbar: ab Testphase (kein bezahltes Abo erforderlich)

### Einrichtung in Claude Web / Mobile (empfohlen, kein Node.js nötig)

claude.ai → Settings → Connectors → Add custom connector → URL: `https://metrics-tools.de/mcp/{apikey}`

Erfordert Claude Pro, Max, Team oder Enterprise.

### Einrichtung in Claude Desktop (lokal)

Download der server.js von der API-Doku-Seite, dann Node.js + npm install + Claude Desktop Config mit `--stdio` Flag.

### Verfügbare Tools (12)

- `mt_get_credits` — Aktuelles Credit-Guthaben abfragen (0 Credits)
- `mt_domain_sk` — Sichtbarkeitswert (SK) einer Domain (historisch, aktuell, min/max)
- `mt_domain_rankings` — Alle Rankings einer Domain
- `mt_domain_rankingposition` — Position einer Domain für ein bestimmtes Keyword
- `mt_domain_position` — Position eines Keywords (Legacy-Endpoint)
- `mt_domain_n_rankings` — Anzahl Rankings einer Domain über die Zeit
- `mt_keyword_details` — Suchvolumen, CPC und Competition eines Keywords
- `mt_keyword_related` — Verwandte Keywords mit Relevanz-Score (bis 500)
- `mt_keyword_serp` — SERP-Snapshot eines Keywords aus dem Index
- `mt_url_rankings` — Rankings einer URL
- `mt_url_sk` — Sichtbarkeitswert einer URL, Subdomain oder eines Verzeichnisses
- `mt_url_rankingposition` — Position einer URL für ein bestimmtes Keyword

Alle Tools unterstützen den Parameter `country` (de/at/ch/ca).