Servidor Firecrawl de MCP

Este es un servidor MCP simple que proporciona herramientas para rastrear sitios web y extraer datos estructurados utilizando las API de Firecrawl.

Configuración

Instalar dependencias:

npm install

Cree un archivo .env en el directorio raíz con las siguientes variables:

FIRECRAWL_API_TOKEN=your_token_here SENTRY_DSN=your_sentry_dsn_here

FIRECRAWL_API_TOKEN (obligatorio): Su token de API de Firecrawl
SENTRY_DSN (opcional): Sentry DSN para seguimiento de errores y monitoreo del rendimiento

Iniciar el servidor:

npm start

Alternativamente, puede configurar variables de entorno directamente al ejecutar el servidor:

FIRECRAWL_API_TOKEN=your_token_here npm start

Related MCP server: MCP Server Firecrawl

Características

Extracción de sitios web : extraiga contenido de sitios web en varios formatos
Extracción de datos estructurados : extraiga puntos de datos específicos según esquemas personalizados
Seguimiento de errores : integrado con Sentry para el seguimiento de errores y la supervisión del rendimiento

Uso

El servidor expone dos herramientas:

scrape-website : Extracción básica de sitios web con múltiples opciones de formato
extract-data : Extracción de datos estructurados basada en indicaciones y esquemas

Herramienta: scrape-website

Esta herramienta raspa un sitio web y devuelve su contenido en los formatos solicitados.

Parámetros:

url (cadena, obligatoria): la URL del sitio web que se va a rastrear
formats (matriz de cadenas, opcional): Matriz de formatos de salida deseados. Los formatos admitidos son:
- "markdown" (predeterminado)
- "html"
- "text"

Ejemplo de uso con MCP Inspector:

# Basic usage (defaults to markdown) mcp-inspector --tool scrape-website --args '{ "url": "https://example.com" }' # Multiple formats mcp-inspector --tool scrape-website --args '{ "url": "https://example.com", "formats": ["markdown", "html", "text"] }'

Herramienta: extraer datos

Esta herramienta extrae datos estructurados de sitios web basándose en un esquema y una solicitud proporcionados.

Parámetros:

urls (matriz de cadenas, obligatoria): Matriz de URL de las que extraer datos
prompt (cadena, obligatorio): el mensaje que describe qué datos extraer
schema (objeto, requerido): Definición del esquema para los datos a extraer

La definición del esquema debe ser un objeto donde las claves sean nombres de campo y los valores sean tipos. Los tipos admitidos son:

"string" : para campos de texto
"boolean" : para campos verdaderos/falsos
"number" : para campos numéricos
Matrices: se especifican como ["type"] donde el tipo es uno de los anteriores
Objetos: objetos anidados con sus propias definiciones de tipo

Ejemplo de uso con MCP Inspector:

# Basic example extracting company information mcp-inspector --tool extract-data --args '{ "urls": ["https://example.com"], "prompt": "Extract the company mission, whether it supports SSO, and whether it is open source.", "schema": { "company_mission": "string", "supports_sso": "boolean", "is_open_source": "boolean" } }' # Complex example with nested data mcp-inspector --tool extract-data --args '{ "urls": ["https://example.com/products", "https://example.com/pricing"], "prompt": "Extract product information including name, price, and features.", "schema": { "products": [{ "name": "string", "price": "number", "features": ["string"] }] } }'

Ambas herramientas devolverán mensajes de error apropiados si el raspado o la extracción fallan y registrarán automáticamente los errores en Sentry si está configurado.

Solución de problemas

Si encuentra problemas:

Verifique que su token de API de Firecrawl sea válido
Comprueba que las URL que intentas extraer sean accesibles
Para esquemas complejos, asegúrese de que sigan el formato admitido
Revise los registros de Sentry para obtener información detallada de errores (si está configurado)