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
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
set FIRECRAWL_API_KEY=your-api-key
$env:FIRECRAWL_API_KEY = "your-api-key"
# Install dotenv
npm install dotenv
# Create .env file
echo "FIRECRAWL_API_KEY=your-api-key" > .env
import dotenv from 'dotenv';
dotenv.config();
- Ejecutar el servidor:
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
}
}
// 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:
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.