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

# Introduction

> Recherchez sur le web, scrapez n’importe quelle page et interagissez avec elle — le tout via une seule API.

<div id="get-started">
  ## Pour commencer
</div>

<CardGroup cols={2}>
  <Card title="Obtenez votre clé d'API" icon="key" href="https://www.evocrawl.com/app/api-keys">
    Inscrivez-vous et obtenez votre clé d'API pour commencer à utiliser Evocrawl
  </Card>

  <Card title="Essayez-le dans le Playground" icon="play" href="https://www.evocrawl.com/playground">
    Testez l'API instantanément, sans écrire la moindre ligne de code
  </Card>
</CardGroup>

<div id="use-evocrawl-with-ai-agents-recommended">
  ### Utiliser Evocrawl avec des agents d’IA (recommandé)
</div>

Le skill Evocrawl est le moyen le plus rapide pour les agents de découvrir et d’utiliser Evocrawl. Sans lui, votre agent ne saura pas que Evocrawl est disponible.

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

<Note>
  Redémarrez votre agent après avoir installé la skill. Pour la configuration complète, consultez [Skill + CLI](/fr/sdks/cli).
</Note>

Ou utilisez le [MCP Server](/fr/mcp-server) pour connecter Evocrawl directement à Claude, Cursor, Windsurf, VS Code et à d'autres outils d'IA.

***

<div id="what-can-evocrawl-do">
  ## Que peut faire Evocrawl ?
</div>

<CardGroup cols={3}>
  <Card title="Recherche" icon="magnifying-glass" href="#search">
    Rechercher sur le web et obtenir le contenu complet des pages à partir des résultats
  </Card>

  <Card title="Scrape" icon="file-lines" href="#scrape">
    Extraire le contenu de n’importe quelle URL en markdown, HTML ou JSON structuré
  </Card>

  <Card title="Interact" icon="hand-pointer" href="#interact">
    Continuer à travailler avec n’importe quelle page scrapée — cliquer, remplir des formulaires, extraire du contenu dynamique
  </Card>
</CardGroup>

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

* **Recherche, scraping et interaction** : trois API qui couvrent chaque étape de la collecte fiable de données web.
* **Sortie prête pour les LLM** : Markdown propre, JSON structuré, captures d’écran, et plus encore.
* **Gère les aspects complexes** : proxys, protections anti-bot, rendu JavaScript et contenu dynamique.
* **Fiable** : conçu pour la production, avec une haute disponibilité et des résultats constants.
* **Rapide** : des résultats en quelques secondes, optimisé pour un débit élevé.
* **MCP Server** : connectez Evocrawl à n’importe quel outil d’IA via le [Model Context Protocol](/fr/mcp-server).

***

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

Effectuez une recherche sur le web et obtenez le contenu complet des pages à partir des résultats en un seul appel. Consultez la [documentation de la fonctionnalité de recherche](/fr/features/search) pour toutes les options.

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

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

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

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

  const evocrawl = new Evocrawl({ apiKey: "fc-VOTRE-CLÉ-API" });

  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}
  # Rechercher sur le web
  evocrawl search "evocrawl web scraping" --limit 5 --pretty
  ```
</CodeGroup>

<Accordion title="Réponse">
  Les SDK renverront directement l’objet `data`. cURL renverra la charge utile complète.

  ```json JSON theme={null}
  {
    "success": true,
    "data": {
      "web": [
        {
          "url": "https://www.evocrawl.com/",
          "title": "Evocrawl - L'API de données web pour l'IA",
          "description": "L'API d'exploration, de scraping et de recherche pour l'IA. Conçue pour passer à l'échelle. Evocrawl met l'ensemble du web à la portée des agents et développeurs d'IA.",
          "position": 1
        },
        {
          "url": "https://github.com/superaihuman/evocrawl",
          "title": "mendableai/evocrawl : Transformez des sites entiers en contenus prêts pour les LLM… - GitHub",
          "description": "Evocrawl est un service d'API qui prend une URL, l'explore et la convertit en Markdown propre ou en données structurées.",
          "position": 2
        },
        ...
      ],
      "images": [
        {
          "title": "Guide de démarrage rapide | 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": "La startup de Y Combinator Evocrawl est prête à payer 1 M$ pour embaucher trois agents IA comme employés",
          "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-evocrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/",
          "snippet": "Elle a désormais publié trois nouvelles annonces sur le job board de YC pour « agents IA uniquement » et a réservé un budget total de 1 million de dollars pour y parvenir.",
          "date": "il y a 3 mois",
          "position": 1
        },
        ...
      ]
    }
  }
  ```
</Accordion>

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

Extrayez n’importe quelle URL et obtenez son contenu en markdown, HTML ou d’autres formats. Consultez la [documentation de la fonctionnalité Scrape](/fr/features/scrape) pour toutes les options.

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

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

  # Extraire le contenu d’un 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" });

  // Récupérer le contenu d’un 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

  # Avec plusieurs formats (renvoie du JSON)
  evocrawl https://evocrawl.com --format markdown,html,links --pretty
  ```
