Spresh

spreshapp-mcp

Servidor MCP que conecta Claude a la plataforma de inteligencia publicitaria de Facebook de SpreshApp.

---

Pídele a Claude que investigue competidores, decodifique ángulos publicitarios ganadores, rastree el historial de anuncios de marcas y analice tu biblioteca de anuncios guardada, todo directamente desde tu sesión de Claude Desktop o Claude Code.

Requisitos

• Node.js >= 20
• Una cuenta de SpreshApp

Configuración

Claude Desktop

Agrega esto a tu claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Reinicia Claude Desktop después de guardar.

Claude Code

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

VS Code (con extensión MCP)

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

Autenticación

Autentícate una vez antes de iniciar el servidor MCP:

npx -y spreshapp-mcp login

Esto abre tu navegador para iniciar sesión con tu cuenta de SpreshApp (OAuth 2.0 con PKCE). Después de iniciar sesión, las credenciales se guardan en ~/.spreshapp/credentials.json (modo de archivo 600) y se actualizan automáticamente antes de cada sesión.

Para entornos remotos o sin interfaz gráfica, usa una clave de API de SpreshApp desde el panel en lugar del OAuth del navegador:

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

Esto imprime instrucciones de configuración para el usuario y el agente. El usuario puede crear o copiar una clave en spreshapp.com/app/api-access. Las claves comienzan con sk_sprs_.

Establece la clave en el entorno del servidor MCP:

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

Las variables de token OAuth aún son compatibles para configuraciones avanzadas: SPRESHAPP_ACCESS_TOKEN, SPRESHAPP_REFRESH_TOKEN, SPRESHAPP_CLIENT_ID y SPRESHAPP_TOKEN_EXPIRES_AT.

Verifica el estado de autenticación:

npx -y spreshapp-mcp status

Para iniciar sesión nuevamente:

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

Herramientas disponibles

Herramientas de anuncios

Herramienta	Descripción
ad_search	Busca anuncios de Facebook por palabra clave, nicho o industria
ad_search_expand_query	Expande una consulta de búsqueda para mostrar más anuncios relevantes
ad_get	Obtén detalles completos de un anuncio específico
ad_get_analysis	Recupera el análisis de IA guardado para un anuncio
ad_analyze	Ejecuta análisis de IA en cualquier anuncio
ad_analyze_batch	Analiza múltiples anuncios en una sola llamada
ad_chat	Chatea con Claude sobre la estrategia creativa de un anuncio

Herramientas de marcas

Herramienta	Descripción
brand_search	Busca marcas en SpreshApp
brand_get_overview	Obtén el perfil completo y las estadísticas de una marca
brand_get_status	Obtén el estado de seguimiento actual de una marca
brand_get_ad_history	Obtén datos históricos de volumen de anuncios de una marca
brand_list_active_ads	Lista todos los anuncios que una marca está ejecutando actualmente
brand_follow	Comienza a rastrear una marca

Herramientas de biblioteca

Herramienta	Descripción
search_ads	Busca en tu biblioteca de anuncios guardada
get_folder_ads	Obtén anuncios de una carpeta específica
list_folders	Lista todas tus carpetas guardadas
get_tags	Lista las etiquetas usadas en tu biblioteca
get_pages	Lista las páginas de Facebook guardadas

Ejemplos de consultas

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.

Solución de problemas

Síntoma	Solución
El navegador no se abrió	Copia la URL impresa en la terminal y ábrela manualmente
Error de "Autenticación expirada"	Elimina ~/.spreshapp/credentials.json y vuelve a ejecutar
"No suscrito a ningún plan"	Visita spreshapp.com/pricing
"Límite diario alcanzado"	La cuota se restablece a medianoche UTC, o mejora tu plan
"Función no disponible"	Tu plan actual no incluye esta herramienta, mejora en spreshapp.com/pricing

Licencia

UNLICENSED — software propietario. Consulta spreshapp.com para los términos.