> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-docs-agent-add-spark-2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Busca en la web, haz scraping de cualquier página e interactúa con ella, todo desde una sola API.

export const AgentSetupButton = () => {
  const prompt = "Read and follow https://www.firecrawl.dev/agent-onboarding/SKILL.md";
  const writeClipboard = async text => {
    try {
      await navigator.clipboard.writeText(text);
      return true;
    } catch {
      const textarea = document.createElement("textarea");
      textarea.value = text;
      textarea.setAttribute("readonly", "");
      textarea.style.position = "fixed";
      textarea.style.top = "-9999px";
      document.body.appendChild(textarea);
      textarea.select();
      let copied = false;
      try {
        copied = document.execCommand("copy");
      } catch {
        copied = false;
      }
      document.body.removeChild(textarea);
      return copied;
    }
  };
  const [copied, setCopied] = useState(false);
  const [status, setStatus] = useState("");
  const timeoutRef = useRef(null);
  useEffect(() => () => window.clearTimeout(timeoutRef.current), []);
  const copyPrompt = async () => {
    const copied = await writeClipboard(prompt);
    if (copied) {
      window.clearTimeout(timeoutRef.current);
      setCopied(true);
      setStatus("Agent setup prompt copied to clipboard.");
      timeoutRef.current = window.setTimeout(() => {
        setCopied(false);
        setStatus("");
      }, 2000);
    } else {
      setCopied(false);
      setStatus("Could not copy the agent setup prompt.");
    }
  };
  const icon = copied ? <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
      <path d="m20 6-11 11-5-5" />
    </svg> : <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
      <rect width="14" height="14" x="8" y="8" rx="2" />
      <path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2" />
    </svg>;
  return <div className="fc-agent-prompt not-prose">
      <button type="button" className={`fc-agent-prompt-button${copied ? " is-copied" : ""}`} onClick={copyPrompt} aria-label={copied ? "Copied agent setup prompt" : "Setup for agents"}>
        {icon}
        <span>{copied ? "Copied" : "Setup for agents"}</span>
      </button>
      <span className="fc-sr-only" aria-live="polite">
        {status}
      </span>
    </div>;
};

<div id="get-started">
  ## Primeros pasos
</div>

Conéctate a través de Streamable HTTP. La URL del servidor sin clave (Búsqueda, scraping y procesar; no requiere credenciales) es `https://mcp.firecrawl.dev/v2/mcp`.

