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

1. Obtén tu clave API de Firecrawl desde el portal para desarrolladores

2. 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();

3. 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.