</CodeGroup>

<Accordion title="Réponse">
  Les SDK vont renvoyer directement l’objet data. cURL renverra la charge utile exactement comme indiqué ci-dessous.

  ```json theme={null}
  {
    "success": true,
    "data" : {
      "markdown": "Launch Week I est là ! [Découvrez notre sortie du Jour 2 🚀](https://www.evocrawl.com/blog/launch-week-i-day-2-doubled-rate-limits)[💥 2 mois offerts...",
      "html": "<!DOCTYPE html><html lang=\"en\" class=\"light\" style=\"color-scheme: light;\"><body class=\"__variable_36bd41 __variable_d7dc5d font-inter ...",
      "metadata": {
        "title": "Accueil - Evocrawl",
        "description": "Evocrawl explore et convertit n'importe quel site web en markdown propre.",
        "language": "en",
        "keywords": "Evocrawl,Markdown,Données,Mendable,Langchain",
        "robots": "follow, index",
        "ogTitle": "Evocrawl",
        "ogDescription": "Transformez n'importe quel site web en données prêtes pour les 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">
  ## Interact
</div>

Scrapez une page, puis continuez à travailler avec elle — cliquez sur des boutons, remplissez des formulaires, extrayez du contenu dynamique ou naviguez plus en profondeur. Décrivez ce que vous voulez en anglais courant ou écrivez du code pour un contrôle total. Consultez la [documentation de la fonctionnalité Interact](/fr/features/interact) pour toutes les options.

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

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

  # 1. Scraper la page d'accueil d'Amazon
  result = app.scrape("https://www.amazon.com", formats=["markdown"])
  scrape_id = result.metadata.scrape_id

  # 2. Interagir — rechercher un produit et obtenir son prix
  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. Arrêter la session
  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. Scraper la page d'accueil d'Amazon
  const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] });
  const scrapeId = result.metadata?.scrapeId;

  // 2. Interagir — rechercher un produit et obtenir son prix
  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. Arrêter la session
  await app.stopInteraction(scrapeId);
  ```

  ```bash cURL theme={null}
  # 1. Scraper la page d'accueil d'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 — rechercher un produit et obtenir son prix
  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. Arrêter la session
  curl -s -X DELETE "https://api.evocrawl.com/v2/scrape/$SCRAPE_ID/interact" \
    -H "Authorization: Bearer $EVOCRAWL_API_KEY"
  ```

  ```bash CLI theme={null}
  # 1. Scrape la page d'accueil d'Amazon (l'ID de scrape est sauvegardé automatiquement)
  evocrawl scrape https://www.amazon.com

  # 2. Interagir — rechercher un produit et obtenir son prix
  evocrawl interact "Search for iPhone 16 Pro Max"
  evocrawl interact "Click on the first result and tell me the price"

  # 3. Arrêter la session
  evocrawl interact stop
  ```
</CodeGroup>

<Accordion title="Réponse">
  ```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">
  ## Plus de fonctionnalités
</div>

<CardGroup cols={4}>
  <Card title="Agent" icon="robot" href="/fr/features/agent">
    Collecter automatiquement des données web grâce à l’IA
  </Card>

  <Card title="Browser Sandbox" icon="browser" href="/fr/features/browser">
    Gérer des sessions de navigateur pour des workflows interactifs
  </Card>

  <Card title="Map" icon="map" href="/fr/features/map">
    Découvrir toutes les URL d’un site web
  </Card>

  <Card title="Crawl" icon="spider-web" href="/fr/features/crawl">
    Collecter récursivement le contenu de sites entiers
  </Card>
</CardGroup>

***

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

<CardGroup cols={2}>
  <Card title="Référence de l’API" icon="code" href="/fr/api-reference/v2-introduction">
    Documentation complète de l’API avec des exemples interactifs
  </Card>

  <Card title="SDKs" icon="boxes-stacked" href="/fr/sdks/overview">
    SDKs Python, Node.js, CLI et communautaires
  </Card>

  <Card title="Open Source" icon="github" href="/fr/contributing/open-source-or-cloud">
    Hébergez Evocrawl vous-même ou contribuez au projet
  </Card>

  <Card title="Intégrations" icon="puzzle-piece" href="/fr/developer-guides/llm-sdks-and-frameworks/openai">
    LangChain, LlamaIndex, OpenAI et plus encore
  </Card>
</CardGroup>