ComposioHQ/Ahrefs-Automation

Automação Ahrefs

Execute análises de SEO do Ahrefs diretamente do Claude Code. Analise perfis de backlinks, pesquise palavras-chave, acompanhe a autoridade do domínio ao longo do tempo, audite rankings orgânicos de palavras-chave e analise em lote várias URLs sem sair do terminal.

Documentação do toolkit: composio.dev/toolkits/ahrefs

---

Configuração

1. Adicione o servidor MCP da Composio à sua configuração:

   https://rube.app/mcp
   

2. Conecte sua conta Ahrefs quando solicitado. O agente fornecerá um link de autenticação.
3. A maioria das ferramentas requer um target (domínio ou URL) e um código de country (ISO 3166-1 alpha-2). Algumas também requerem uma date no formato YYYY-MM-DD.

---

Fluxos de Trabalho Principais

1. Métricas do Site Explorer

Obtenha métricas abrangentes de SEO para um domínio, incluindo contagem de backlinks, domínios de referência, rankings orgânicos de palavras-chave e estimativas de tráfego.

Ferramenta: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS

Parâmetros principais:

• target (obrigatório) — domínio ou URL a ser analisado
• date (obrigatório) — data das métricas no formato YYYY-MM-DD
• country — código ISO do país (ex.: us, gb, de)
• mode — escopo: exact, prefix, domain ou subdomains (padrão)
• protocol — both, http ou https
• volume_mode — monthly ou average

Exemplo de prompt: "Obtenha as métricas do site Ahrefs para example.com a partir de hoje nos EUA"

---

2. Acompanhamento de Métricas Históricas

Acompanhe como as métricas de SEO de um domínio mudaram ao longo do tempo para análise de tendências e benchmarking competitivo.

Ferramentas: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY, AHREFS_DOMAIN_RATING_HISTORY

Para histórico completo de métricas:

• target (obrigatório) — domínio a ser rastreado
• date_from (obrigatório) — data de início no formato YYYY-MM-DD
• date_to — data de término
• history_grouping — daily, weekly ou monthly (padrão)
• select — colunas como date,org_cost,org_traffic,paid_cost,paid_traffic

Para histórico de Domain Rating (DR):

• target (obrigatório), date_from (obrigatório), date_to, history_grouping

Exemplo de prompt: "Mostre-me o histórico mensal de Domain Rating para example.com no último ano"

---

3. Análise de Backlinks

Obtenha uma lista abrangente de backlinks, incluindo URLs de origem, texto âncora, atributos do link e métricas do domínio de referência.

Ferramenta: AHREFS_FETCH_ALL_BACKLINKS

Parâmetros principais:

• target (obrigatório) — domínio ou URL
• select (obrigatório) — colunas separadas por vírgula (ex.: url_from,url_to,anchor,domain_rating_source,first_seen_link)
• limit (padrão 1000) — número de resultados
• aggregation — similar_links (padrão), 1_per_domain ou all
• mode — exact, prefix, domain ou subdomains
• history — live, since:YYYY-MM-DD ou all_time
• where — expressões de filtro avançadas em colunas como is_dofollow, domain_rating_source, anchor

Exemplo de prompt: "Obtenha os 100 principais backlinks dofollow para example.com com texto âncora e DR de referência"

---

4. Pesquisa de Palavras-Chave

Obtenha métricas gerais de palavras-chave e descubra variações correspondentes para estratégia de conteúdo.

Ferramentas: AHREFS_EXPLORE_KEYWORDS_OVERVIEW, AHREFS_EXPLORE_MATCHING_TERMS_FOR_KEYWORDS

Para visão geral de palavras-chave:

• select (obrigatório) — colunas a retornar (volume, dificuldade, CPC etc.)
• country (obrigatório) — código ISO do país
• keywords — lista de palavras-chave separadas por vírgula
• where — filtrar por volume, dificuldade, intenção etc.

Para termos correspondentes:

• select (obrigatório) e country (obrigatório)
• keywords — palavras-chave semente separadas por vírgula
• match_mode — terms (qualquer ordem) ou phrase (ordem exata)
• terms — all ou questions (apenas palavras-chave em formato de pergunta)

Exemplo de prompt: "Encontre variações de palavras-chave para 'gestão de projetos' nos EUA com volume e dificuldade"

---

5. Auditoria de Palavras-Chave Orgânicas

Veja para quais palavras-chave um domínio ranqueia na busca orgânica, com acompanhamento de posição e comparação histórica.

