> ## 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 搜索

> 搜索网页，返回排序后的结果。

搜索网页，返回排序后的结果。`query` 必填，`limit` 控制条数。返回 `success`、`creditsUsed`、一个请求 `id`，以及 `data.web[]`，每条含 `url`、`title`、`description`、`position` —— **只有标题和摘要，没有页面正文**。实测取 2 条约 15 秒，是这里最慢的搜索工具。按 Firecrawl credit 计费，约 `ceil(limit / 10) * 2`。在 AIsa 计量档位下只支持 web 源，`scrapeOptions`、企业模式和非 web 源都会被拒绝。什么时候该换：想在同一次调用里拿到正文 —— [`post_tavily_search`](/docs/zh/api-reference/search/post_tavily-search) 会返回，而且快三倍；已经知道 URL —— [`post_firecrawl_scrape`](/docs/zh/api-reference/search/post_firecrawl-scrape)；希望按语义而不是关键词判断相关性 —— [`post_exa_search`](/docs/zh/api-reference/search/post_exa-search)。

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


## OpenAPI

````yaml openapi/zh/firecrawl.json POST /firecrawl/search
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/search:
    post:
      tags:
        - https://docs.firecrawl.dev/api-reference/endpoint/search
      summary: 执行网页搜索并返回排序结果。
      description: >-
        搜索网页，返回排序后的结果。`query` 必填，`limit` 控制条数。返回 `success`、`creditsUsed`、一个请求
        `id`，以及 `data.web[]`，每条含 `url`、`title`、`description`、`position` ——
        **只有标题和摘要，没有页面正文**。实测取 2 条约 15 秒，是这里最慢的搜索工具。按 Firecrawl credit 计费，约
        `ceil(limit / 10) * 2`。在 AIsa 计量档位下只支持 web 源，`scrapeOptions`、企业模式和非 web
        源都会被拒绝。什么时候该换：想在同一次调用里拿到正文 —— `post_tavily_search` 会返回，而且快三倍；已经知道 URL ——
        `post_firecrawl_scrape`；希望按语义而不是关键词判断相关性 —— `post_exa_search`。
      operationId: post_firecrawl_search
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: 搜索查询词。必须非空，且不超过 500 字符。
                  maxLength: 500
                  example: firecrawl web scraping api
                limit:
                  type: integer
                  default: 10
                  minimum: 1
                  maximum: 100
                  description: 返回结果数量的上限。
              required:
                - query
      responses:
        '200':
          description: 搜索成功完成。
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: 搜索成功时为 true。
                  data:
                    type: object
                    properties:
                      web:
                        type: array
                        description: 排序后的网页搜索结果。
                        items:
                          type: object
                          properties:
                            title:
                              type: string
                              description: 结果标题。
                            url:
                              type: string
                              description: 结果 URL。
                            description:
                              type: string
                              description: 结果摘要片段。
                  creditsUsed:
                    type: integer
                    description: 消耗的 Firecrawl credits（约每 10 条结果 2 个）。
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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