ComposioHQ/Ahrefs-Automation

Ahrefs Automation

Führen Sie Ahrefs SEO-Analysen direkt aus Claude Code durch. Analysieren Sie Backlink-Profile, recherchieren Sie Keywords, verfolgen Sie die Domain-Autorität im Zeitverlauf, prüfen Sie organische Keyword-Rankings und analysieren Sie mehrere URLs im Batch – ohne Ihr Terminal zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/ahrefs

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Ahrefs-Konto, wenn Sie dazu aufgefordert werden. Der Agent stellt einen Authentifizierungslink bereit.
3. Die meisten Tools benötigen ein target (Domain oder URL) und einen country-Code (ISO 3166-1 alpha-2). Einige erfordern auch ein date im Format YYYY-MM-DD.

---

Kern-Workflows

1. Site Explorer Metriken

Rufen Sie umfassende SEO-Metriken für eine Domain ab, darunter Backlink-Anzahl, verweisende Domains, organische Keyword-Rankings und Traffic-Schätzungen.

Tool: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS

Wichtige Parameter:

• target (erforderlich) – zu analysierende Domain oder URL
• date (erforderlich) – Metrik-Datum im Format YYYY-MM-DD
• country – ISO-Ländercode (z. B. us, gb, de)
• mode – Umfang: exact, prefix, domain oder subdomains (Standard)
• protocol – both, http oder https
• volume_mode – monthly oder average

Beispiel-Prompt: "Hol Ahrefs Site-Metriken für example.com ab heute in den USA"

---

2. Historische Metrikverfolgung

Verfolgen Sie, wie sich die SEO-Metriken einer Domain im Zeitverlauf verändert haben, für Trendanalysen und Wettbewerbs-Benchmarking.

Tools: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY, AHREFS_DOMAIN_RATING_HISTORY

Für den vollständigen Metrikverlauf:

• target (erforderlich) – zu verfolgende Domain
• date_from (erforderlich) – Startdatum im Format YYYY-MM-DD
• date_to – Enddatum
• history_grouping – daily, weekly oder monthly (Standard)
• select – Spalten wie date,org_cost,org_traffic,paid_cost,paid_traffic

Für den Domain-Rating-Verlauf (DR):

• target (erforderlich), date_from (erforderlich), date_to, history_grouping

Beispiel-Prompt: "Zeig mir den monatlichen Domain-Rating-Verlauf für example.com im letzten Jahr"

---

3. Backlink-Analyse

Rufen Sie eine umfassende Liste von Backlinks ab, einschließlich Quell-URLs, Ankertext, Linkattributen und Metriken der verweisenden Domains.

Tool: AHREFS_FETCH_ALL_BACKLINKS

Wichtige Parameter:

• target (erforderlich) – Domain oder URL
• select (erforderlich) – kommagetrennte Spalten (z. B. url_from,url_to,anchor,domain_rating_source,first_seen_link)
• limit (Standard 1000) – Anzahl der Ergebnisse
• aggregation – similar_links (Standard), 1_per_domain oder all
• mode – exact, prefix, domain oder subdomains
• history – live, since:YYYY-MM-DD oder all_time
• where – umfangreiche Filterausdrücke für Spalten wie is_dofollow, domain_rating_source, anchor

Beispiel-Prompt: "Hol die Top 100 Dofollow-Backlinks zu example.com mit Ankertext und verweisender DR"

---

4. Keyword-Recherche

Erhalten Sie Keyword-Übersichtsmetriken und entdecken Sie passende Keyword-Variationen für Ihre Content-Strategie.

Tools: AHREFS_EXPLORE_KEYWORDS_OVERVIEW, AHREFS_EXPLORE_MATCHING_TERMS_FOR_KEYWORDS

Für die Keyword-Übersicht:

• select (erforderlich) – zurückzugebende Spalten (Volume, Schwierigkeit, CPC usw.)
• country (erforderlich) – ISO-Ländercode
• keywords – kommagetrennte Keyword-Liste
• where – Filtern nach Volume, Schwierigkeit, Absicht usw.

Für passende Begriffe:

• select (erforderlich) und country (erforderlich)
• keywords – kommagetrennte Seed-Keywords
• match_mode – terms (beliebige Reihenfolge) oder phrase (exakte Reihenfolge)
• terms – all oder questions (nur Frage-Keywords)

Beispiel-Prompt: "Finde Keyword-Variationen für 'Projektmanagement' in den USA mit Volume und Schwierigkeit"

---

5. Organisches Keyword-Audit

Sehen Sie, für welche Keywords eine Domain in der organischen Suche rankt, mit Positionsverfolgung und historischem Vergleich.

Tool: AHREFS_RETRIEVE_ORGANIC_KEYWORDS

Wichtige Parameter:

