Apunta Cursor a https://mcp.scavio.dev/mcp con una cabecera x-api-key y podrás sacar un informe de competencia completo desde el modo agente sin salir del editor. Alguien en r/buildinpublic contó que pasó una semana montando un servidor MCP solo para esto; el servidor alojado de Scavio te ahorra esa semana. El endpoint MCP es la única superficie de Scavio que autentica con x-api-key. Todos los endpoints REST usan Authorization: Bearer, así que no los mezcles. Este tutorial deja el servidor cargado en Cursor y luego le pide al agente que busque resultados de Google y menciones de Reddit de un competidor y arme el resumen.
Requisitos previos
- Cursor instalado con modo agente (Composer) disponible
- Una clave de API de Scavio — 50 créditos gratis al registrarte, sin tarjeta
- Soltura básica editando un archivo de configuración JSON
Guia paso a paso
Paso 1: 1. Consigue una clave de API de Scavio
Regístrate en scavio.dev y crea una clave desde el panel. Las cuentas nuevas reciben 50 créditos gratis, una sola vez y sin tarjeta. Una llamada a Google con todas las funciones del SERP cuesta 2 créditos y una búsqueda en Reddit cuesta 1, así que sacar un competidor ronda los 3 créditos: el plan gratuito cubre una docena de informes antes de pagar nada. Copia la clave; la pegarás en la configuración de Cursor en el siguiente paso.
Paso 2: 2. Añade el servidor MCP alojado a Cursor
Abre los ajustes de Cursor, ve a MCP y edita mcp.json. Añade el servidor de Scavio apuntando a la URL remota con tu clave en la cabecera x-api-key. Esta es la excepción que conviene memorizar: el servidor MCP usa x-api-key, no Bearer. Pega este bloque y sustituye tu clave real.
{
"mcpServers": {
"scavio": {
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}Paso 3: 3. Reinicia Cursor y confirma que cargan las herramientas
Reinicia Cursor para que vuelva a conectarse al servidor MCP. Abre el panel de MCP en los ajustes; la entrada de Scavio debería mostrar un punto verde y una lista de herramientas — google, reddit_search, youtube_search, amazon_product y más. Si sigue en rojo, la causa habitual es un nombre de cabecera incorrecto (Bearer en vez de x-api-key) o una clave sin créditos. Corrige la cabecera, guarda y reinicia de nuevo.
Paso 4: 4. Pídeselo a Cursor en modo agente
Abre Composer en modo agente y escribe una petición en lenguaje natural. El agente lee la lista de herramientas y decide cuáles de Scavio llamar. Ejemplo de prompt:
Pull the top 10 Google results and the recent Reddit mentions for Linear (the project management tool). Summarize how they position themselves, what people praise, and what they complain about.Paso 5: 5. Deja que el agente arme el informe
El agente llama a la herramienta google para los 10 primeros resultados orgánicos, luego a reddit_search para las menciones de la comunidad, lee ambas respuestas y escribe un resumen estructurado en el chat. Puedes seguir en el mismo hilo — pídele que compare dos competidores o que saque reseñas de YouTube con youtube_search — sin repetir la configuración. Cada llamada gasta créditos de la misma clave.
Ejemplo en Python
import os, requests
KEY = os.environ["SCAVIO_API_KEY"]
HEADERS = {"Authorization": f"Bearer {KEY}"} # REST uses Bearer, not x-api-key
COMPETITOR = "Linear project management"
# Google SERP, full features (2 credits)
google = requests.post(
"https://api.scavio.dev/api/v1/google",
headers=HEADERS,
json={"query": COMPETITOR, "light_request": False},
).json()
# Reddit mentions (1 credit)
reddit = requests.post(
"https://api.scavio.dev/api/v1/reddit/search",
headers=HEADERS,
json={"query": COMPETITOR},
).json()
organic = google.get("organic", [])[:10]
print("Top results:")
for r in organic:
print("-", r.get("title"), r.get("link"))
print("\nReddit mentions:")
for p in reddit.get("results", [])[:10]:
print("-", p.get("title"))Ejemplo en JavaScript
const KEY = process.env.SCAVIO_API_KEY;
const HEADERS = {
"Authorization": `Bearer ${KEY}`, // REST uses Bearer, not x-api-key
"Content-Type": "application/json",
};
const COMPETITOR = "Linear project management";
// Google SERP, full features (2 credits)
const google = await fetch("https://api.scavio.dev/api/v1/google", {
method: "POST",
headers: HEADERS,
body: JSON.stringify({ query: COMPETITOR, light_request: false }),
}).then((r) => r.json());
// Reddit mentions (1 credit)
const reddit = await fetch("https://api.scavio.dev/api/v1/reddit/search", {
method: "POST",
headers: HEADERS,
body: JSON.stringify({ query: COMPETITOR }),
}).then((r) => r.json());
console.log("Top results:");
for (const r of (google.organic || []).slice(0, 10)) {
console.log("-", r.title, r.link);
}
console.log("Reddit mentions:");
for (const p of (reddit.results || []).slice(0, 10)) {
console.log("-", p.title);
}Salida esperada
Competidor: Linear (gestion de proyectos)
Posicionamiento (de los 10 primeros de Google):
- Se vende como el rastreador de incidencias hecho para la velocidad y el teclado
- Apunta a equipos de ingenieria que encuentran Jira lento
Lo que la gente elogia (de Reddit):
- UI rapida, atajos de teclado limpios, valores por defecto con criterio
Quejas habituales (de Reddit):
- Informes personalizados limitados; el precio sube con muchos asientos
Fuentes: 10 resultados organicos + 8 hilos de Reddit. Gasto: ~3 creditos.