> ## 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 Map

> 列出从某个起始页可达的 URL，不抓取任何内容。

列出从某个起始页可达的 URL，不抓取任何内容。`url` 和 `limit` 都必填（limit 1 到 100000）。返回 `success`、请求 `id` 和 `links[]`，每条含 `url` 和 `title` —— 注意这里是**带标题的对象**，而 [`post_tavily_map`](/docs/zh/api-reference/search/post_tavily-map) 返回的是裸字符串。实测约 9 秒。**每发现一个链接计 1 个 credit**，所以 `limit` 是成本控制而不只是数量控制。用它在付费爬取前先估算站点规模，再用 [`post_firecrawl_scrape`](/docs/zh/api-reference/search/post_firecrawl-scrape) 只取需要的。想一次同时拿到结构和内容，用 [`post_firecrawl_crawl`](/docs/zh/api-reference/search/post_firecrawl-crawl)。

<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-map)


## OpenAPI

````yaml openapi/zh/firecrawl.json POST /firecrawl/map
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/map:
    post:
      tags:
        - https://docs.firecrawl.dev/api-reference/endpoint/map
      summary: 发现网站上的 URL。
      description: >-
        列出从某个起始页可达的 URL，不抓取任何内容。`url` 和 `limit` 都必填（limit 1 到 100000）。返回
        `success`、请求 `id` 和 `links[]`，每条含 `url` 和 `title` —— 注意这里是**带标题的对象**，而
        `post_tavily_map` 返回的是裸字符串。实测约 9 秒。**每发现一个链接计 1 个 credit**，所以 `limit`
        是成本控制而不只是数量控制。用它在付费爬取前先估算站点规模，再用 `post_firecrawl_scrape`
        只取需要的。想一次同时拿到结构和内容，用 `post_firecrawl_crawl`。
      operationId: post_firecrawl_map
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                  description: 要做 map 的 HTTPS URL。
                  example: https://docs.firecrawl.dev
                limit:
                  type: integer
                  minimum: 1
                  maximum: 100000
                  description: 要发现的链接数量上限。在计量模式下为必填。
                  example: 100
              required:
                - url
                - limit
      responses:
        '200':
          description: map 成功完成。
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: map 成功时为 true。
                  links:
                    type: array
                    description: 发现的链接。
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: 一个已发现的 URL。
                        title:
                          type: string
                          description: 所发现页面的标题（如果有）。
                  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.