Spresh

spreshapp-mcp

Servidor MCP que conecta o Claude à plataforma de inteligência de anúncios do Facebook da SpreshApp.

---

Peça ao Claude para pesquisar concorrentes, decodificar ângulos de anúncios vencedores, acompanhar o histórico de anúncios de marcas e analisar sua biblioteca de anúncios salva, tudo diretamente da sua sessão do Claude Desktop ou Claude Code.

Requisitos

• Node.js >= 20
• Uma conta SpreshApp

Configuração

Claude Desktop

Adicione isto ao seu claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "spreshapp": {
      "command": "npx",
      "args": ["-y", "spreshapp-mcp"]
    }
  }
}

Reinicie o Claude Desktop após salvar.

Claude Code

claude mcp add spreshapp -- npx -y spreshapp-mcp

VS Code (com extensão MCP)

{
  "mcp": {
    "servers": {
      "spreshapp": {
        "command": "npx",
        "args": ["-y", "spreshapp-mcp"]
      }
    }
  }
}

Autenticação

Autentique-se uma vez antes de iniciar o servidor MCP:

npx -y spreshapp-mcp login

Isso abre seu navegador para fazer login com sua conta SpreshApp (OAuth 2.0 com PKCE). Após o login, as credenciais são salvas em ~/.spreshapp/credentials.json (modo de arquivo 600) e atualizadas automaticamente antes de cada sessão.

Para ambientes headless ou agentes remotos, use uma chave de API da SpreshApp do painel em vez do OAuth do navegador:

npx -y spreshapp-mcp login --no-browser

Isso imprime instruções de configuração para o usuário e o agente. O usuário pode criar ou copiar uma chave em spreshapp.com/app/api-access. As chaves começam com sk_sprs_.

Defina a chave no ambiente do servidor MCP:

SPRESHAPP_API_KEY=sk_sprs_... npx -y spreshapp-mcp

As variáveis de token OAuth ainda são suportadas para configurações avançadas: SPRESHAPP_ACCESS_TOKEN, SPRESHAPP_REFRESH_TOKEN, SPRESHAPP_CLIENT_ID e SPRESHAPP_TOKEN_EXPIRES_AT.

Verifique o status da autenticação:

npx -y spreshapp-mcp status

Para fazer login novamente:

npx -y spreshapp-mcp logout
npx -y spreshapp-mcp login

Ferramentas Disponíveis

Ferramentas de anúncios

Ferramenta	Descrição
ad_search	Pesquise anúncios do Facebook por palavra-chave, nicho ou setor
ad_search_expand_query	Expanda uma consulta de pesquisa para exibir anúncios mais relevantes
ad_get	Obtenha detalhes completos de um anúncio específico
ad_get_analysis	Recupere a análise de IA salva para um anúncio
ad_analyze	Execute análise de IA em qualquer anúncio
ad_analyze_batch	Analise vários anúncios em uma única chamada
ad_chat	Converse com o Claude sobre a estratégia criativa de um anúncio

Ferramentas de marcas

Ferramenta	Descrição
brand_search	Pesquise marcas na SpreshApp
brand_get_overview	Obtenha o perfil completo e as estatísticas de uma marca
brand_get_status	Obtenha o status atual de rastreamento de uma marca
brand_get_ad_history	Obtenha dados históricos de volume de anúncios de uma marca
brand_list_active_ads	Liste todos os anúncios que uma marca está veiculando atualmente
brand_follow	Comece a rastrear uma marca

Ferramentas de biblioteca

Ferramenta	Descrição
search_ads	Pesquise sua biblioteca de anúncios salva
get_folder_ads	Obtenha anúncios de uma pasta específica
list_folders	Liste todas as suas pastas salvas
get_tags	Liste as tags usadas em toda a sua biblioteca
get_pages	Liste páginas do Facebook salvas

Exemplos de prompts

Find 10 high-performing Facebook video ads in the fitness niche and summarize the angles used.

Research Nike's current Facebook ad strategy, how many ads are they running and what are the themes?

Open my "Inspiration" folder and identify the top 3 creative hooks.

Track the brand glossier.com and show me their ad history over the last 30 days.

Solução de problemas

Sintoma	Correção
O navegador não abriu	Copie a URL impressa no terminal e abra-a manualmente
Erro de "autenticação expirada"	Exclua ~/.spreshapp/credentials.json e execute novamente
"Não assinado em nenhum plano"	Visite spreshapp.com/pricing
"Limite diário atingido"	A cota é redefinida à meia-noite UTC, ou faça upgrade do seu plano
"Recurso não disponível"	Seu plano atual não inclui esta ferramenta, faça upgrade em spreshapp.com/pricing

Licença

UNLICENSED — software proprietário. Consulte spreshapp.com para os termos.