> ## 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 抓取

> 抓取单个网页并以干净的 markdown 返回其正文内容——无需你自己解析 HTML。

抓取单个 URL，并以 markdown 返回清洗后的正文内容。当你已经知道确切要抓哪一页时，这是最快的单页入口。在 AIsa 计量模式下，该请求被刻意限制得比较窄：URL 必须是 HTTPS 且不能是 PDF，`proxy` 必须设为 `"basic"`，如果传 `formats`，其值必须正好是 `["markdown"]`。Firecrawl 的高级选项（actions、headers、parsers、profile、lockdown、zeroDataRetention）不被接受。

计费按 Firecrawl credit 计量——Scrape 每页消耗 1 credit。如需先发现 URL，请使用 [`post_firecrawl-map`](/docs/zh/api-reference/search/post_firecrawl-map)；如需一次抓取多页，请使用 [`post_firecrawl-batch-scrape`](/docs/zh/api-reference/search/post_firecrawl-batch-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 对应的美元费率取决于你的等级（normal
    $0.005，vip $0.004，svip $0.0034）。
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 返回清洗后的正文内容。在 AIsa 计量模式下该请求受限：URL 必须是 HTTPS
        且不能指向 PDF，proxy 必须设为 "basic"，如果提供 formats，其值必须正好是
        ["markdown"]。高级选项（actions、headers、parsers、profile、lockdown、zeroDataRetention）会被拒绝。每抓取一页计
        1 个 Firecrawl credit。
      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

````