> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Firecrawl 抓取

> 抓取一个 URL，返回它的正文 markdown。

抓取一个 URL，返回它的正文 markdown。`url` 和 `proxy` 都必填 —— 计量档位下 `proxy` 必须是 `basic` —— `formats` 选择输出格式。返回 `success` 和 `data`，其中 `markdown` 是正文，`metadata` 是一大坨页面元信息（og: 与 twitter: 标签、`statusCode`、`sourceURL`、`language`）。实测抓 1 个页面约 10 秒。⚠️ URL 必须是 HTTPS，且不能指向 PDF，两者都是直接拒绝而不是尽力而为。有 URL 又要正文时用它。多个 URL 一起处理用 [`post_firecrawl_batch_scrape`](/docs/zh/api-reference/search/post_firecrawl-batch-scrape)（后台任务），少量且要立刻拿到用 [`post_tavily_extract`](/docs/zh/api-reference/search/post_tavily-extract)（同步）。要先找出 URL，用 [`post_firecrawl_map`](/docs/zh/api-reference/search/post_firecrawl-map)。

<Note>
  **第一次用？** 把任意 MCP 客户端指向 `https://mcp.aisa.one/mcp` —— Claude Code、
  Codex、Cursor、VS Code 都可以。鉴权走 OAuth：客户端打开浏览器，你点一次
  Allow，不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
  [aisa.one/zh-cn/mcp](https://aisa.one/zh-cn/mcp#connect)。
</Note>

[在你的 agent 里把这个端点跑起来 →](https://aisa.one/mcp?from=/zh/api-reference/search/post_firecrawl-scrape)


## OpenAPI

````yaml openapi/zh/firecrawl.json POST /firecrawl/scrape
openapi: 3.0.0
info:
  title: Firecrawl API
  version: 1.0.0
  description: >-
    Firecrawl 各 endpoint 的统一 API 文档，包括 Scrape、Search、Map、Parse、Crawl 和 Batch
    Scrape。Scrape、Search、Map 和 Parse 是同步接口。Crawl 和 Batch Scrape
    是异步接口：调用方提交任务，然后轮询返回的任务资源以获取状态和结果。


    计费按消耗的 Firecrawl credit 计量，而不是按请求固定收费，因此总费用随任务产生的页面、链接或结果数量增长。大致 credit
    消耗：Scrape = 每页 1 credit，Map = 每页 1 credit，Search = 每 10 条结果约 2 credits，Crawl
    = 每页 1 credit，Batch Scrape = 每页 1 credit。每个 credit 对应的美元费率取决于你的等级。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /firecrawl/scrape:
    post:
      tags:
        - https://docs.firecrawl.dev/api-reference/endpoint/scrape
      summary: 抓取单个页面并以 markdown 返回其正文内容。
      description: >-
        抓取一个 URL，返回它的正文 markdown。`url` 和 `proxy` 都必填 —— 计量档位下 `proxy` 必须是
        `basic` —— `formats` 选择输出格式。返回 `success` 和 `data`，其中 `markdown`
        是正文，`metadata` 是一大坨页面元信息（og: 与 twitter:
        标签、`statusCode`、`sourceURL`、`language`）。实测抓 1 个页面约 10 秒。⚠️ URL 必须是
        HTTPS，且不能指向 PDF，两者都是直接拒绝而不是尽力而为。有 URL 又要正文时用它。多个 URL 一起处理用
        `post_firecrawl_batch_scrape`（后台任务），少量且要立刻拿到用
        `post_tavily_extract`（同步）。要先找出 URL，用 `post_firecrawl_map`。
      operationId: post_firecrawl_scrape
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                  description: 要抓取的 HTTPS URL。计量模式下不支持 PDF URL。
                  example: https://docs.firecrawl.dev
                proxy:
                  type: string
                  enum:
                    - basic
                  description: 代理层级。在计量模式下必须显式设为 "basic"。
                  example: basic
                formats:
                  type: array
                  items:
                    type: string
                    enum:
                      - markdown
                  description: 可选的输出格式。若提供，其值必须正好是 ["markdown"]。
                  example:
                    - markdown
              required:
                - url
                - proxy
      responses:
        '200':
          description: 抓取成功完成。
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 抓取成功时为 true。
                  data:
                    type: object
                    properties:
                      markdown:
                        type: string
                        description: 以 markdown 表示的抓取页面内容。
                      metadata:
                        type: object
                        description: 页面元数据，例如标题、描述、来源 URL 和 HTTP 状态。
                        properties:
                          title:
                            type: string
                          description:
                            type: string
                          sourceURL:
                            type: string
                          statusCode:
                            type: integer
                  creditsUsed:
                    type: integer
                    description: 该请求消耗的 Firecrawl credits（每页 1 个）。
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.