> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evocrawl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> Faça uma busca na web, faça scraping de qualquer página e interaja com ela — tudo por meio de uma única API.

<div id="get-started">
  ## Primeiros passos
</div>

<CardGroup cols={2}>
  <Card title="Obtenha sua chave de API" icon="key" href="https://www.evocrawl.com/app/api-keys">
    Crie uma conta e obtenha sua chave de API para começar a usar o Evocrawl
  </Card>

  <Card title="Experimente no Playground" icon="play" href="https://www.evocrawl.com/playground">
    Teste a API instantaneamente, sem escrever nenhuma linha de código
  </Card>
</CardGroup>

<div id="use-evocrawl-with-ai-agents-recommended">
  ### Use o Evocrawl com agentes de IA (recomendado)
</div>

A skill do Evocrawl é a forma mais rápida de os agentes descobrirem e usarem o Evocrawl. Sem ela, seu agente não saberá que o Evocrawl está disponível.

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

<Note>
  Reinicie o seu agente após instalar a skill. Consulte [Skill + CLI](/pt-BR/sdks/cli) para o guia completo de configuração.
</Note>

Ou use o [MCP Server](/pt-BR/mcp-server) para conectar o Evocrawl diretamente ao Claude, Cursor, Windsurf, VS Code e a outras ferramentas de IA.

***

<div id="what-can-evocrawl-do">
  ## O que o Evocrawl pode fazer?
</div>

<CardGroup cols={3}>
  <Card title="Search" icon="magnifying-glass" href="#search">
    Faça uma busca na web e obtenha o conteúdo completo da página a partir dos resultados
  </Card>

  <Card title="Scrape" icon="file-lines" href="#scrape">
    Extraia conteúdo de qualquer URL como markdown, HTML ou JSON estruturado
  </Card>

  <Card title="Interact" icon="hand-pointer" href="#interact">
    Continue trabalhando com qualquer página obtida por scraping — clique, preencha formulários e extraia conteúdo dinâmico
  </Card>
</CardGroup>

<div id="why-evocrawl">
  ### Por que Evocrawl?
</div>

* **Busca, scraping e interação**: Três APIs que cobrem todas as etapas da coleta de dados na web de forma confiável.
* **Resultado pronto para LLM**: Markdown limpo, JSON estruturado, capturas de tela e muito mais.
* **Lida com o mais difícil**: Proxies, anti-bot, renderização de JavaScript e conteúdo dinâmico.
* **Confiável**: Projetado para produção, com alta disponibilidade e resultados consistentes.
* **Rápido**: Resultados em segundos, otimizado para alto throughput.
* **MCP Server**: Conecte o Evocrawl a qualquer ferramenta de IA via [Model Context Protocol](/pt-BR/mcp-server).

***

<div id="search">
  ## Busca
</div>

Faça uma busca na web e obtenha o conteúdo completo da página a partir dos resultados em uma única chamada. Consulte a [documentação do recurso de busca](/pt-BR/features/search) para ver todas as opções.

<CodeGroup>
  ```python Python theme={null}
  from evocrawl import Evocrawl

  evocrawl = Evocrawl(api_key="fc-SUA-API-KEY")

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

  ```js Node theme={null}
  import Evocrawl from '@mendable/evocrawl-js';

  const evocrawl = new Evocrawl({ apiKey: "fc-SUA-API-KEY" });

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

  ```bash cURL theme={null}
  curl -s -X POST "https://api.evocrawl.com/v2/search" \
    -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "query": "evocrawl",
      "limit": 3
    }'
  ```

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

<Accordion title="Resposta">
  Os SDKs retornarão diretamente o objeto de dados. O cURL retornará o payload completo.

  ```json JSON theme={null}
  {
    "success": true,
    "data": {
      "web": [
        {
          "url": "https://www.evocrawl.com/",
          "title": "Evocrawl - The Web Data API for AI",
          "description": "The web crawling, scraping, and search API for AI. Built for scale. Evocrawl delivers the entire internet to AI agents and builders.",
          "position": 1
        },
        {
          "url": "https://github.com/superaihuman/evocrawl",
          "title": "mendableai/evocrawl: Turn entire websites into LLM-ready ... - GitHub",
          "description": "Evocrawl is an API service that takes a URL, crawls it, and converts it into clean markdown or structured data.",
          "position": 2
        },
        ...
      ],
      "images": [
        {
          "title": "Quickstart | Evocrawl",
          "imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/evocrawl/logo/logo.png",
          "imageWidth": 5814,
          "imageHeight": 1200,
          "url": "https://docs.evocrawl.com/",
          "position": 1
        },
        ...
      ],
      "news": [
        {
          "title": "Y Combinator startup Evocrawl is ready to pay $1M to hire three AI agents as employees",
          "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-evocrawl-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>

Faça scraping de qualquer URL e obtenha seu conteúdo em markdown, HTML ou outros formatos. Veja a [documentação do recurso de scraping](/pt-BR/features/scrape) para ver todas as opções.

<CodeGroup>
  ```python Python theme={null}
  from evocrawl import Evocrawl

  evocrawl = Evocrawl(api_key="fc-YOUR-API-KEY")

  # Raspar um site:
  doc = evocrawl.scrape("https://evocrawl.com", formats=["markdown", "html"])
  print(doc)
  ```

  ```js Node theme={null}
  import Evocrawl from '@mendable/evocrawl-js';

  const evocrawl = new Evocrawl({ apiKey: "fc-YOUR-API-KEY" });

  // Fazer a raspagem de um site:
  const doc = await evocrawl.scrape('https://evocrawl.com', { formats: ['markdown', 'html'] });
  console.log(doc);
  ```

  ```bash cURL theme={null}
  curl -s -X POST "https://api.evocrawl.com/v2/scrape" \
    -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://evocrawl.com",
      "formats": ["markdown", "html"]
    }'
  ```

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

  # Com múltiplos formatos (retorna JSON)
  evocrawl https://evocrawl.com --format markdown,html,links --pretty
  ```
