en es ja ko zh

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Supports using .env files to configure the Firecrawl API key for secure development environments.
Supports outputting scraped content in Markdown format for better readability and structure.
Provides TypeScript interfaces for the API, with examples written in TypeScript for better type safety and developer experience.

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

Un servidor que proporciona capacidades de raspado web y búsqueda inteligente de contenido mediante la API Firecrawl, lo que permite a los agentes de IA extraer datos estructurados de sitios web y realizar búsquedas de contenido.

Related Resources

Reddit Discussion about this server

MCP Server Firecrawl