# 介绍 (/zh/introduction) \*\*对于 AI 代理：\*\*使用 [llms.txt](/zh/llms.txt) 获取所有文档的完整索引。
悬赏：5,000 额度奖励 ，征集对 Firecrawl 的优质反馈

如需获得奖励资格，请通过我们的 Firecrawl Feedback Assistant 完成一次高质量访谈 (提供经过思考的具体用例等) 。只需几分钟，随时可停止，且对人类和代理都很友好 (只需将链接粘贴到您的代理工具中！) 。刚接触 Firecrawl？您的看法同样重要。

开始访谈

请填写您的 Email 以获得奖励资格。我们会在每周结束时审核访谈质量。

## 开始使用 [#开始使用]
### 安装 Firecrawl CLI [#安装-firecrawl-cli]
只需一条命令，即可安装 Firecrawl CLI、在浏览器中完成身份验证，并为检测到的每个编码代理添加技能。 ```bash npx -y firecrawl-cli@latest init --all --browser ``` 完成设置后请重启你的编码代理，以便其发现这些新技能。完整的配置流程请参见 [Skills + CLI](/zh/sdks/cli)。
### 使用代理设置 [#使用代理设置]
将此 Firecrawl 设置 prompt 提供给你的代理。
### 直接构建和测试 [#直接构建和测试]
创建一个免费账户，以直接访问 API 并享有更高的限制额度 无需编写代码即可在浏览器中测试 Firecrawl ***
## Firecrawl 可以做什么？ [#firecrawl-可以做什么]
进行网页搜索并从结果中获取完整页面内容 从任意 URL 提取内容，支持 markdown、HTML 或结构化 JSON 格式 继续处理任何已抓取的页面：点击、填写表单、提取动态 内容
### 为什么选择 Firecrawl？ [#为什么选择-firecrawl]
* **适用于 LLM 的输出**：干净的 markdown、结构化 JSON、截图等。 * **应对复杂场景**：代理、反机器人机制、JavaScript 渲染以及动态内容。 * **可靠**：专为生产环境打造，具备高可用性和稳定一致的结果。 * **快速**：数秒内返回结果，并针对高吞吐量进行了优化。 * **MCP Server**：通过 [模型上下文协议](/zh/mcp-server) 将 Firecrawl 连接到任何 AI 工具。 *** 进行网页搜索，并在一次调用中获取搜索结果的完整页面内容。请参见 [Search 功能文档](/zh/features/search) 了解所有选项。 Python Node cURL CLI ```python from firecrawl import Firecrawl firecrawl = Firecrawl( # 无需 API 密钥即可开始使用 — 添加一个以获得更高的限流额度： # api_key="fc-YOUR-API-KEY", ) results = firecrawl.search( query="firecrawl", limit=3, ) print(results) ``` ```js import { Firecrawl } from 'firecrawl'; const firecrawl = new Firecrawl({ // 无需 API 密钥即可开始使用 — 添加一个以获得更高的限流额度： // apiKey: "fc-YOUR-API-KEY", }); const results = await firecrawl.search('firecrawl', { limit: 3, scrapeOptions: { formats: ['markdown'] } }); console.log(results); ``` ```bash # 无需 API 密钥即可开始使用 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 以获得更高的限流配额： curl -s -X POST "https://api.firecrawl.dev/v2/search" \ -H "Content-Type: application/json" \ -d '{ "query": "firecrawl", "limit": 3 }' ``` ```bash # 搜索网络 firecrawl search "firecrawl web scraping" --limit 5 --pretty ``` SDK 会直接返回数据对象。cURL 会返回完整的 payload。 ```json title="JSON" { "success": true, "data": { "web": [ { "url": "https://www.firecrawl.dev/", "title": "Firecrawl - 面向 AI 的 Web 数据 API", "description": "用于 AI 的网页爬取、抓取与搜索 API。为规模而建。Firecrawl 将整个互联网送达 AI 代理与开发者。", "position": 1 }, { "url": "https://github.com/firecrawl/firecrawl", "title": "mendableai/firecrawl：将整站转换为可供 LLM 使用的内容 - GitHub", "description": "Firecrawl 是一项 API 服务，接收一个 URL，对其进行爬取，并将其转换为干净的 Markdown 或结构化数据。", "position": 2 }, ... ], "images": [ { "title": "快速上手 | Firecrawl", "imageUrl": "https://mintlify.s3.us-west-1.amazonaws.com/firecrawl/logo/logo.png", "imageWidth": 5814, "imageHeight": 1200, "url": "https://docs.firecrawl.dev/", "position": 1 }, ... ], "news": [ { "title": "Y Combinator 创业公司 Firecrawl 准备出资 100 万美元雇用三名 AI 代理作为员工", "url": "https://techcrunch.com/2025/05/17/y-combinator-startup-firecrawl-is-ready-to-pay-1m-to-hire-three-ai-agents-as-employees/", "snippet": "目前它在 YC 的招聘板发布了三则"仅限 AI 代理"的新职位，并为此预留了总计 100 万美元的预算。", "date": "3 个月前", "position": 1 }, ... ] } } ```
## 抓取 [#抓取]
抓取任意 URL，并以 markdown、HTML 或其他格式获取其内容。请参见 [Scrape 功能文档](/zh/features/scrape) 了解所有选项。 Python Node cURL CLI ```python from firecrawl import Firecrawl firecrawl = Firecrawl( # 无需 API 密钥即可开始使用 — 添加一个以获得更高的限流上限： # api_key="fc-YOUR-API-KEY", ) # Scrape a website: doc = firecrawl.scrape("https://firecrawl.dev", formats=["markdown", "html"]) print(doc) ``` ```js import { Firecrawl } from 'firecrawl'; const firecrawl = new Firecrawl({ // 无需 API 密钥即可开始使用 — 添加一个以获得更高限流： // apiKey: "fc-YOUR-API-KEY", }); // 抓取网站： const doc = await firecrawl.scrape('https://firecrawl.dev', { formats: ['markdown', 'html'] }); console.log(doc); ``` ```bash # 无需 API 密钥即可开始使用 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 以获得更高的限流配额： curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \ -H "Content-Type: application/json" \ -d '{ "url": "https://firecrawl.dev", "formats": ["markdown", "html"] }' ``` ```bash # Scrape a URL and get markdown firecrawl https://firecrawl.dev # 使用多种格式(返回 JSON) firecrawl https://firecrawl.dev --format markdown,html,links --pretty ``` 各 SDK 将直接返回数据对象。cURL 将按下方所示原样返回有效载荷。 ```json { "success": true, "data" : { "markdown": "Launch Week I 开始了！[查看我们第 2 天的发布 🚀](https://www.firecrawl.dev/blog/launch-week-i-day-2-doubled-rate-limits)[💥 获享 2 个月免费...", "html": "
## 交互 [#交互]
抓取页面后，继续与其交互：点击按钮、填写表单、提取动态内容，或继续深入导航。你可以用简单的英文描述你的需求，或编写代码以实现完全控制。请参见 [Interact 功能文档](/zh/features/interact) 了解所有选项。 Python Node cURL CLI ```python from firecrawl import Firecrawl app = Firecrawl( # 无需 API 密钥即可开始使用 — 添加一个以获得更高限流： # api_key="fc-YOUR-API-KEY", ) # 1. 抓取 Amazon 首页 result = app.scrape("https://www.amazon.com", formats=["markdown"]) scrape_id = result.metadata.scrape_id # 2. 交互 — 搜索商品并获取价格 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) # 3. 停止会话 app.stop_interaction(scrape_id) ``` ```js import { Firecrawl } from 'firecrawl'; const app = new Firecrawl({ // 无需 API 密钥即可开始使用 — 添加一个以获得更高的限流上限： // apiKey: 'fc-YOUR-API-KEY', }); // 1. Scrape Amazon's homepage const result = await app.scrape('https://www.amazon.com', { formats: ['markdown'] }); const scrapeId = result.metadata?.scrapeId; // 2. Interact — search for a product and get its price await app.interact(scrapeId, { prompt: 'Search for iPhone 16 Pro Max' }); const response = await app.interact(scrapeId, { prompt: 'Click on the first result and tell me the price' }); console.log(response.output); // 3. Stop the session await app.stopInteraction(scrapeId); ``` ```bash # 1. 抓取 Amazon 首页 # 无需 API 密钥即可开始 — 添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY" 以获得更高限流： RESPONSE=$(curl -s -X POST "https://api.firecrawl.dev/v2/scrape" \ -H "Content-Type: application/json" \ -d '{"url": "https://www.amazon.com", "formats": ["markdown"]}') SCRAPE_ID=$(echo $RESPONSE | jq -r '.data.metadata.scrapeId') # 2. 交互 — 搜索商品并获取价格 curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{"prompt": "Search for iPhone 16 Pro Max"}' curl -s -X POST "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" \ -H "Content-Type: application/json" \ -d '{"prompt": "Click on the first result and tell me the price"}' # 3. 停止会话 curl -s -X DELETE "https://api.firecrawl.dev/v2/scrape/$SCRAPE_ID/interact" ``` ```bash # 1. 抓取 Amazon 首页（scrape ID 自动保存） firecrawl scrape https://www.amazon.com # 2. 交互 — 搜索商品并获取价格 firecrawl interact "Search for iPhone 16 Pro Max" firecrawl interact "Click on the first result and tell me the price" # 3. 停止会话 firecrawl interact stop ``` ```json title="Response" { "success": true, "cdpUrl": "wss://browser.firecrawl.dev/...", "liveViewUrl": "https://liveview.firecrawl.dev/...", "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...", "output": "The iPhone 16 Pro Max (256GB) is priced at $1,199.00.", "exitCode": 0, "killed": false } ``` ***
## 更多功能 [#更多功能]
由 AI 驱动的自主网页数据采集 点击、填写表单、提取动态内容 异步事件交付 适用于交互式工作流的托管浏览器会话 发现网站上的所有 URL 递归采集整个站点的内容 ***
## 资源 [#资源]
完整的 API 参考文档，包含交互式示例 Python、Node.js、CLI 以及社区 SDK 自行托管 Firecrawl 或为项目做出贡献 LangChain、LlamaIndex、OpenAI 等