Extensión Firecrawl para Claude SEO
Esta habilidad requiere que la extensión Firecrawl esté instalada:
./extensions/firecrawl/install.sh
Verificar disponibilidad: Antes de usar cualquier herramienta de Firecrawl, verifique que el servidor MCP esté conectado comprobando si firecrawl_scrape o cualquier herramienta de Firecrawl está disponible. Si las herramientas no están disponibles, informe al usuario que la extensión no está instalada y proporcione instrucciones de instalación.
Referencia Rápida
| Comando | Propósito |
|---|---|
/seo firecrawl crawl <url> | Rastreo completo del sitio con extracción de contenido |
/seo firecrawl map <url> | Descubrir la estructura del sitio (solo URLs, rápido) |
/seo firecrawl scrape <url> | Extracción de una sola página con renderizado JS |
/seo firecrawl search <consulta> <url> | Buscar dentro de un sitio rastreado |
Comandos
crawl -- Rastreo Completo del Sitio
Rastrea un sitio web completo comenzando desde la URL dada. Devuelve el contenido de la página, metadatos y enlaces de todas las páginas descubiertas.
Herramienta MCP: firecrawl_crawl
Parámetros:
url(obligatorio): URL inicial para rastrearlimit: Máximo de páginas a rastrear (predeterminado: 100, máximo: 500)maxDepth: Profundidad máxima de enlaces desde la URL inicial (predeterminado: 3)includePaths: Arreglo de patrones glob para incluir (ej.,["/blog/*"])excludePaths: Arreglo de patrones glob para excluir (ej.,["/admin/*", "/api/*"])scrapeOptions.formats: Formatos de salida --["markdown", "html", "links"]
Patrones de uso SEO:
- Auditoría integral de rastreo: Rastrear todo el sitio, extraer todas las páginas para análisis de subagente
- Rastreo enfocado en sección: Usar
includePathspara auditar solo/blog/*o/products/* - Detección de enlaces rotos: Rastrear con formato
["links"], verificar todos los hrefs en busca de 404 - Inventario de contenido: Extraer todos los títulos de página, meta descripciones, H1 a escala
- Sitios SPA/JS-renderizados: Firecrawl renderiza JavaScript, resolviendo el problema n.º 11
Ejemplo de orquestación para /seo audit:
1. firecrawl_map(url) -> obtener todas las URLs (rápido, sin contenido)
2. Filtrar las 50 páginas más importantes (página de inicio, secciones clave)
3. firecrawl_crawl(url, limit=50) -> obtener contenido completo
4. Alimentar contenido a agentes seo-technical, seo-content, seo-schema
Conciencia de costos:
- Nivel gratuito: 500 créditos/mes
- 1 crédito = 1 página rastreada o extraída
- Las operaciones de mapa son más baratas (0.5 créditos por URL descubierta)
- Siempre informar al usuario del uso estimado de créditos antes de rastreos grandes
map -- Descubrimiento de Estructura del Sitio
Descubre todas las URLs de un sitio web sin obtener contenido. Rápido y eficiente en créditos.
Herramienta MCP: firecrawl_map
Parámetros:
url(obligatorio): URL del sitio web a mapearlimit: Máximo de URLs a descubrir (predeterminado: 5000)search: Término de búsqueda opcional para filtrar URLs
Patrones de uso SEO:
- Comparación de sitemap: Mapear el sitio, comparar URLs descubiertas vs. sitemap XML
- Detección de páginas huérfanas: URLs en sitemap pero no enlazadas desde ninguna página
- Análisis de presupuesto de rastreo: Total de páginas indexables vs. páginas enlazadas desde la página de inicio
- Análisis de patrones de URL: Identificar patrones de estructura de URL, duplicados, inflación de parámetros
- Descubrimiento previo a la auditoría: Ejecutar mapa primero, luego rastreo dirigido en secciones clave
Salida: Arreglo de URLs. Presentar como:
Sitio: example.com
Páginas descubiertas: 342
Desglose de patrones de URL:
/blog/* - 128 páginas (37%)
/products/* - 89 páginas (26%)
/category/* - 45 páginas (13%)
/pages/* - 32 páginas (9%)
/ (páginas raíz) - 48 páginas (14%)
scrape -- Extracción Profunda de una Sola Página
Extrae una sola página con renderizado completo de JavaScript. Más exhaustivo que fetch_page.py porque ejecuta JS y espera contenido dinámico.
Herramienta MCP: firecrawl_scrape
Parámetros:
url(obligatorio): URL de la página a extraerformats: Formatos de salida --["markdown", "html", "links", "screenshot"]onlyMainContent: Eliminar navegación/pie de página/barra lateral (predeterminado: true)waitFor: Selector CSS o milisegundos para esperar contenidotimeout: Tiempo de espera de la solicitud en ms (predeterminado: 30000)actions: Acciones del navegador antes de la extracción (clic, desplazamiento, espera)
Patrones de uso SEO:
- Extracción de contenido SPA: Extraer páginas renderizadas con JS (React/Vue/Angular)
- Auditoría de contenido dinámico: Páginas con contenido cargado de forma perezosa (lazy load) debajo del pliegue
- Detección de muro de pago/inicio de sesión: Identificar contenido detrás de muros de autenticación
- Extracción de contenido principal: Usar
onlyMainContentpara un análisis E-E-A-T limpio - Captura de pantalla: Usar formato
screenshotpara análisis visual
Cuándo usar scrape vs. fetch_page.py:
| Escenario | Usar |
|---|---|
| Página HTML estática | fetch_page.py (sin costo de API) |
| SPA renderizada con JS | firecrawl_scrape (renderiza JS) |
| Necesito encabezados de respuesta | fetch_page.py (devuelve encabezados) |
| Necesito markdown limpio | firecrawl_scrape (mejor extracción) |
| Limitado/bloqueado por tasa | firecrawl_scrape (maneja anti-bot) |
search -- Búsqueda dentro del Sitio
Busca dentro de un sitio web contenido específico. Útil para encontrar páginas relacionadas con un tema sin rastrear todo.
Herramienta MCP: firecrawl_search
Parámetros:
query(obligatorio): Consulta de búsquedaurl(obligatorio): Sitio web donde buscarlimit: Máximo de resultados (predeterminado: 10)scrapeOptions.formats: Formato de salida para las páginas coincidentes
Patrones de uso SEO:
- Validación de brechas de contenido: Buscar una palabra clave en el sitio para verificar si existe contenido
- Oportunidades de enlazado interno: Encontrar páginas que mencionen un tema que podrían enlazarse entre sí
- Detección de contenido duplicado: Buscar frases clave para encontrar casi duplicados
- Investigación de contenido de competidores: Buscar en el sitio de un competidor temas específicos
Integración entre Habilidades
Con seo-audit (auditoría completa)
Cuando Firecrawl está disponible durante /seo audit:
- Usar
firecrawl_mappara descubrir todas las URLs del sitio - Comparar con el sitemap XML (seo-sitemap) para encontrar páginas huérfanas/faltantes
- Seleccionar las páginas principales para análisis profundo
- Alimentar el contenido rastreado a todos los subagentes (técnico, contenido, esquema, geo)
- Informar total de páginas rastreables, patrones de URL y profundidad de rastreo
Con seo-technical
- Detección de enlaces rotos: rastrear todos los enlaces internos, verificar 404
- Mapeo de cadenas de redireccionamiento: seguir todas las redirecciones, marcar cadenas > 2 saltos
- Detección de contenido mixto: verificar recursos HTTP en páginas HTTPS
- Verificación de canónicas: comparar URLs canónicas con URLs reales
Con seo-sitemap
- Cobertura del sitemap: % de páginas rastreadas presentes en el sitemap
- Páginas huérfanas: páginas encontradas por el rastreo pero faltantes en el sitemap
- Entradas obsoletas del sitemap: URLs en el sitemap que devuelven 404/410
Con seo-content
- Extracción de contenido: alimentar markdown limpio al análisis E-E-A-T
- Detección de contenido fino: identificar páginas con menos de 300 palabras a escala
- Contenido duplicado: comparar contenido entre páginas para casi duplicados
Con seo-schema
- Extracción de esquemas: extraer JSON-LD de todas las páginas rastreadas
- Cobertura de esquemas: % de páginas con datos estructurados
- Validación de esquemas: validar en lotes los esquemas extraídos
Manejo de Errores
| Error | Causa | Resolución |
|---|---|---|
FIRECRAWL_API_KEY no configurada | MCP no configurado | Ejecutar ./extensions/firecrawl/install.sh |
402 Se requiere pago | Créditos agotados | Verificar uso en firecrawl.dev/app, actualizar plan |
429 Demasiadas solicitudes | Límite de velocidad alcanzado | Esperar 60s, reducir concurrencia de rastreo |
408 Tiempo de espera | Página demasiado lenta para renderizar | Aumentar timeout, intentar sin renderizado JS |
403 Prohibido | El sitio bloquea el rastreo | Verificar robots.txt, puede ser necesario omitir este sitio |
Alternativa de respaldo elegante: Si Firecrawl no está disponible, informar al usuario y sugerir:
- Usar
fetch_page.pypara análisis de una sola página (sin costo de API) - Usar la herramienta
WebFetchpara recuperación básica de HTML - Instalar Firecrawl:
./extensions/firecrawl/install.sh