Firecrawl CLI: añadir extracción y búsqueda a los agentes en la terminal

Para quién

Esta guía es para quien necesita, desde una terminal local, búsqueda web, extracción de páginas, interacción, rastreo de sitios, sitemaps o ejecutar tareas de agente. Oficialmente se presenta a la vez como entrada de línea de comandos y como habilidad de agente que se puede instalar en los editores de código detectados.

Si su trabajo es leer primero páginas públicas y luego decidir si cambiar el código —en lugar de construir usted un servicio de extracción—, este camino encaja mejor. Las notas oficiales también mencionan buscar artículos y material para desarrolladores. No sirve para quien solo quiere unos clics en una interfaz gráfica y no puede ejecutar comandos de terminal: la ruta recomendada instala una herramienta CLI, completa el inicio de sesión y escribe habilidades en los editores detectados.

El repositorio oficial es

https://github.com/firecrawl/cli

Siga solo la redacción actual de esa página. No cambie a un instalador o directorio de habilidades que no aparezca allí.

Primer intento en 3 minutos

Siga solo la ruta oficial recomendada.

Requisitos: la terminal puede ejecutar npx y ya tiene un método de acceso a Firecrawl. Las notas oficiales también permiten definir la variable de entorno FIRECRAWL_API_KEY; init con --browser usa el inicio de sesión en el navegador. Antes de ejecutar, confirme que iniciará sesión con su propia cuenta y observe que, por defecto, se escribe en todos los editores de código detectados, no en un directorio temporal.

Ubicación de instalación: las habilidades se instalan por defecto de forma global en los editores detectados. Para apuntar a uno solo, la forma oficial añade --agent <agent>.

Copie y ejecute:

npx -y firecrawl-cli@latest init -y --browser

Señal de éxito: el comando termina con normalidad, esta máquina puede invocar firecrawl y los editores detectados muestran una habilidad nueva. Aún no rastree un sitio entero. A continuación, haga una comprobación reversible: ejecute firecrawl setup core. Las notas oficiales indican que este grupo aporta las primitivas scrape, search, crawl e interact, más habilidades de índice; skills es su alias. Cuando el comando se acepte, pida al agente instalado una solicitud de solo lectura, por ejemplo «Usa Firecrawl para buscar el título de un documento público, muestra solo los resultados y no escribas archivos». Ver los resultados significa que se encontró la habilidad.

Cuando necesite habilidades de integración de aplicaciones que hablen con la API de Firecrawl, ejecute entonces firecrawl setup build. Cuando necesite recetas de extremo a extremo como generación de pistas o investigación profunda, ejecute entonces firecrawl setup workflows. La primera vez instale solo core para no escribir todas las recetas de una vez.

Ejemplos de uso

Ejemplo 1: añadir primitivas de búsqueda y extracción al agente actual. La acción oficial es firecrawl setup core, que instala las primitivas scrape, search, crawl e interact más las habilidades de índice. Encaja si ya trabaja en un editor detectado y quiere que el agente busque o extraiga páginas públicas antes de decidir si cambiar el repositorio. Termine primero el init de arriba y luego instale solo core. Si tiene éxito, una conversación debería disparar una búsqueda o extracción y mostrar un resumen de resultados. El material oficial no da una ruta de carpeta de habilidades; no invente un directorio que nunca aparece.

Ejemplo 2: necesita recetas listas en lugar de primitivas sueltas. La acción oficial es firecrawl setup workflows; el material cita generación de pistas e investigación profunda. Encaja cuando core ya funciona y ahora quiere investigar por recetas. Confirme que init tuvo éxito y luego ejecute ese comando; para instalar en un solo editor, añada --agent <agent>. La señal de éxito es que ese grupo de habilidades aparece en el editor de destino. Los pasos internos de las recetas no están desarrollados; el material existente solo confirma que workflows está instalado y no se pueden completar subpasos no escritos.

Límites

El material existente se detiene en comandos de terminal, inicio de sesión en el navegador o FIRECRAWL_API_KEY, y en los tres grupos de instalación core, build y workflows. No exige un idioma obligatorio ni convierte «editores detectados» en una lista exclusiva; no infiera del alcance de instalación por defecto que solo funcionan unos pocos clientes.

No aplique este init de npx a un entorno que solo permite copiar a mano archivos de habilidades y no tiene una línea de comandos general. El material tampoco da una dirección de mercado secundario ni un secreto de ejemplo.

init y setup escriben habilidades en los editores detectados y tienen efectos secundarios. Confirme primero el editor de destino; después de ejecutar, compruebe solo si aparecieron las habilidades: no rastree de inmediato un sitio no autorizado. Extracción, interacción y rastreo alcanzan sitios externos; verifique primero con una página pública que pueda volver a abrir.

FIRECRAWL_API_KEY es un nombre de variable de entorno, no un secreto de ejemplo para pegar en el texto. No invente subcomandos, nombres de habilidades ni rutas de instalación que nunca aparecen. Para más detalle, siga el repositorio oficial:

https://github.com/firecrawl/cli