Semust

Servidor MCP Semust

Pergunte ao Claude sobre seus dados de SEO e publicidade em linguagem natural. Este servidor MCP conecta o Claude Desktop (e o Cursor) à sua conta Semust — palavras-chave, páginas, tendências de tráfego, relatórios de SEO, Google Analytics, Google Ads, Yandex Metrica, Bing Webmaster e muito mais.

"Mostre minhas principais palavras-chave do último mês"

"Quais páginas estão perdendo tráfego?"

"Como está meu tráfego orgânico comparado ao mês passado?"

"Quais landing pages convertem melhor?"

"Como estão minhas campanhas do Google Ads?"

Como Funciona

You ask Claude a question
        |
Claude Desktop (on your machine)
        |
   MCP Server (on your machine) ---- Your API key stays here, never sent to Claude
        |
   Semust API (semust.com)
        |
   Your Google Search Console, Analytics & Ads data
        |
   Results sent back to Claude
        |
Claude answers with SEO insights

Sua chave de API nunca sai da sua máquina. O Claude vê apenas os dados de SEO, não suas credenciais.

O Que Você Pode Perguntar

Depois de configurado, basta conversar com o Claude naturalmente:

Tráfego e Desempenho

• "Como meu site está se saindo este mês?"
• "Mostre o tráfego diário dos últimos 30 dias"
• "Meu tráfego está crescendo ou caindo?"

Palavras-chave

• "Quais são minhas 20 principais palavras-chave?"
• "Quais palavras-chave estão na página 2? Essas são minhas vitórias rápidas"
• "Encontre oportunidades de palavras-chave de cauda longa"

Google Analytics

• "De onde vem meu tráfego?"
• "Como está o desempenho de tráfego orgânico vs. pago?"
• "Quais landing pages convertem melhor?"
• "Mostre a divisão entre mobile e desktop"
• "Quais páginas têm o pior engajamento?"

Rank Tracker

• "Onde estou classificado para minhas palavras-chave?"
• "Quais palavras-chave ganharam ou perderam posições?"
• "Quantas palavras-chave estão na página 1?"

AI Rank Tracker

• "Estou aparecendo nos AI Overviews do Google?"
• "Quais concorrentes são citados nas respostas de IA?"

Monitor de Indexação

• "Todas as minhas páginas estão indexadas?"
• "Qual é minha pontuação de saúde de indexação?"

Yandex Metrica

• "Como está meu tráfego do Yandex?"
• "O que as pessoas pesquisam no Yandex?"
• "Mostre as fontes de tráfego do Yandex"

Bing Webmaster

• "Como estão minhas páginas no Bing?"
• "Mostre problemas de rastreamento do Bing"
• "Quais são meus backlinks do Bing?"

Google Ads

• "Como estão minhas campanhas?"
• "Quanto estou gastando e qual é meu ROAS?"
• "Quais termos de pesquisa acionam meus anúncios?"
• "Mostre o desempenho dos anúncios por país"
• "Quais tipos de conversão estou obtendo?"

Análise de Conteúdo

• "Quais páginas estão perdendo tráfego? Preciso atualizá-las"
• "Mostre meu conteúdo com pior desempenho"
• "Tenho problemas de canibalização de palavras-chave?"

Relatórios

• "Gere um relatório mensal de SEO para maio de 2026"
• "Quais palavras-chave ganharam ou perderam tráfego este mês?"
• "Encontre palavras-chave com CTR baixo que devo otimizar"
• "Me dê um relatório completo de SEO + analytics"

Ideias de Conteúdo

• "Quais perguntas as pessoas fazem que levam ao meu site?"
• "Mostre palavras-chave de cauda longa com 4+ palavras"

Início Rápido

Passo 1: Obtenha Sua Chave de API

Faça login no Semust > Configurações > Chave de API > Copiar.

Certifique-se de ter pelo menos um projeto com Google Search Console conectado.

Passo 2: Baixe e Instale

Opção A: Baixar ZIP (mais fácil)

Baixar ZIP > Extraia para uma pasta que você lembrará.

Opção B: Git Clone

git clone https://github.com/semust/semust-mcp.git

Depois instale as dependências:

cd semust-mcp
pip install -r requirements.txt

Passo 3: Configure o Claude Desktop

Encontre o arquivo de configuração do Claude Desktop:

%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\

%APPDATA%\Claude\

~/Library/Application Support/Claude/claude_desktop_config.json

Adicione mcpServers ao arquivo. Se o arquivo já tiver conteúdo, mescle isto ao JSON existente:

