Automação SEMrush

O que Automação SEMrush faz?

Execute análises de SEO do SEMrush diretamente do Claude Code. Analise palavras-chave de domínio, audite perfis de backlinks, pesquise dificuldade de palavras-chave, descubra termos relacionados e acompanhe o desempenho de páginas orgânicas sem sair do seu terminal.

Documentação do kit de ferramentas: composio.dev/toolkits/semrush

---

Configuração

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

   https://rube.app/mcp
   

2. Conecte sua conta do SEMrush quando solicitado. O agente fornecerá um link de autenticação.
3. Todas as ferramentas do SEMrush exigem um parâmetro database especificando o banco de dados regional (ex.: us, uk, de). Escolha a região correta para seu público-alvo.

---

Fluxos de Trabalho Principais

1. Análise de Palavras-chave Orgânicas de Domínio

Recupere todas as palavras-chave de pesquisa orgânica para um domínio, incluindo posições, estimativas de tráfego, CPC e dificuldade da palavra-chave.

Ferramenta: SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS

Parâmetros-chave:

• domain (obrigatório) -- ex.: example.com
• database (obrigatório) -- código do banco de dados regional (ex.: us, uk, de)
• display_limit (padrão 10000) e display_offset (padrão 0) -- paginação
• display_sort -- ordenar por posição, tráfego, volume, etc. (ex.: tr_desc para tráfego decrescente)
• display_date -- dados históricos no formato YYYYMM15 (mensal) ou YYYYMMDD (diário)
• export_columns -- especificar colunas como Ph (frase), Po (posição), Nq (volume), Tr (tráfego), Kd (dificuldade)
• display_filter -- filtrar por colunas específicas

Exemplo de prompt: "Obtenha as 100 principais palavras-chave orgânicas para example.com no banco de dados dos EUA, ordenadas por tráfego"

---

2. Visão Geral de Palavras-chave e Análise em Lote

Obtenha métricas detalhadas para palavras-chave individuais ou analise até 100 palavras-chave de uma vez.

Ferramentas: SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE, SEMRUSH_BATCH_KEYWORD_OVERVIEW

Para palavra-chave única:

• phrase (obrigatório) -- palavra-chave a ser investigada
• database (obrigatório) -- banco de dados regional

Para lote (até 100 palavras-chave):

• phrase (obrigatório) -- palavras-chave separadas por ponto e vírgula (máx. 255 caracteres no total)
• database (obrigatório) -- banco de dados regional
• export_columns -- Ph (frase), Nq (volume), Cp (CPC), Co (concorrência), Kd (dificuldade), In (intenção)

Exemplo de prompt: "Obtenha métricas de palavras-chave para 'seo services;content marketing;link building' no banco de dados dos EUA"

---

3. Relatório de Páginas Orgânicas de Domínio

Descubra quais URLs em um domínio geram mais tráfego orgânico e visibilidade.

Ferramenta: SEMRUSH_DOMAIN_ORGANIC_PAGES

Parâmetros-chave:

• domain (obrigatório) -- domínio alvo
• database (obrigatório) -- banco de dados regional
• display_sort -- ex.: pc_desc para participação no tráfego decrescente
• display_limit e display_offset -- paginação
• export_columns -- Ur (URL), Pc (% de tráfego), Tg (tráfego), Tr (custo do tráfego)

Exemplo de prompt: "Mostre as 50 principais páginas orgânicas para example.com classificadas por participação no tráfego"

---

4. Visão Geral do Perfil de Backlinks

Obtenha um resumo dos backlinks para um domínio, incluindo Authority Score, tipos de links e contagens de domínios de referência.

Ferramenta: SEMRUSH_BACKLINKS_OVERVIEW

Parâmetros-chave:

• target (obrigatório) -- domínio, subdomínio ou URL completa
• target_type (obrigatório) -- root_domain, domain ou url
• export_columns -- ascore (Authority Score), total (total de backlinks), domains_num (domínios de referência), follows_num, nofollows_num, etc.

Exemplo de prompt: "Obtenha a visão geral de backlinks para example.com, incluindo Authority Score e contagem de domínios de referência"

