Las habilidades de Claude Code le permiten empaquetar flujos de trabajo reutilizables que Claude Code puede invocar bajo demanda. Una habilidad de SEO combina datos SERP en vivo de la API de Scavio con el razonamiento de Claude Code para ejecutar comprobaciones de palabras clave, monitorear la visibilidad de la descripción general de la IA y encontrar lagunas de contenido directamente en su terminal. Este tutorial muestra cómo crear el archivo de habilidades, configurar la conexión del servidor MCP y escribir las instrucciones de habilidades que sigue Claude Code. Tendrá una habilidad de SEO funcional que ejecuta comprobaciones de clasificación, análisis PAA y monitoreo AEO con un solo comando.
Requisitos previos
- CLI de Claude Code instalada y configurada
- Una clave API de Scavio de scavio.dev
- Familiaridad con los archivos de habilidades de Claude Code y MCP
Guia paso a paso
Paso 1: Crear el archivo de habilidades
Configure el directorio de habilidades y cree el archivo de instrucciones para Claude Code.
# Create the skill directory
mkdir -p .claude/skills
# Create the SEO skill file
# .claude/skills/seo.md
# This file contains instructions Claude Code follows
# when the skill is invokedPaso 2: Configurar el servidor Scavio MCP
Agregue el servidor Scavio MCP a su proyecto para que la habilidad pueda llamar a las herramientas de búsqueda.
# .mcp.json in project root:
# {
# "mcpServers": {
# "scavio": {
# "url": "https://mcp.scavio.dev/mcp",
# "headers": {
# "x-api-key": "YOUR_SCAVIO_API_KEY"
# }
# }
# }
# }Paso 3: Escribir instrucciones de habilidades
Defina qué hace la habilidad SEO cuando se invoca. Las instrucciones le indican a Claude Code cómo utilizar los datos de búsqueda.
# .claude/skills/seo.md content:
# When invoked for a keyword:
# 1. Use scavio search tool to fetch SERP for the keyword
# 2. Report top 5 organic results with positions
# 3. Check if AI Overview exists and list cited domains
# 4. Extract People Also Ask questions
# 5. Identify content gaps compared to top resultsPaso 4: Pruebe la API subyacente
Verifique que la API de Scavio devuelva los datos que necesita la habilidad.
import os, requests
API_KEY = os.environ["SCAVIO_API_KEY"]
resp = requests.post("https://api.scavio.dev/api/v1/search",
headers={"x-api-key": API_KEY},
json={"platform": "google", "query": "best project management tool"})
data = resp.json()
print(f"Organic: {len(data.get('organic_results', []))}")
print(f"AIO: {'yes' if data.get('ai_overview') else 'no'}")
print(f"PAA: {len(data.get('people_also_ask', []))}")Paso 5: Invocar la habilidad
Ejecute la habilidad desde su terminal para verificar que todo esté conectado.
# In Claude Code terminal:
# /seo "best project management tool"
#
# Claude Code will:
# 1. Call the Scavio MCP search tool
# 2. Parse the SERP response
# 3. Format a report with rankings, AIO, and PAA
# 4. Suggest content improvementsEjemplo en Python
import os, requests
API_KEY = os.environ["SCAVIO_API_KEY"]
def seo_check(kw):
resp = requests.post("https://api.scavio.dev/api/v1/search",
headers={"x-api-key": API_KEY},
json={"platform": "google", "query": kw})
d = resp.json()
return {"organic": len(d.get("organic_results",[])),
"aio": bool(d.get("ai_overview")),
"paa": len(d.get("people_also_ask",[]))}
print(seo_check("best project management tool"))Ejemplo en JavaScript
const H = {"x-api-key": process.env.SCAVIO_API_KEY, "Content-Type": "application/json"};
async function seoCheck(kw) {
const r = await fetch("https://api.scavio.dev/api/v1/search", {
method: "POST", headers: H,
body: JSON.stringify({platform: "google", query: kw})
});
const d = await r.json();
return {organic: (d.organic_results||[]).length, aio: !!d.ai_overview,
paa: (d.people_also_ask||[]).length};
}
seoCheck("best project management tool").then(console.log);Salida esperada
A Claude Code skill that runs SEO research from the terminal, returning organic rankings, AI Overview status, and People Also Ask questions for any keyword.