跳转到主要内容
POST
Reference example
抓取一个 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。
第一次用? 把任意 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/scrape
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/firecrawl/scrape
  • Runtime 事实版本: 82ca6e32a3422a9fdc47fb987d84d177f6e0ef05d5eae36691e5f7b3911d092f
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

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

声明的请求计费单位

  • 单位数: 1

授权

Authorization
string
header
必填

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

请求体

application/json
proxy
enum<string>
必填
可用选项:
basic
url
string<https_url>
必填
formats
string[]
Required array length: 1 element
onlyCleanContent
enum<boolean>
可用选项:
false

响应

抓取成功完成。

creditsUsed
integer

该请求消耗的 Firecrawl credits(每页 1 个)。

data
object
success
boolean

抓取成功时为 true。