` | Code de pays ISO (par défaut : US) |
| `--timeout ` | Délai d'expiration en millisecondes (par défaut : 60000) |
| `--ignore-invalid-urls` | Exclure les URL invalides pour d'autres endpoints Evocrawl |
| `--scrape` | Scraper les résultats de recherche |
| `--scrape-formats ` | Formats pour le contenu extrait (par défaut : markdown) |
| `--only-main-content` | Inclure uniquement le contenu principal lors du scraping (par défaut : true) |
| `--json` | Résultat au format JSON |
| `--output ` | Enregistrer le résultat dans un fichier |
| `--pretty` | Affichage JSON formaté |
***
### Map
Découvrez rapidement toutes les URL d’un site.
```bash CLI theme={null} theme={null}
# Découvrir toutes les URL d'un site web
evocrawl map https://example.com
# Output as JSON
evocrawl map https://example.com --json
# Limit number of URLs
evocrawl map https://example.com --limit 500
```
#### Options de la commande Map
```bash CLI theme={null} theme={null}
# Filter URLs by search query
evocrawl map https://example.com --search "blog"
# Include subdomains
evocrawl map https://example.com --include-subdomains
# Contrôler l'utilisation du sitemap
evocrawl map https://example.com --sitemap include # Utiliser le sitemap
evocrawl map https://example.com --sitemap skip # Ignorer le sitemap
evocrawl map https://example.com --sitemap only # Utiliser uniquement le sitemap
# Ignore query parameters (dedupe URLs)
evocrawl map https://example.com --ignore-query-parameters
# Wait for map to complete with timeout
evocrawl map https://example.com --wait --timeout 60
# Save to file
evocrawl map https://example.com -o urls.txt
evocrawl map https://example.com --json --pretty -o urls.json
```
**Options disponibles :**
| Option | Description |
| --------------------------- | ------------------------------------------------------------------ |
| `--url ` | URL à cartographier (alternative à l’argument positionnel) |
| `--limit ` | Nombre maximal d’URL à découvrir |
| `--search ` | Filtrer les URL selon une requête de recherche |
| `--sitemap ` | Gestion du sitemap : `include`, `skip`, `only` |
| `--include-subdomains` | Inclure les sous-domaines |
| `--ignore-query-parameters` | Considérer les URL avec des paramètres différents comme identiques |
| `--wait` | Attendre la fin de l’opération de cartographie |
| `--timeout ` | Délai d’expiration en secondes |
| `--json` | Résultat au format JSON |
| `--output ` | Enregistrer le résultat dans un fichier |
| `--pretty` | Affichage JSON mis en forme |
***
### Navigateur
Permettez à vos agents d’interagir avec le web à l’aide d’un navigateur en bac à sable sécurisé.
Lancez des sessions de navigateur dans le cloud et exécutez du code Python, JavaScript ou bash à distance. Chaque session exécute une instance complète de Chromium — aucune installation de navigateur en local n’est requise. Le code s’exécute côté serveur avec un objet `page` [Playwright](https://playwright.dev/) préconfiguré et prêt à l’emploi.
```bash CLI theme={null} theme={null}
# Launch a cloud browser session
evocrawl browser launch-session
# Exécuter des commandes agent-browser (par défaut - "agent-browser" est automatiquement préfixé)
evocrawl browser execute "open https://example.com"
evocrawl browser execute "snapshot"
evocrawl browser execute "click @e5"
evocrawl browser execute "scrape"
# Execute Playwright Python code
evocrawl browser execute --python 'await page.goto("https://example.com")
print(await page.title())'
# Execute Playwright JavaScript code
evocrawl browser execute --node 'await page.goto("https://example.com"); console.log(await page.title());'
# List all sessions (or: list active / list destroyed)
evocrawl browser list
# Close the active session
evocrawl browser close
```
#### Options du navigateur
```bash CLI theme={null} theme={null}
# Launch with custom TTL (10 minutes) and live view
evocrawl browser launch-session --ttl 600 --stream
# Launch with inactivity timeout
evocrawl browser launch-session --ttl 120 --ttl-inactivity 60
# Commandes agent-browser (par défaut - "agent-browser" est automatiquement préfixé)
evocrawl browser execute "open https://news.ycombinator.com"
evocrawl browser execute "snapshot"
evocrawl browser execute "click @e3"
evocrawl browser execute "scrape"
# Playwright Python - navigate, interact, extract
evocrawl browser execute --python '
await page.goto("https://news.ycombinator.com")
items = await page.query_selector_all(".titleline > a")
for item in items[:5]:
print(await item.text_content())
'
# Playwright JavaScript - same page object
evocrawl browser execute --node '
await page.goto("https://example.com");
const title = await page.title();
console.log(title);
'
# Explicit bash mode - runs in the sandbox
evocrawl browser execute --bash "agent-browser snapshot"
# Target a specific session
evocrawl browser execute --session --python 'print(await page.title())'
# Save output to file
evocrawl browser execute "scrape" -o result.txt
# Close a specific session
evocrawl browser close --session
# List sessions (all / active / destroyed)
evocrawl browser list
evocrawl browser list active --json
```
**Sous-commandes :**
| Sous-commande | Description |
| ---------------- | ------------------------------------------------------------------------------------------------------------- |
| `launch-session` | Lance une nouvelle session de navigateur cloud (renvoie l’ID de session, l’URL CDP et l’URL de vue en direct) |
| `execute ` | Exécute du code Playwright Python/JS ou des commandes bash dans une session |
| `list [status]` | Répertorie les sessions de navigateur (filtrage par `active` ou `destroyed`) |
| `close` | Ferme une session de navigateur |
**Options d’exécution :**
| Option | Description |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--bash` | Exécute des commandes bash à distance dans le bac à sable (par défaut). [agent-browser](https://github.com/vercel-labs/agent-browser) (40+ commandes) est préinstallé et automatiquement préfixé. `CDP_URL` est injecté automatiquement pour qu’agent-browser se connecte à votre session sans configuration supplémentaire. Option recommandée pour les agents d’IA. |
| `--python` | Exécute du code Playwright Python. Un objet Playwright `page` est disponible — utilisez `await page.goto()`, `await page.title()`, etc. |
| `--node` | Exécute du code Playwright JavaScript. Le même objet `page` est disponible. |
| `--session ` | Cible une session spécifique (par défaut : session active) |
**Options de lancement :**
| Option | Description |
| ---------------------------- | ------------------------------------------------------------------------------- |
| `--ttl ` | TTL total de la session (par défaut : 600, plage : 30–3600) |
| `--ttl-inactivity ` | Fermeture automatique après inactivité (plage : 10–3600) |
| `--profile ` | Nom du profil (enregistre et réutilise l’état du navigateur entre les sessions) |
| `--no-save-changes` | Charge les données de profil existantes sans enregistrer les modifications |
| `--stream` | Active le streaming de la vue en direct |
**Options communes :**
| Option | Description |
| ----------------- | ------------------------------------ |
| `--output ` | Enregistre la sortie dans un fichier |
| `--json` | Produit la sortie au format JSON |
***
### Crawl
Lancer un crawl sur l'ensemble d'un site web à partir d'une URL.
```bash CLI theme={null} theme={null}
# Start a crawl (returns job ID immediately)
evocrawl crawl https://example.com
# Wait for crawl to complete
evocrawl crawl https://example.com --wait
# Attendre avec indicateur de progression
evocrawl crawl https://example.com --wait --progress
```
#### Consulter l'état du crawl
```bash CLI theme={null} theme={null}
# Vérifier le statut du crawl avec l'ID de tâche
evocrawl crawl
# Exemple avec un véritable ID de tâche
evocrawl crawl 550e8400-e29b-41d4-a716-446655440000
```
#### Options de crawl
```bash CLI theme={null} theme={null}
# Limit crawl depth and pages
evocrawl crawl https://example.com --limit 100 --max-depth 3 --wait
# Include only specific paths
evocrawl crawl https://example.com --include-paths /blog,/docs --wait
# Exclude specific paths
evocrawl crawl https://example.com --exclude-paths /admin,/login --wait
# Include subdomains
evocrawl crawl https://example.com --allow-subdomains --wait
# Crawl entire domain
evocrawl crawl https://example.com --crawl-entire-domain --wait
# Rate limiting
evocrawl crawl https://example.com --delay 1000 --max-concurrency 2 --wait
# Intervalle de polling et délai d'expiration personnalisés
evocrawl crawl https://example.com --wait --poll-interval 10 --timeout 300
# Save results to file
evocrawl crawl https://example.com --wait --pretty -o results.json
```
**Options disponibles :**
| Option | Description |
| --------------------------- | ------------------------------------------------------------------ |
| `--url ` | URL à explorer (alternative à l’argument positionnel) |
| `--wait` | Attendre la fin du crawl |
| `--progress` | Afficher un indicateur de progression pendant l’attente |
| `--poll-interval ` | Intervalle d’interrogation (par défaut : 5) |
| `--timeout ` | Délai d’expiration de l’attente |
| `--status` | Vérifier l’état d’une tâche de crawl existante |
| `--limit ` | Nombre maximal de pages à explorer |
| `--max-depth ` | Profondeur maximale du crawl |
| `--include-paths ` | Chemins à inclure (séparés par des virgules) |
| `--exclude-paths ` | Chemins à exclure (séparés par des virgules) |
| `--sitemap ` | Gestion du sitemap : `include`, `skip`, `only` |
| `--allow-subdomains` | Inclure les sous-domaines |
| `--allow-external-links` | Suivre les liens externes |
| `--crawl-entire-domain` | Explorer l’ensemble du domaine |
| `--ignore-query-parameters` | Considérer les URL avec des paramètres différents comme identiques |
| `--delay ` | Délai entre les requêtes |
| `--max-concurrency ` | Nombre maximal de requêtes simultanées |
| `--output ` | Enregistrer le résultat dans un fichier |
| `--pretty` | Afficher la sortie JSON formatée |
***
### Agent
Recherchez et collectez des données sur le web à l'aide de prompts en langage naturel.
```bash CLI theme={null} theme={null}
# Basic usage - URLs are optional
evocrawl agent "Find the top 5 AI startups and their funding amounts" --wait
# Focus on specific URLs
evocrawl agent "Compare pricing plans" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait
# Use a schema for structured output
evocrawl agent "Obtenez des informations sur l'entreprise" --urls https://example.com --schema '{"name": "string", "founded": "number"}' --wait
# Use schema from a file
evocrawl agent "Get product details" --urls https://example.com --schema-file schema.json --wait
```
#### Options de l'agent
```bash CLI theme={null} theme={null}
# Use Spark 1 Pro for higher accuracy
evocrawl agent "Competitive analysis across multiple domains" --model spark-1-pro --wait
# Set max credits to limit costs
evocrawl agent "Collecter les informations de contact des sites web d'entreprises" --max-credits 100 --wait
# Check status of an existing job
evocrawl agent --status
# Custom polling interval and timeout
evocrawl agent "Summarize recent blog posts" --wait --poll-interval 10 --timeout 300
# Save output to file
evocrawl agent "Find pricing information" --urls https://example.com --wait -o pricing.json --pretty
```
**Options disponibles :**
| Option | Description |
| --------------------------- | ------------------------------------------------------------------------------------------------------- |
| `--urls ` | Liste facultative d’URL sur lesquelles concentrer l’agent (séparées par des virgules) |
| `--model ` | Modèle à utiliser : `spark-1-mini` (par défaut, 60 % moins cher) ou `spark-1-pro` (meilleure précision) |
| `--schema ` | Schéma JSON pour la sortie structurée (chaîne JSON intégrée) |
| `--schema-file ` | Chemin vers le fichier de schéma JSON pour la sortie structurée |
| `--max-credits ` | Nombre maximal de crédits à utiliser (la tâche échoue si la limite est atteinte) |
| `--status` | Consulter l’état d’une tâche d’agent existante |
| `--wait` | Attendre que l’agent ait terminé avant de renvoyer les résultats |
| `--poll-interval ` | Intervalle d’interrogation pendant l’attente (par défaut : 5) |
| `--timeout ` | Délai d’attente maximal (par défaut : aucun délai) |
| `--output ` | Enregistrer la sortie dans un fichier |
| `--json` | Sortie au format JSON |
***
### Utilisation des crédits
Consultez le solde et l'utilisation des crédits de votre équipe.
```bash CLI theme={null}
# Voir l'utilisation des crédits
evocrawl credit-usage
# Sortie en JSON
evocrawl credit-usage --json --pretty
```
***
### Version
Afficher la version de la CLI.
```bash CLI theme={null}
evocrawl version
# ou
evocrawl --version
```
## Options globales
Ces options sont disponibles pour toutes les commandes :
| Option | Raccourci | Description |
| ----------------- | --------- | ---------------------------------------------------------------------------------------- |
| `--status` | | Afficher la version, l’état d’authentification, le niveau de parallélisme et les crédits |
| `--api-key ` | `-k` | Ignorer la clé d’API enregistrée pour cette commande |
| `--api-url ` | | Utiliser une URL d’API personnalisée (pour l’auto-hébergement ou le développement local) |
| `--help` | `-h` | Afficher l’aide pour une commande |
| `--version` | `-V` | Afficher la version de la CLI |
## Gestion de la sortie
La CLI écrit sur stdout par défaut, ce qui facilite l’utilisation de pipes ou la redirection :
```bash CLI theme={null}
# Pipe markdown to another command
evocrawl https://example.com | head -50
# Redirect to a file
evocrawl https://example.com > output.md
# Save JSON with pretty formatting
evocrawl https://example.com --format markdown,links --pretty -o data.json
```
### Comportement des formats
* **Un seul format** : renvoie le contenu brut (texte markdown, HTML, etc.)
* **Plusieurs formats** : renvoie du JSON avec toutes les données demandées
```bash CLI theme={null}
# Sortie markdown brute
evocrawl https://example.com --format markdown
# Sortie JSON avec plusieurs formats
evocrawl https://example.com --format markdown,links
```
## Exemples
### Scraping rapide
```bash CLI theme={null}
# Récupérer le contenu markdown d'une URL (utiliser --only-main-content pour une sortie épurée)
evocrawl https://docs.evocrawl.com --only-main-content
# Get HTML content
evocrawl https://example.com --html -o page.html
```
### Exploration complète du site
```bash CLI theme={null}
# Crawle un site de docs avec des limites
evocrawl crawl https://docs.example.com --limit 50 --max-depth 2 --wait --progress -o docs.json
```
### Découverte de sites web
```bash CLI theme={null}
# Trouver tous les articles de blog
evocrawl map https://example.com --search "blog" -o blog-urls.txt
```
### Flux de recherche
```bash CLI theme={null}
# Rechercher et scraper les résultats pour la recherche
evocrawl search "machine learning best practices 2024" --scrape --scrape-formats markdown --pretty
```
### Agent
```bash CLI theme={null}
# Les URL sont facultatives
evocrawl agent "Find the top 5 AI startups and their funding amounts" --wait
# Se concentrer sur des URL spécifiques
evocrawl agent "Compare pricing plans" --urls https://slack.com/pricing,https://teams.microsoft.com/pricing --wait
```
### Automatisation du navigateur Web
```bash CLI theme={null}
# Launch a session, scrape a page, and close
evocrawl browser launch-session
evocrawl browser execute "open https://news.ycombinator.com"
evocrawl browser execute "snapshot"
evocrawl browser execute "scrape"
evocrawl browser close
# Utiliser agent-browser via le mode bash (par défaut — recommandé pour les agents IA)
evocrawl browser launch-session
evocrawl browser execute "open https://example.com"
evocrawl browser execute "snapshot"
# snapshot returns @ref IDs — use them to interact
evocrawl browser execute "click @e5"
evocrawl browser execute "fill @e3 'search query'"
evocrawl browser execute "scrape"
# Run --help to see all 40+ commands
evocrawl browser execute --bash "agent-browser --help"
evocrawl browser close
```
### Combiner avec d'autres outils
```bash CLI theme={null}
# Extract URLs from search results
jq -r '.data.web[].url' search-results.json
# Récupérer les titres des résultats de recherche
jq -r '.data.web[] | "\(.title): \(.url)"' search-results.json
# Extract links and process with jq
evocrawl https://example.com --format links | jq '.links[].url'
# Count URLs from map
evocrawl map https://example.com | wc -l
```
## Télémétrie
La CLI collecte des données d’utilisation anonymes lors de l’authentification afin d’améliorer le produit :
* Version de la CLI, système d’exploitation et version de Node.js
* Détection de l’outil de développement (par exemple, Cursor, VS Code, Claude Code)
**Aucune donnée relative aux commandes, aux URL ou au contenu des fichiers n’est collectée via la CLI.**
Pour désactiver la télémétrie, définissez la variable d’environnement :
```bash CLI theme={null}
export EVOCRAWL_NO_TELEMETRY=1
```
## Open Source
La CLI et la Skill Evocrawl sont open source et disponibles sur GitHub : [evocrawl/cli](https://github.com/superaihuman/evocrawl/cli)
> Êtes-vous un agent IA qui a besoin d’une clé API Evocrawl ? Consultez [evocrawl.dev/agent-onboarding/SKILL.md](https://www.evocrawl.com/agent-onboarding/SKILL.md) pour obtenir les instructions d’onboarding automatisé.