</CodeGroup>

<Accordion title="Resposta">
  Os SDKs retornarão o objeto de dados diretamente. O cURL retornará o payload exatamente como mostrado abaixo.

  ```json theme={null}
  {
    "success": true,
    "data" : {
      "markdown": "A Launch Week I chegou! [Confira nosso lançamento do Dia 2 🚀](https://www.evocrawl.com/blog/launch-week-i-day-2-doubled-rate-limits)[💥 Ganhe 2 meses grátis...",
      "html": "<!DOCTYPE html><html lang=\"en\" class=\"light\" style=\"color-scheme: light;\"><body class=\"__variable_36bd41 __variable_d7dc5d font-inter ...",
      "metadata": {
        "title": "Home - Evocrawl",
        "description": "O Evocrawl rastreia e converte qualquer site em markdown limpo.",
        "language": "en",
        "keywords": "Evocrawl,Markdown,Dados,Mendable,Langchain",
        "robots": "follow, index",
        "ogTitle": "Evocrawl",
        "ogDescription": "Transforme qualquer site em dados prontos para LLM.",
        "ogUrl": "https://www.evocrawl.com/",
        "ogImage": "https://www.evocrawl.com/og.png?123",
        "ogLocaleAlternate": [],
        "ogSiteName": "Evocrawl",
        "sourceURL": "https://evocrawl.com",
        "statusCode": 200,
        "contentType": "text/html"
      }
    }
  }
  ```
</Accordion>

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

Faça o scraping de uma página e depois continue trabalhando com ela — clique em botões, preencha formulários, extraia conteúdo dinâmico ou navegue mais a fundo. Descreva o que você quer em inglês simples ou escreva código para ter controle total. Consulte a [documentação do recurso Interact](/pt-BR/features/interact) para ver todas as opções.

<CodeGroup>
  ```python Python theme={null}
  from evocrawl import Evocrawl

  app = Evocrawl(api_key="fc-YOUR-API-KEY")

  # 1. Fazer scraping da página inicial da Amazon
  result = app.scrape("https://www.amazon.com", formats=["markdown"])
  scrape_id = result.metadata.scrape_id

  # 2. Interagir — buscar um produto e obter seu preço
  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. Encerrar a sessão
  app.stop_interaction(scrape_id)
  ```

  ```js Node theme={null}
  import Evocrawl from '@mendable/evocrawl-js';

  const app = new Evocrawl({ apiKey: 'fc-YOUR-API-KEY' });

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

  // 2. Interagir — buscar um produto e obter seu preço
  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. Encerrar a sessão
  await app.stopInteraction(scrapeId);
  ```

  ```bash cURL theme={null}
  # 1. Fazer scraping da página inicial da Amazon
  RESPONSE=$(curl -s -X POST "https://api.evocrawl.com/v2/scrape" \
    -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://www.amazon.com", "formats": ["markdown"]}')

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

  # 2. Interagir — buscar um produto e obter seu preço
  curl -s -X POST "https://api.evocrawl.com/v2/scrape/$SCRAPE_ID/interact" \
    -H "Authorization: Bearer $EVOCRAWL_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"prompt": "Search for iPhone 16 Pro Max"}'

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

  # 3. Encerrar a sessão
  curl -s -X DELETE "https://api.evocrawl.com/v2/scrape/$SCRAPE_ID/interact" \
    -H "Authorization: Bearer $EVOCRAWL_API_KEY"
  ```

  ```bash CLI theme={null}
  # 1. Faça scraping da página inicial da Amazon (o ID de scraping é salvo automaticamente)
  evocrawl scrape https://www.amazon.com

  # 2. Interaja — busque um produto e obtenha seu preço
  evocrawl interact "Search for iPhone 16 Pro Max"
  evocrawl interact "Click on the first result and tell me the price"

  # 3. Encerre a sessão
  evocrawl interact stop
  ```
</CodeGroup>

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

***

<div id="more-capabilities">
  ## Mais recursos
</div>

<CardGroup cols={4}>
  <Card title="Agent" icon="robot" href="/pt-BR/features/agent">
    Coleta autônoma de dados da web com IA
  </Card>

  <Card title="Browser Sandbox" icon="browser" href="/pt-BR/features/browser">
    Sessões de navegador gerenciadas para fluxos de trabalho interativos
  </Card>

  <Card title="Map" icon="map" href="/pt-BR/features/map">
    Descubra todas as URLs de um site
  </Card>

  <Card title="Crawl" icon="spider-web" href="/pt-BR/features/crawl">
    Colete conteúdo de sites inteiros de forma recursiva
  </Card>
</CardGroup>

***

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

<CardGroup cols={2}>
  <Card title="Referência da API" icon="code" href="/pt-BR/api-reference/v2-introduction">
    Documentação completa da API com exemplos interativos
  </Card>

  <Card title="SDKs" icon="boxes-stacked" href="/pt-BR/sdks/overview">
    SDKs para Python, Node.js, CLI e da comunidade
  </Card>

  <Card title="Open Source" icon="github" href="/pt-BR/contributing/open-source-or-cloud">
    Hospede o Evocrawl na sua própria infraestrutura ou contribua com o projeto
  </Card>

  <Card title="Integrações" icon="puzzle-piece" href="/pt-BR/developer-guides/llm-sdks-and-frameworks/openai">
    LangChain, LlamaIndex, OpenAI e mais
  </Card>
</CardGroup>