Servidor MCP de Firecrawl

Un servidor de Protocolo de Contexto de Modelo (MCP) para raspado web, búsqueda de contenido, rastreo de sitios y extracción de datos mediante la API Firecrawl.

Características

Web Scraping : extrae contenido de cualquier página web con opciones personalizables
- Emulación de dispositivos móviles
- Bloqueo de anuncios y ventanas emergentes
- Filtrado de contenido
- Extracción de datos estructurados
- Múltiples formatos de salida
Búsqueda de contenido : capacidades de búsqueda inteligente
- Soporte multilingüe
- Resultados basados en la ubicación
- Límites de resultados personalizables
- Formatos de salida estructurados
Rastreo de sitios : funcionalidad avanzada de rastreo web
- Control de profundidad
- Filtrado de rutas
- Limitación de velocidad
- Seguimiento del progreso
- Integración del mapa del sitio
Mapeo del sitio : generar mapas de la estructura del sitio
- Soporte de subdominios
- Filtrado de búsqueda
- Análisis de enlaces
- Jerarquía visual
Extracción de datos : extraiga datos estructurados de múltiples URL
- Validación de esquemas
- Procesamiento por lotes
- Enriquecimiento de la búsqueda web
- Indicaciones de extracción personalizadas

Related MCP server: MCP Firecrawl Server

Instalación

# Global installation npm install -g @modelcontextprotocol/mcp-server-firecrawl # Local project installation npm install @modelcontextprotocol/mcp-server-firecrawl

Inicio rápido

Obtén tu clave API de Firecrawl desde el portal para desarrolladores
Establezca su clave API:
Unix/Linux/macOS (bash/zsh):
export FIRECRAWL_API_KEY=your-api-key
Windows (símbolo del sistema):
set FIRECRAWL_API_KEY=your-api-key
Ventanas (PowerShell):
$env:FIRECRAWL_API_KEY = "your-api-key"
Alternativa: usar el archivo .env (recomendado para desarrollo):
# Install dotenv npm install dotenv # Create .env file echo "FIRECRAWL_API_KEY=your-api-key" > .env
Luego en tu código:
import dotenv from 'dotenv'; dotenv.config();
Ejecutar el servidor:
mcp-server-firecrawl

Integración

Aplicación de escritorio Claude

Añade a tu configuración de MCP:

{ "firecrawl": { "command": "mcp-server-firecrawl", "env": { "FIRECRAWL_API_KEY": "your-api-key" } } }

Extensión de VSCode de Claude

Añade a tu configuración de MCP:

{ "mcpServers": { "firecrawl": { "command": "mcp-server-firecrawl", "env": { "FIRECRAWL_API_KEY": "your-api-key" } } } }

Ejemplos de uso

Web Scraping

// Basic scraping { name: "scrape_url", arguments: { url: "https://example.com", formats: ["markdown"], onlyMainContent: true } } // Advanced extraction { name: "scrape_url", arguments: { url: "https://example.com/blog", jsonOptions: { prompt: "Extract article content", schema: { title: "string", content: "string" } }, mobile: true, blockAds: true } }

Rastreo del sitio

// Basic crawling { name: "crawl", arguments: { url: "https://example.com", maxDepth: 2, limit: 100 } } // Advanced crawling { name: "crawl", arguments: { url: "https://example.com", maxDepth: 3, includePaths: ["/blog", "/products"], excludePaths: ["/admin"], ignoreQueryParameters: true } }

Mapeo del sitio

// Generate site map { name: "map", arguments: { url: "https://example.com", includeSubdomains: true, limit: 1000 } }

Extracción de datos

// Extract structured data { name: "extract", arguments: { urls: ["https://example.com/product1", "https://example.com/product2"], prompt: "Extract product details", schema: { name: "string", price: "number", description: "string" } } }

Configuración

Consulte la guía de configuración para obtener opciones de configuración detalladas.

Documentación de la API

Consulte la documentación de la API para obtener especificaciones detalladas de los puntos finales.

Desarrollo

# Install dependencies npm install # Build npm run build # Run tests npm test # Start in development mode npm run dev

Ejemplos

Consulte el directorio de ejemplos para obtener más ejemplos de uso:

Raspado básico: scrape.ts
Rastreo y mapeo: crawl-and-map.ts

Manejo de errores

El servidor implementa un manejo robusto de errores:

Limitación de velocidad con retroceso exponencial
Reintentos automáticos
Mensajes de error detallados
Registro de depuración

Seguridad

Protección de claves API
Validación de solicitud
Lista de dominios permitidos
Limitación de velocidad
Mensajes de error seguros

Contribuyendo

Consulte CONTRIBUTING.md para conocer las pautas de contribución.

Licencia

Licencia MIT: consulte LICENCIA para obtener más detalles.

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

MCP Server Firecrawl