> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Python
> 使用 Python 快速上手 Firecrawl。通过官方 SDK 抓取、搜索网页数据并与之交互。
## 前提条件
* Python 3.8+
* 一个 Firecrawl API 密钥——[免费获取](https://www.firecrawl.dev/app/api-keys)
## 安装 SDK
```bash theme={null}
pip install firecrawl-py
```
## 进行网页搜索
```python theme={null}
from firecrawl import Firecrawl
app = Firecrawl(api_key="fc-YOUR-API-KEY")
results = app.search("firecrawl web scraping", limit=5)
for result in results.web:
print(result.title, result.url)
```
## 抓取页面
```python theme={null}
result = app.scrape("https://example.com")
print(result.markdown)
```
```json theme={null}
{
"markdown": "# Example Domain\n\nThis domain is for use in illustrative examples...",
"metadata": {
"title": "Example Domain",
"sourceURL": "https://example.com"
}
}
```
## 与页面交互
使用交互功能来控制实时浏览器会话——点击按钮、填写表单并提取动态内容。
```python theme={null}
result = app.scrape("https://www.amazon.com", formats=["markdown"])
scrape_id = result.metadata.scrape_id
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)
app.stop_interaction(scrape_id)
```
## 环境变量
不要直接传入 `api_key`，请改为设置 `FIRECRAWL_API_KEY` 环境变量：
```bash theme={null}
export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
```python theme={null}
app = Firecrawl()
```
## 后续步骤
包含 formats、actions 和代理在内的所有 scrape 选项
进行网页搜索并获取完整页面内容
点击、填写表单并提取动态内容
包含爬取、map、async 等内容的完整 SDK 参考