= client.agent_with_schema(
vec!["https://firecrawl.dev".to_string()],
"Extract pricing plan details",
schema,
).await?;
if let Some(data) = result {
for plan in &data.plans {
println!("{}: {}", plan.name, plan.price);
}
}
```
## スクレイピングに紐づいたインタラクティブセッション
スクレイピングジョブIDを使用して、同じコンテキストで後続のブラウザコードを実行できます。
* `interact(...)` は、スクレイピングに紐づいたブラウザセッション内でコードまたはプロンプトを実行します。
* `stop_interaction(...)` は、作業完了後にインタラクティブセッションを停止します。
```rust theme={null}
use firecrawl::{Client, ScrapeExecuteOptions, ScrapeExecuteLanguage};
let scrape_job_id = "550e8400-e29b-41d4-a716-446655440000";
// ブラウザセッションでコードを実行する
let run = client.interact(
scrape_job_id,
ScrapeExecuteOptions {
code: Some("console.log(await page.title())".to_string()),
language: Some(ScrapeExecuteLanguage::Node),
timeout: Some(60),
..Default::default()
},
).await?;
println!("{:?}", run.stdout);
// または自然言語プロンプトを使用する
let run = client.interact(
scrape_job_id,
ScrapeExecuteOptions {
prompt: Some("Click the pricing tab and summarize the plans".to_string()),
..Default::default()
},
).await?;
// 完了したらセッションを停止する
client.stop_interaction(scrape_job_id).await?;
```
## 設定
`Client::new(...)` と `Client::new_selfhosted(...)` でクライアントを作成します。
| Option | Description |
| ------------------------------------------ | ---------------------------------------------------------------- |
| `Client::new(api_key)` | Firecrawl のクラウドサービス (`https://api.firecrawl.dev`) 用のクライアントを作成します |
| `Client::new_selfhosted(api_url, api_key)` | セルフホストの Firecrawl インスタンス用のクライアントを作成します |
```rust theme={null}
use firecrawl::Client;
// クラウドサービス
let client = Client::new("fc-your-api-key")?;
// セルフホスト
let client = Client::new_selfhosted(
"http://localhost:3002",
Some("fc-your-api-key"),
)?;
// 認証なしのセルフホスト
let client = Client::new_selfhosted(
"http://localhost:3002",
None::<&str>,
)?;
```
### 環境変数
キーを直接渡す代わりに、`FIRECRAWL_API_KEY` 環境変数を設定してください。
```bash theme={null}
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
```rust theme={null}
let api_key = std::env::var("FIRECRAWL_API_KEY")
.expect("FIRECRAWL_API_KEY must be set");
let client = Client::new(api_key)?;
```
### ポーリング間隔
同期メソッド (`crawl`、`batch_scrape`、`agent`) は、完了するまでポーリングを続けます。ポーリング間隔は、`options` 構造体でカスタマイズできます。
```rust theme={null}
use firecrawl::CrawlOptions;
let options = CrawlOptions {
limit: Some(50),
poll_interval: Some(3000), // 3秒ごとにポーリング（デフォルト: 2000ms）
..Default::default()
};
```
## エラー処理
この SDK は、`Error`、`Debug`、`Display` を実装する `FirecrawlError` 列挙型を使用します。すべてのメソッドは `Result` を返します。
```rust theme={null}
use firecrawl::{Client, FirecrawlError};
match client.scrape("https://example.com", None).await {
Ok(doc) => println!("{}", doc.markdown.unwrap_or_default()),
Err(FirecrawlError::HttpRequestFailed(action, status, msg)) => {
eprintln!("HTTP {}: {} ({})", status, msg, action);
}
Err(FirecrawlError::APIError(action, api_err)) => {
eprintln!("API error ({}): {}", action, api_err.error);
}
Err(FirecrawlError::JobFailed(msg)) => {
eprintln!("Job failed: {}", msg);
}
Err(FirecrawlError::Misuse(msg)) => {
eprintln!("SDK misuse: {}", msg);
}
Err(e) => eprintln!("Error: {}", e),
}
```
> Firecrawl API キーを必要とする AI エージェントですか？自動オンボーディング手順については、[firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) を参照してください。