# Rust (/fr/quickstarts/rust)
## Prérequis [#prérequis]
* Rust 1.70+ avec Cargo
* Une clé API Firecrawl — [obtenez-en une gratuitement](https://www.firecrawl.dev/app/api-keys)
## Installez le crate Rust [#installez-le-crate-rust]
Ajoutez `firecrawl` à votre `Cargo.toml` :
```toml
[dependencies]
firecrawl = "2"
tokio = { version = "1", features = ["full"] }
serde_json = "1"
```
## Recherche sur le Web [#recherche-sur-le-web]
```rust
use firecrawl::{Client, SearchOptions};
#[tokio::main]
async fn main() -> Result<(), Box> {
let client = Client::new("fc-YOUR-API-KEY")?;
let results = client.search(
"firecrawl web scraping",
SearchOptions { limit: Some(5), ..Default::default() },
).await?;
if let Some(web) = results.data.web {
for item in web {
if let firecrawl::SearchResultOrDocument::WebResult(r) = item {
println!("{} - {}", r.url, r.title.unwrap_or_default());
}
}
}
Ok(())
}
```
## Extraire les données d’une page [#extraire-les-données-dune-page]
```rust
let doc = client.scrape("https://example.com", None).await?;
println!("{}", doc.markdown.unwrap_or_default());
```
```json
{
"markdown": "# Example Domain\n\nThis domain is for use in illustrative examples...",
"metadata": {
"title": "Example Domain",
"sourceURL": "https://example.com"
}
}
```
## Interact avec une page [#interact-avec-une-page]
Scrapez une page afin d’obtenir un `scrapeId`, puis utilisez l’API Interact pour contrôler la session de navigateur :
```rust
use firecrawl::{Client, ScrapeOptions, Format, ScrapeExecuteOptions};
let doc = client.scrape(
"https://www.amazon.com",
ScrapeOptions {
formats: Some(vec![Format::Markdown]),
..Default::default()
},
).await?;
let scrape_id = doc.metadata
.as_ref()
.and_then(|m| m.scrape_id.as_deref())
.expect("scrapeId not found");
// Envoyer un prompt pour interagir avec la page
let run = client.interact(
scrape_id,
ScrapeExecuteOptions {
prompt: Some("Search for iPhone 16 Pro Max".to_string()),
..Default::default()
},
).await?;
let run = client.interact(
scrape_id,
ScrapeExecuteOptions {
prompt: Some("Click on the first result and tell me the price".to_string()),
..Default::default()
},
).await?;
println!("{:?}", run.output);
// Fermer la session
client.stop_interaction(scrape_id).await?;
```
## Variable d’environnement [#variable-denvironnement]
Définissez `FIRECRAWL_API_KEY` au lieu de passer directement la clé :
```bash
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
```rust
let api_key = std::env::var("FIRECRAWL_API_KEY")?;
let client = Client::new(api_key)?;
```
## Étapes suivantes [#étapes-suivantes]
Recherchez sur le web et obtenez le contenu complet de la page
Toutes les options de scrape, y compris les formats, les actions et les proxys
Cliquez, remplissez des formulaires et extrayez du contenu dynamique
Référence complète du SDK avec crawl, cartographie, extraction par lot et bien plus encore