跳转到主要内容
POST
Reference example
搜索网页,返回排序后的结果。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。
第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。之后智能体通过几个元工具调用所有端点: search、list_categories、get_details 和 batch_quote 免费,batch_use 按次计费。各客户端的接入步骤见通过 MCP 连接;实时工具列表和 每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

请求规范

  • 方法与路径: POST /apis/v1/firecrawl/search
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/firecrawl/search
  • Runtime 事实版本: 82ca6e32a3422a9fdc47fb987d84d177f6e0ef05d5eae36691e5f7b3911d092f
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

按用量计费;默认请求预估费用:$0.002142 USD(不是固定价格)。 声明的单位费率:每 firecrawl_credit $0.001071 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.002142
  • 声明的单位费率(USD): 0.001071
  • 计费单位: firecrawl_credit
  • 计费依据: response_count
  • 公开参考倍率: 1.0
  • 声明的最大计数或单位数: 100
  • 结算证据来源: response_body

预留单位(不是结算用量)

请查看完整定义中的声明;此处不推测公式。
  • 声明的输入倍率: 2
  • 声明的缩放除数: 10
  • 声明的取整规则: ceil
  • 公开请求参数: limit

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
query
string
必填
Required string length: 1 - 2000
enterprise
enum<boolean>
默认值:false
可用选项:
false
limit
integer
默认值:10
必填范围: 1 <= x <= 100
sources
string[]
Required array length: 1 element

响应

搜索成功完成。

creditsUsed
integer

消耗的 Firecrawl credits(约每 10 条结果 2 个)。

data
object
success
boolean

搜索成功时为 true。