* Codex: `codex mcp add firecrawl --url https://mcp.firecrawl.dev/v2/mcp`
* Claude Code: `claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp`
* Cursor o cualquier cliente con configuración JSON: `{"mcpServers": {"firecrawl": {"url": "https://mcp.firecrawl.dev/v2/mcp"}}}`
* OpenCode (`opencode.json`): `{"mcp": {"firecrawl": {"type": "remote", "url": "https://mcp.firecrawl.dev/v2/mcp", "enabled": true}}}`
* ChatGPT o Claude.ai: usa el conector nativo de Firecrawl — [ChatGPT](https://chatgpt.com/plugins?q=firecrawl) o [Claude](https://claude.ai/directory/connectors/firecrawl).

Ambas rutas de configuración y la configuración de la clave de API: [Primeros pasos con MCP](/es/mcp-server.md), [Para agentes](/es/mcp-server/keyless.md) y [Para personas](/es/mcp-server/oauth.md).

<div id="build-directly-with-the-api">
  ### Crea directamente con la API
</div>

Haz scraping de tu primera página. No necesitas una cuenta ni una clave de API para esta solicitud.

```bash cURL theme={null}
# No se necesita API key para comenzar — agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para límites de tasa más altos:
curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://firecrawl.dev",
    "formats": ["markdown", "html"]
  }'
```

Añade una [clave de API](https://www.firecrawl.dev/app/api-keys) cuando necesites límites más altos. Consulta el [Python SDK](/es/sdks/python), el [Node SDK](/es/sdks/node) o la [referencia de la API](/es/api-reference/endpoint/scrape) para integrarlo en tu aplicación.

<div id="other-ways-to-get-started">
  ## Otras formas de empezar
</div>

<div id="install-the-firecrawl-cli">
  ### Instala la CLI de Firecrawl
</div>

Un solo comando instala la CLI de Firecrawl, autentica en tu navegador y añade skills a todos los agentes de programación detectados.

```bash theme={null}
npx -y firecrawl-cli@latest init --all --browser
```

<Note>
  Reinicia tu agente de programación después de la configuración para que pueda descubrir las nuevas skills. Consulta
  [CLI](/es/sdks/cli) para ver la configuración completa.
</Note>

<div id="set-up-with-an-agent">
  ### Configúralo con un agente
</div>

Dale a tu agente este prompt de configuración de Firecrawl o consulta [todas las opciones de configuración de MCP](/es/mcp-server).

<AgentSetupButton />

<Note>
  **Para agentes de IA:** Usa [llms.txt](https://docs.firecrawl.dev/llms.txt) para obtener un índice de la documentación o [llms-full.txt](https://docs.firecrawl.dev/llms-full.txt) para el texto completo.
</Note>

<div id="build-and-test-directly">
  ### Desarrolla y prueba directamente
</div>

<CardGroup cols={2}>
  <Card title="Obtén tu clave de API" icon="key" href="https://www.firecrawl.dev/app/api-keys">
    Crea una cuenta gratuita para acceder directamente a la API y obtener límites más altos
  </Card>

  <Card title="Pruébalo en el Playground" icon="play" href="https://www.firecrawl.dev/playground">
    Prueba Firecrawl en el navegador sin escribir código
  </Card>
</CardGroup>

***

<div id="what-can-firecrawl-do">
  ## ¿Qué puede hacer Firecrawl?
</div>

<CardGroup cols={3}>
  <Card title="Búsqueda" icon="magnifying-glass" href="#search">
    Buscar en la web y obtener el contenido completo de la página de los resultados
  </Card>

  <Card title="Scraping" icon="file-lines" href="#scrape">
    Extraer contenido de cualquier URL como markdown, HTML o JSON estructurado
  </Card>

  <Card title="Interact" icon="hand-pointer" href="#interact">
    Seguir trabajando con cualquier página obtenida mediante scraping: hacer clic, rellenar formularios y extraer contenido dinámico
  </Card>
</CardGroup>

<div id="why-firecrawl">
  ### ¿Por qué Firecrawl?
</div>

* **Salida lista para LLM**: Markdown limpio, JSON estructurado, capturas de pantalla y más.
* **Se encarga de lo difícil**: Proxies, protección anti-bots, renderizado de JavaScript y contenido dinámico.
* **Fiable**: Diseñado para producción, con alta disponibilidad y resultados consistentes.
* **Rápido**: Resultados en segundos, optimizado para un alto rendimiento.
* **MCP Server**: Conecta Firecrawl a cualquier herramienta de IA mediante [Model Context Protocol](/es/mcp-server).

<div className="firecrawl-cta-box">
  <div style={{ display: "flex", alignItems: "flex-start", gap: "8px", marginBottom: "8px" }}>
    <Icon icon="sack-dollar" color="#ff4d00" size={22} />

    <div className="firecrawl-cta-title" style={{ margin: 0 }}>
      <span style={{ color: "#ff4d00" }}>Recompensa: 5000 créditos</span>
      <span style={{ fontWeight: 400 }}> por comentarios de calidad sobre Firecrawl</span>
    </div>
  </div>

  <p className="firecrawl-cta-description">
    Para optar a ella, completa una entrevista con información relevante (casos de uso concretos y bien pensados, etc.) con nuestro Asistente de feedback de Firecrawl. Solo toma unos minutos, puedes detenerla en cualquier momento y es apta tanto para personas como para agentes (¡solo pega el enlace en tu entorno de agentes!). ¿Eres nuevo en Firecrawl? Tu opinión también cuenta.
  </p>

  <a href={"https://www.firecrawl.dev/survey/dsag9?src=" + (props.src || "docs-introduction")} className="firecrawl-cta-btn-primary firecrawl-cta-btn-inline">
    Iniciar la entrevista
  </a>

  <p className="firecrawl-cta-description" style={{ fontSize: "12px", fontStyle: "italic", margin: "12px 0 0 0" }}>
    Incluye tu correo electrónico para poder optar a ella. La calidad de las entrevistas se revisa al final de cada semana.
  </p>
</div>

***

<div id="search">
  ## Búsqueda
</div>

Buscar en la web y obtener el contenido completo de la página de los resultados en una sola llamada. Consulta la [documentación de la función Search](/es/features/search) para ver todas las opción.

<CodeGroup>
  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(
    # No se necesita API key para comenzar — agrega una para límites de tasa más altos:
    # api_key="fc-YOUR-API-KEY",
  )

  results = firecrawl.search(
      query="firecrawl",
      limit=3,
  )
  print(results)
  ```

  ```js Node theme={null}
  import { Firecrawl } from 'firecrawl';

  const firecrawl = new Firecrawl({
    // No se necesita API key para comenzar — agrega una para obtener límites de tasa más altos:
    // apiKey: "fc-YOUR-API-KEY",
  });

  const results = await firecrawl.search('firecrawl', {
    limit: 3,
    scrapeOptions: { formats: ['markdown'] }
  });
  console.log(results);
  ```

  ```bash cURL theme={null}
  # No se necesita API key para comenzar — agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para límites de tasa más altos:
  curl -s -X POST "https://api.firecrawl.dev/v2/search" \
    -H "Content-Type: application/json" \
    -d '{
      "query": "firecrawl",
      "limit": 3
    }'
  ```

  ```bash CLI theme={null}
  # Buscar en la web
  firecrawl search "firecrawl web scraping" --limit 5 --pretty
  ```
</CodeGroup>

<Accordion title="Respuesta">
  Los SDK devolverán el objeto de datos directamente. cURL devolverá la carga útil completa.

  ```json JSON theme={null}
  {
    "success": true,
    "data": {
      "web": [
        {
          "url": "https://www.firecrawl.dev/",
          "title": "Firecrawl - The Web Data API for AI",
          "description": "The web crawling, scraping, and search API for AI. Built for scale. Firecrawl delivers the entire internet to AI agents and builders.",
          "position": 1
        },
        {
          "url": "https://github.com/firecrawl/firecrawl",
          "title": "mendableai/firecrawl: Turn entire websites into LLM-ready ... - GitHub",
          "description": "Firecrawl is an API service that takes a URL, crawls it, and converts it into clean markdown or structured data.",
          "position": 2
        },
        ...
      ],
      "images": [
        {
          "title": "Quickstart | Firecrawl",
          "imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/logo/logo.png",
          "imageWidth": 5814,
          "imageHeight": 1200,
          "url": "https://docs.firecrawl.dev/",
          "position": 1
        },
        ...
      ],
      "news": [
        {
          "title": "Y Combinator startup Firecrawl is ready to pay $1M to hire three AI agents as employees",
          "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-firecrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/",
          "snippet": "It's now placed three new ads on YC's job board for “AI agents only” and has set aside a $1 million budget total to make it happen.",
          "date": "3 months ago",
          "position": 1
        },
        ...
      ]
    }
  }
  ```
</Accordion>

<div id="scrape">
  ## Scraping
</div>

Haz scraping de cualquier URL y obtén su contenido en markdown, HTML u otros formatos. Consulta la [documentación de la función Scraping](/es/features/scrape) para ver todas las opciones.

<CodeGroup>
  ```python Python theme={null}
  from firecrawl import Firecrawl

  firecrawl = Firecrawl(
    # No se necesita API key para comenzar — añade una para obtener límites de tasa más altos:
    # api_key="fc-YOUR-API-KEY",
  )

  # Extraer datos de un sitio web:
  doc = firecrawl.scrape("https://firecrawl.dev", formats=["markdown", "html"])
  print(doc)
  ```

  ```js Node theme={null}
  import { Firecrawl } from 'firecrawl';

  const firecrawl = new Firecrawl({
    // No se necesita API key para comenzar — agrega una para límites de tasa más altos:
    // apiKey: "fc-YOUR-API-KEY",
  });

  // Extraer un sitio web:
  const doc = await firecrawl.scrape('https://firecrawl.dev', { formats: ['markdown', 'html'] });
  console.log(doc);
  ```

  ```bash cURL theme={null}
  # No se necesita API key para comenzar — agrega -H "Authorization: Bearer $FIRECRAWL_API_KEY" para límites de tasa más altos:
  curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://firecrawl.dev",
      "formats": ["markdown", "html"]
    }'
  ```

  ```bash CLI theme={null}
  # Scrape a URL and get markdown
  firecrawl https://firecrawl.dev

  # Con múltiples formatos (devuelve JSON)
  firecrawl https://firecrawl.dev --format markdown,html,links --pretty
  ```
</CodeGroup>

<Accordion title="Respuesta">
  Los SDK devolverán el objeto de datos directamente. cURL devolverá la carga útil exactamente como se muestra a continuación.

  ```json theme={null}
  {
    "success": true,
    "data" : {
      "markdown": "¡Launch Week I ya está aquí! [Consulta nuestro lanzamiento del Día 2 🚀](https://www.firecrawl.dev/blog/launch-week-i-day-2-doubled-rate-limits)[💥 Obtén 2 meses gratis...",
      "html": "<!DOCTYPE html><html lang=\"en\" class=\"light\" style=\"color-scheme: light;\"><body class=\"__variable_36bd41 __variable_d7dc5d font-inter ...",
      "metadata": {
        "title": "Inicio - Firecrawl",
        "description": "Firecrawl rastrea y convierte cualquier sitio web en Markdown limpio.",
        "language": "en",
        "keywords": "Firecrawl,Markdown,Data,Mendable,Langchain",
        "robots": "seguir, indexar",
        "ogTitle": "Firecrawl",
        "ogDescription": "Convierte cualquier sitio web en datos listos para LLM.",
        "ogUrl": "https://www.firecrawl.dev/",
        "ogImage": "https://www.firecrawl.dev/og.png?123",
        "ogLocaleAlternate": [],
        "ogSiteName": "Firecrawl",
        "sourceURL": "https://firecrawl.dev",
        "statusCode": 200,
        "contentType": "text/html"
      }
    }
  }
  ```
</Accordion>

<div id="interact">
  ## Interact
</div>

Haz scraping de una página y luego sigue trabajando con ella: haz clic en botones, completa formularios, extrae contenido dinámico o navega más en profundidad. Describe lo que quieres en inglés sencillo o escribe código para tener control total. Consulta la [documentación de la función Interact](/es/features/interact) para ver todas las opciones.

<CodeGroup>
  ```python Python theme={null}
  from firecrawl import Firecrawl

  app = Firecrawl(
    # No se necesita API key para comenzar — añade una para límites de tasa más altos:
    # api_key="fc-YOUR-API-KEY",
  )

  # 1. Extraer la página principal de Amazon
  result = app.scrape("https://www.amazon.com", formats=["markdown"])
  scrape_id = result.metadata.scrape_id

  # 2. Interactuar — buscar un producto y obtener su precio
  app.interact(scrape_id, prompt="Search for iPhone 16 Pro Max")
  response = app.interact(scrape_id, prompt="Click on the first result and tell me the price")
  print(response.output)

  # 3. Detener la sesión
  app.stop_interaction(scrape_id)
  ```

  ```js Node theme={null}
  import { Firecrawl } from 'firecrawl';

  const app = new Firecrawl({
    // No se necesita API key para comenzar — agrega una para límites de tasa más altos:
    // apiKey: 'fc-YOUR-API-KEY',
  });

  // 1. Extraer la página principal de Amazon
  const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] });
  const scrapeId = result.metadata?.scrapeId;

  // 2. Interactuar — buscar un producto y obtener su precio
  await app.interact(scrapeId, { prompt: 'Search for iPhone 16 Pro Max' });
  const response = await app.interact(scrapeId, { prompt: 'Click on the first result and tell me the price' });
  console.log(response.output);

  // 3. Detener la sesión
  await app.stopInteraction(scrapeId);
  ```

  ```bash cURL theme={null}
  # 1. Extraer la página principal de Amazon
  # No se necesita API key para comenzar — añade -H "Authorization: Bearer $FIRECRAWL_API_KEY" para límites de tasa más altos:
  RESPONSE=$(curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://www.amazon.com", "formats": ["markdown"]}')

  SCRAPE_ID=$(echo $RESPONSE | jq -r '.data.metadata.scrapeId')

  # 2. Interactuar — buscar un producto y obtener su precio
  curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \
    -H "Content-Type: application/json" \
    -d '{"prompt": "Search for iPhone 16 Pro Max"}'

  curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \
    -H "Content-Type: application/json" \
    -d '{"prompt": "Click on the first result and tell me the price"}'

  # 3. Detener la sesión
  curl -s -X DELETE "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact"
  ```

  ```bash CLI theme={null}
  # 1. Scrape la página principal de Amazon (el ID de scrape se guarda automáticamente)
  firecrawl scrape https://www.amazon.com

  # 2. Interactúa — busca un producto y obtén su precio
  firecrawl interact "Search for iPhone 16 Pro Max"
  firecrawl interact "Click on the first result and tell me the price"

  # 3. Detén la sesión
  firecrawl interact stop
  ```
</CodeGroup>

<Accordion title="Respuesta">
  ```json Response theme={null}
  {
    "success": true,
    "cdpUrl": "wss://browser.firecrawl.dev/...",
    "liveViewUrl": "https://liveview.firecrawl.dev/...",
    "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",
    "output": "The iPhone 16 Pro Max (256GB) is priced at $1,199.00.",
    "exitCode": 0,
    "killed": false
  }
  ```
</Accordion>

***

<div id="more-capabilities">
  ## Más capacidades
</div>

<CardGroup cols={2}>
  <Card title="Agente" icon="robot" href="/es/features/agent">
    Recopilación autónoma de datos web impulsada por IA
  </Card>

  <Card title="Interact" icon="hand-pointer" href="/es/features/interact">
    Haz clic, completa formularios y extrae contenido dinámico
  </Card>

  <Card title="Webhooks" icon="webhook" href="/es/webhooks">
    Entrega asíncrona de eventos
  </Card>

  <Card title="Browser Sandbox" icon="browser" href="/es/features/browser">
    Sesiones de navegador administradas para flujos de trabajo interactivos
  </Card>

  <Card title="Procesar" icon="file-magnifying-glass" href="/es/features/parse">
    Convierte archivos PDF, DOCX, XLSX, HTML locales y más en Markdown o JSON estructurado
  </Card>

  <Card title="Mapeo" icon="map" href="/es/features/map">
    Descubre todas las URL de un sitio web
  </Card>

  <Card title="Crawl" icon="spider-web" href="/es/features/crawl">
    Recopila contenido de sitios completos de forma recursiva
  </Card>
</CardGroup>

***

<div id="resources">
  ## Recursos
</div>

<CardGroup cols={2}>
  <Card title="Referencia de la API" icon="code" href="/es/api-reference/v2-introduction">
    Documentación completa de la API con ejemplos interactivos
  </Card>

  <Card title="SDKs" icon="boxes-stacked" href="/es/sdks/overview">
    SDKs para Python, Node.js, CLI y de la comunidad
  </Card>

  <Card title="Código abierto" icon="github" href="/es/contributing/open-source-or-cloud">
    Aloja Firecrawl tú mismo o contribuye al proyecto
  </Card>

  <Card title="Integraciones" icon="puzzle-piece" href="/es/developer-guides/llm-sdks-and-frameworks/openai">
    LangChain, LlamaIndex, OpenAI y más
  </Card>
</CardGroup>