Perplexed.Scraper.Firecrawl (Perplexed v0.2.0)

Copy Markdown View Source

Firecrawl v2 scrape as a Perplexed.Scraper.

Firecrawl renders JavaScript and handles many protected sites, at one credit per HTML page, priced by credit_usd/0 (the firecrawl_credit_usd setting). Accepts a cached copy up to a day old (:max_age_ms).

Firecrawl also reads PDFs, at one credit per PDF page. A ladder hands it a PDF the free tiers could not convert (no Perplexed.PdfConverter configured) only with firecrawl_pdf: true in the settings; otherwise a PDF ends the climb unread rather than billing per page. With a local converter configured, PDFs never reach Firecrawl.

Needs config :perplexed, firecrawl_api_key:.

Summary

Functions

USD per Firecrawl credit: the firecrawl_credit_usd setting, else 9.9e-4 (the Standard plan's $99 for 100,000). Set it to what your plan pays, for example 0.0038 on Hobby, or about 0.0025 for credits bought past a Standard allowance (all as of 2026-11-10). A scraped page is one credit, a PDF one per page; a search is two (see Perplexed.Search.Firecrawl).

Functions

credit_usd()

@spec credit_usd() :: float()

USD per Firecrawl credit: the firecrawl_credit_usd setting, else 9.9e-4 (the Standard plan's $99 for 100,000). Set it to what your plan pays, for example 0.0038 on Hobby, or about 0.0025 for credits bought past a Standard allowance (all as of 2026-11-10). A scraped page is one credit, a PDF one per page; a search is two (see Perplexed.Search.Firecrawl).