# Flask (/zh/quickstarts/flask)
Related: [Node.js](/zh/quickstarts/nodejs.md), [Next.js](/zh/quickstarts/nextjs.md), [Express](/zh/quickstarts/express.md), [NestJS](/zh/quickstarts/nestjs.md), [Fastify](/zh/quickstarts/fastify.md), [Hono](/zh/quickstarts/hono.md)
## 前提条件 [#前提条件]
* Python 3.8+
* Firecrawl API 密钥 — [免费获取](https://www.firecrawl.dev/app/api-keys)
## 设置 [#设置]
```bash
pip install flask firecrawl-py
```
将你的 API 密钥添加到 `.env` 中：
```bash
FIRECRAWL_API_KEY=fc-YOUR-API-KEY
```
## 创建应用程序 [#创建应用程序]
创建 `app.py`：
```python
import os
from flask import Flask, request, jsonify
from firecrawl import Firecrawl
app = Flask(__name__)
firecrawl = Firecrawl(api_key=os.environ["FIRECRAWL_API_KEY"])
@app.post("/search")
def search():
data = request.get_json()
results = firecrawl.search(data["query"], limit=data.get("limit", 5))
return jsonify([{"title": r.title, "url": r.url} for r in results.web])
@app.post("/scrape")
def scrape():
data = request.get_json()
result = firecrawl.scrape(data["url"])
return jsonify(markdown=result.markdown, metadata=result.metadata)
@app.post("/interact/start")
def interact_start():
data = request.get_json()
result = firecrawl.scrape(data["url"], formats=["markdown"])
return jsonify(scrape_id=result.metadata.scrape_id)
@app.post("/interact")
def interact():
data = request.get_json()
response = firecrawl.interact(data["scrape_id"], prompt=data["prompt"])
return jsonify(output=response.output)
@app.post("/interact/stop")
def interact_stop():
data = request.get_json()
firecrawl.stop_interaction(data["scrape_id"])
return jsonify(status="stopped")
if __name__ == "__main__":
app.run(debug=True)
```
## 运行 [#运行]
```bash
flask run
```
## 试一试 [#试一试]
```bash
# 进行网页搜索
curl -X POST http://localhost:5000/search \
-H "Content-Type: application/json" \
-d '{"query": "firecrawl web scraping", "limit": 5}'
# 抓取页面
curl -X POST http://localhost:5000/scrape \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'
# 启动交互式会话
curl -X POST http://localhost:5000/interact/start \
-H "Content-Type: application/json" \
-d '{"url": "https://www.amazon.com"}'
```
## 后续步骤 [#后续步骤]
所有 scrape 选项，包括 formats、actions 和代理
进行网页搜索并获取完整页面内容
点击、填写表单并提取动态内容
完整的 SDK 参考，包含爬取、map、async 等内容