Ferramenta: AHREFS_RETRIEVE_ORGANIC_KEYWORDS

Parâmetros principais:

• target (obrigatório) — domínio ou URL
• country (obrigatório) — código ISO do país
• date (obrigatório) — data no formato YYYY-MM-DD
• select — colunas a retornar (palavra-chave, posição, volume, tráfego, URL etc.)
• date_compared — comparar com uma data anterior
• where — expressões de filtro avançadas em keyword, volume, best_position, flags de intenção etc.
• limit (padrão 1000), order_by

Exemplo de prompt: "Mostre todas as palavras-chave orgânicas onde example.com está entre os 10 primeiros nos EUA"

---

6. Análise em Lote de URLs

Analise até 100 URLs ou domínios simultaneamente para comparar métricas de SEO entre concorrentes ou seções do site.

Ferramenta: AHREFS_BATCH_URL_ANALYSIS

Parâmetros principais:

• targets (obrigatório) — array de objetos com url, mode (exact/prefix/domain/subdomains) e protocol (both/http/https)
• select (obrigatório) — array de identificadores de coluna
• country — código ISO do país
• output — json ou php

Exemplo de prompt: "Compare métricas de SEO para competitor1.com, competitor2.com e competitor3.com"

---

Armadilhas Conhecidas

• Seleção de coluna é obrigatória: A maioria das ferramentas Ahrefs requer um parâmetro select especificando quais colunas retornar. Omiti-lo ou usar nomes de coluna inválidos causará erros. Consulte o esquema de resposta de cada ferramenta para identificadores válidos.
• Consistência do formato de data: As datas devem estar no formato YYYY-MM-DD. Alguns endpoints históricos retornam dados na granularidade definida por history_grouping, não por data exata.
• Custos de unidade da API variam: Colunas diferentes consomem quantidades diferentes de unidades. Colunas marcadas como "(5 units)" ou "(10 units)" no esquema são mais caras. Monitore o uso da API ao solicitar colunas caras como traffic, refdomains_source ou difficulty.
• Limite de lote é de 100 targets: AHREFS_BATCH_URL_ANALYSIS aceita até 100 targets por requisição. Para análises maiores, divida em vários lotes.
• Expressões de filtro são complexas: O parâmetro where usa a sintaxe de expressão de filtro do Ahrefs, não SQL padrão. Consulte as descrições das colunas no esquema de cada ferramenta para tipos de filtro suportados e formatos de valor.
• Parâmetro offset descontinuado: O parâmetro offset foi descontinuado em 31 de maio de 2024. Use paginação baseada em cursor ou ajuste limit.
• O modo afeta significativamente o escopo: Definir mode como subdomains (o padrão) inclui todos os subdomínios, o que pode aumentar drasticamente a contagem de resultados em comparação com domain ou exact.

---

Referência Rápida

Slug da Ferramenta	Descrição
AHREFS_RETRIEVE_SITE_EXPLORER_METRICS	Métricas atuais de SEO para um domínio/URL
AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY	Métricas históricas de SEO ao longo do tempo
AHREFS_DOMAIN_RATING_HISTORY	Histórico de Domain Rating (DR)
AHREFS_FETCH_ALL_BACKLINKS	Lista abrangente de backlinks com filtragem
AHREFS_FETCH_SITE_EXPLORER_REFERRING_DOMAINS	Lista de domínios de referência
AHREFS_GET_SITE_EXPLORER_COUNTRY_METRICS	Detalhamento de tráfego por país
AHREFS_BATCH_URL_ANALYSIS	Análise em lote de até 100 URLs
AHREFS_EXPLORE_KEYWORDS_OVERVIEW	Visão geral de métricas de palavras-chave
AHREFS_EXPLORE_MATCHING_TERMS_FOR_KEYWORDS	Variações de palavras-chave correspondentes
AHREFS_EXPLORE_KEYWORD_VOLUME_BY_COUNTRY	Volume de palavras-chave por país
AHREFS_RETRIEVE_ORGANIC_KEYWORDS	Rankings orgânicos de palavras-chave para um domínio
AHREFS_RETRIEVE_SITE_EXPLORER_KEYWORDS_HISTORY	Dados históricos de ranking de palavras-chave
AHREFS_RETRIEVE_TOP_PAGES_FROM_SITE_EXPLORER	Páginas com melhor desempenho por métricas de SEO
AHREFS_GET_SERP_OVERVIEW	Visão geral do SERP para palavras-chave específicas

---

Desenvolvido por Composio