---

5. Avaliação de Dificuldade de Palavras-chave

Pontue o quão difícil é rankear no top 10 para palavras-chave específicas (escala de 0 a 100).

Ferramenta: SEMRUSH_KEYWORD_DIFFICULTY

Parâmetros-chave:

• phrase (obrigatório) -- palavra-chave a analisar
• database (obrigatório) -- banco de dados regional
• export_columns -- Ph (frase), Kd (pontuação de dificuldade)

Exemplo de prompt: "Qual é a dificuldade da palavra-chave para 'best project management software' nos EUA?"

---

6. Descobrir Palavras-chave Relacionadas

Encontre sinônimos, variações e termos relacionados para uma palavra-chave semente para expandir sua estratégia de conteúdo.

Ferramenta: SEMRUSH_RELATED_KEYWORDS

Parâmetros-chave:

• phrase (obrigatório) -- palavra-chave semente
• database (obrigatório) -- banco de dados regional
• display_limit (padrão 10000) -- máximo de resultados
• display_sort -- ex.: nq_desc para volume decrescente, kd_asc para mais fáceis primeiro
• export_columns -- Ph, Nq, Kd, Cp, Co, Rr (pontuação de relevância)

Exemplo de prompt: "Encontre palavras-chave relacionadas para 'project management' nos EUA, ordenadas por volume de pesquisa"

---

Armadilhas Conhecidas

• Paginação é essencial: SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS e SEMRUSH_DOMAIN_ORGANIC_PAGES podem retornar conjuntos de dados muito grandes. Sempre use display_limit e display_offset em vez de assumir que uma única página está completa.
• Respostas no estilo CSV: Muitas ferramentas do SEMrush retornam dados como texto no formato CSV em um único campo (ex.: data/keyword_data). Você deve analisar linhas e colunas antes de analisar ou combinar relatórios.
• "ERROR 50 :: NOTHING FOUND": Esta string literal significa que o domínio ou palavra-chave não possui dados naquele banco de dados. Trate-a como uma resposta válida de zero resultados, não um erro de transporte.
• Limites de palavras-chave em lote: SEMRUSH_BATCH_KEYWORD_OVERVIEW pode retornar HTTP 400 para lotes problemáticos ou muito grandes (máx. 255 caracteres no total para o campo phrase). Reduza os lotes ou recorra a SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE para consultas individuais.
• Formato de data: Datas históricas devem usar o formato YYYYMM15 para dados mensais (ex.: 20231015). Usar um formato incorreto retornará resultados inesperados.
• Banco de dados regional é importante: Sempre use o banco de dados regional correto para seu público-alvo. Os resultados para us vs uk podem diferir drasticamente em volume, CPC e classificações.
• Códigos de coluna: Colunas de exportação usam códigos curtos (Ph, Nq, Kd, etc.). Evite restringir demais export_columns para que métricas-chave como tráfego, CPC, posição e dificuldade sejam mantidas.

---

Referência Rápida

Slug da Ferramenta	Descrição
SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS	Palavras-chave orgânicas para um domínio com posições e tráfego
SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE	Métricas de palavra-chave única (volume, CPC, dificuldade)
SEMRUSH_BATCH_KEYWORD_OVERVIEW	Métricas em lote para até 100 palavras-chave
SEMRUSH_DOMAIN_ORGANIC_PAGES	Principais páginas orgânicas de um domínio por tráfego
SEMRUSH_BACKLINKS_OVERVIEW	Resumo do perfil de backlinks com Authority Score
SEMRUSH_BACKLINKS	Lista detalhada de backlinks para um alvo
SEMRUSH_KEYWORD_DIFFICULTY	Pontuação de dificuldade de palavra-chave (0-100)
SEMRUSH_RELATED_KEYWORDS	Palavras-chave relacionadas/similares para uma frase semente
SEMRUSH_CATEGORIES	Categorias de domínio com classificações de confiança
SEMRUSH_DOMAIN_ORGANIC_SUBDOMAINS	Análise de classificações orgânicas em nível de subdomínio

---

Distribuído por Composio