Skip to main content
POST
Scrape a single page and return its main content as markdown.
Fetch one URL and get its main content back as markdown. url and proxy are both required — proxy must be basic on the metered profile — and formats selects the output. Returns success and data with markdown plus a large metadata object carrying the page’s og: and twitter: tags, statusCode, sourceURL and language. Measured at about 10 seconds for one page. ⚠️ The URL must be HTTPS and must not point at a PDF; both are rejected rather than best-effort. Use it when you have the URL and want the text. For several URLs at once post_firecrawl_batch_scrape runs them as one background job, and post_tavily_extract does a small batch synchronously. To find URLs first, post_firecrawl_map.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.
Set this endpoint up in your agent →

Authorizations

Authorization
string
header
required

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

Body

application/json
url
string<uri>
required

The HTTPS URL to scrape. PDF URLs are not supported on the metered profile.

Example:

"https://docs.firecrawl.dev"

proxy
enum<string>
required

Proxy tier. Must be explicitly set to "basic" on the metered profile.

Available options:
basic
Example:

"basic"

formats
enum<string>[]

Optional output formats. When present it must be exactly ["markdown"].

Available options:
markdown
Example:

Response

200 - application/json

Scrape completed successfully.

success
boolean

True when the scrape succeeded.

data
object
creditsUsed
integer

Firecrawl credits consumed by the request (1 per page).