{
  "mcpServers": {
    "semust": {
      "command": "python",
      "args": ["C:\\full\\path\\to\\semust-mcp\\semust_mcp.py"],
      "env": {
        "SEMUST_API_KEY": "your-api-key-here",
        "SEMUST_BASE_URL": "https://api.semust.com/v1/mcp"
      },
      "alwaysAllow": [
        "list_projects",
        "get_keywords", "get_pages", "get_performance",
        "report_cannibalization", "report_monthly_summary", "report_long_tail",
        "report_winner_loser", "report_questions", "report_content_decay",
        "report_striking_distance", "report_low_ctr", "report_thin_content",
        "ga_get_overview", "ga_get_traffic_sources", "ga_get_pages",
        "ga_get_geo", "ga_get_devices", "ga_get_key_events",
        "ga_report_traffic_trends", "ga_report_landing_page_performance",
        "ga_report_channel_comparison", "ga_report_engagement_analysis",
        "gads_get_campaigns", "gads_get_daily_metrics", "gads_get_geo",
        "gads_get_devices", "gads_get_search_terms",
        "gads_report_performance_overview", "gads_report_spend_analysis",
        "gads_report_conversion_breakdown",
        "rank_get_keywords", "rank_get_overview", "rank_get_history",
        "rank_report_gainers_losers", "rank_report_distribution",
        "ai_rank_get_overview", "ai_rank_get_keywords", "ai_rank_get_domains",
        "indexing_get_status", "indexing_get_history",
        "ym_get_overview", "ym_get_traffic", "ym_get_pages",
        "ym_get_geo", "ym_get_devices", "ym_get_search_phrases",
        "bing_get_query_stats", "bing_get_page_stats", "bing_get_crawl_stats",
        "bing_get_crawl_issues", "bing_get_rank_traffic", "bing_get_link_counts",
        "bing_get_keyword_stats", "bing_get_url_traffic", "bing_get_url_links"
      ]
    }
  }
}

Importante: Substitua o caminho pela localização real de semust_mcp.py na sua máquina.

Windows: Use barras invertidas duplas: C:\\Users\\you\\semust-mcp\\semust_mcp.py

Se python não funcionar: Use o caminho completo do Python, por exemplo: C:\\Users\\you\\AppData\\Local\\Programs\\Python\\Python312\\python.exe

alwaysAllow: Esta lista permite que o Claude use as ferramentas do Semust sem pedir permissão a cada vez. Todas as ferramentas são somente leitura e seguras para aprovação automática. Remova este campo se preferir aprovar cada chamada de ferramenta manualmente.

Saia completamente do Claude Desktop (clique com o botão direito no ícone da bandeja do sistema > Sair) e reabra.

Passo 4: Verifique

Em uma nova conversa do Claude, procure o ícone de ferramentas (martelo/chave inglesa) perto do campo de texto. Clique nele — você deve ver "semust-mcp" com 56 ferramentas.

Digite: "Mostre meus projetos" — o Claude deve listar seus projetos do Semust.

Segurança

• O servidor MCP executa localmente no seu computador — não é um serviço em nuvem
• Sua chave de API do Semust é usada apenas para requisições diretas da sua máquina para api.semust.com
• O Claude vê as respostas dos dados de SEO, mas nunca sua chave de API ou credenciais de autenticação
• O arquivo .env está em .gitignore — não será acidentalmente commitado no git
• O servidor se recusa a iniciar se SEMUST_BASE_URL for http:// (não-localhost) — sua chave nunca é enviada em texto puro
• Proteja seu arquivo de configuração do Claude Desktop — qualquer pessoa com acesso de leitura a ele pode ler sua chave de API
• Os dados de SEO passados ao Claude são tratados como conteúdo confiável do usuário; se seu Search Console contiver consultas de spam com instruções embutidas, o modelo pode agir sobre elas — isso é inerente a todas as ferramentas MCP que exibem dados de terceiros

Ferramentas Disponíveis (56)

Projetos

Search Console — Dados

Search Console — Relatórios

Google Analytics — Dados

Google Analytics — Relatórios

Google Ads — Dados

Google Ads — Relatórios

Rank Tracker

AI Rank Tracker

Monitor de Indexação

Yandex Metrica

Bing Webmaster

Configuração no Cursor

Adicione o mesmo servidor MCP no Cursor: Configurações > Servidores MCP > Adicionar Servidor (tipo stdio).

Use os mesmos valores de comando, args e env da configuração do Claude Desktop acima.

Solução de Problemas

Requisitos

• Python 3.10+
• Claude Desktop ou Cursor
• Uma conta Semust com assinatura ativa
• Google Search Console, Google Analytics, Google Ads, Yandex Metrica e/ou Bing Webmaster conectados a pelo menos um projeto

Licença

MIT — veja LICENSE