• target (erforderlich) – Domain oder URL
• country (erforderlich) – ISO-Ländercode
• date (erforderlich) – Datum im Format YYYY-MM-DD
• select – zurückzugebende Spalten (Keyword, Position, Volume, Traffic, URL usw.)
• date_compared – Vergleich mit einem früheren Datum
• where – umfangreiche Filterausdrücke für keyword, volume, best_position, Absichtsflags usw.
• limit (Standard 1000), order_by

Beispiel-Prompt: "Zeig alle organischen Keywords, für die example.com in den USA in den Top 10 rankt"

---

6. Batch-URL-Analyse

Analysieren Sie bis zu 100 URLs oder Domains gleichzeitig, um SEO-Metriken über Wettbewerber oder Website-Bereiche hinweg zu vergleichen.

Tool: AHREFS_BATCH_URL_ANALYSIS

Wichtige Parameter:

• targets (erforderlich) – Array von Objekten mit url, mode (exact/prefix/domain/subdomains) und protocol (both/http/https)
• select (erforderlich) – Array von Spaltenbezeichnern
• country – ISO-Ländercode
• output – json oder php

Beispiel-Prompt: "Vergleiche SEO-Metriken für competitor1.com, competitor2.com und competitor3.com"

---

Bekannte Fallstricke

• Spaltenauswahl ist erforderlich: Die meisten Ahrefs-Tools benötigen einen select-Parameter, der angibt, welche Spalten zurückgegeben werden sollen. Das Weglassen oder die Verwendung ungültiger Spaltennamen führt zu Fehlern. Schlagen Sie im jeweiligen Tool-Schema nach gültigen Bezeichnern.
• Datumsformat-Konsistenz: Daten müssen im Format YYYY-MM-DD angegeben werden. Einige historische Endpunkte geben Daten in der durch history_grouping festgelegten Granularität zurück, nicht nach exaktem Datum.
• API-Unit-Kosten variieren: Verschiedene Spalten verbrauchen unterschiedliche Unit-Mengen. Im Schema als "(5 units)" oder "(10 units)" markierte Spalten sind teurer. Überwachen Sie die API-Nutzung bei teuren Spalten wie traffic, refdomains_source oder difficulty.
• Batch-Limit beträgt 100 Ziele: AHREFS_BATCH_URL_ANALYSIS akzeptiert bis zu 100 Ziele pro Anfrage. Für größere Analysen teilen Sie die Anfragen in mehrere Batches auf.
• Filterausdrücke sind komplex: Der where-Parameter verwendet die Ahrefs-eigene Filterausdruckssyntax, nicht Standard-SQL. Konsultieren Sie die Spaltenbeschreibungen im jeweiligen Tool-Schema für unterstützte Filtertypen und Wertformate.
• Veralteter Offset-Parameter: Der offset-Parameter wurde am 31. Mai 2024 als veraltet erklärt. Verwenden Sie stattdessen cursor-basierte Paginierung oder passen Sie limit an.
• Mode beeinflusst den Umfang erheblich: Die Einstellung von mode auf subdomains (Standard) schließt alle Subdomains ein, was die Ergebnisanzahl im Vergleich zu domain oder exact drastisch erhöhen kann.

---

Kurzreferenz

Tool-Slug	Beschreibung
AHREFS_RETRIEVE_SITE_EXPLORER_METRICS	Aktuelle SEO-Metriken für eine Domain/URL
AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY	Historische SEO-Metriken im Zeitverlauf
AHREFS_DOMAIN_RATING_HISTORY	Domain-Rating-Verlauf (DR)
AHREFS_FETCH_ALL_BACKLINKS	Umfassende Backlink-Liste mit Filterung
AHREFS_FETCH_SITE_EXPLORER_REFERRING_DOMAINS	Liste der verweisenden Domains
AHREFS_GET_SITE_EXPLORER_COUNTRY_METRICS	Länderspezifische Traffic-Aufschlüsselung
AHREFS_BATCH_URL_ANALYSIS	Batch-Analyse von bis zu 100 URLs
AHREFS_EXPLORE_KEYWORDS_OVERVIEW	Keyword-Metriken-Übersicht
AHREFS_EXPLORE_MATCHING_TERMS_FOR_KEYWORDS	Passende Keyword-Variationen
AHREFS_EXPLORE_KEYWORD_VOLUME_BY_COUNTRY	Keyword-Volume nach Land
AHREFS_RETRIEVE_ORGANIC_KEYWORDS	Organische Keyword-Rankings einer Domain
AHREFS_RETRIEVE_SITE_EXPLORER_KEYWORDS_HISTORY	Historische Keyword-Ranking-Daten
AHREFS_RETRIEVE_TOP_PAGES_FROM_SITE_EXPLORER	Bestplatzierte Seiten nach SEO-Metriken
AHREFS_GET_SERP_OVERVIEW	SERP-Übersicht für bestimmte Keywords

---

Bereitgestellt von Composio