_jLSrSSKJr SSKJrJrJrJrJrJ r SSK r SSK J r J r SSKJr SSKJr SS KJrJrJr \ R."S 5r"S S 5r"S S5r"SS5r"SS5r"SS5r"SS5r\r\r g)a Firecrawl Client A Firecrawl client that enables you to scrape content from websites, crawl entire sites, search the web, and extract structured data using AI. The client supports both v1 and v2 API versions, providing access to features like: - Web scraping with advanced options (screenshots, markdown conversion, etc.) - Site crawling with configurable depth and limits - Web search with content extraction - Structured data extraction using AI models - Deep research capabilities Usage: from firecrawl import Firecrawl firecrawl = Firecrawl(api_key="your-api-key") result = firecrawl.scrape("https://example.com") Check example.py for other usage examples. )Path)AnyDictOptionalListUnionBinaryION)V1FirecrawlAppAsyncV1FirecrawlApp)FirecrawlClient)AsyncFirecrawlClient)Document ParseOptions ScrapeOptions firecrawlc>\rSrSr%Sr\\\S'S\\4SjrSr g)V1Proxy!+Type-annotated proxy for v1 client methods._clientclient_instancectXlU(aURUlURUlURUlURUlUR UlUR UlURUlURUlURUl URUl ggN r scrape_url crawl_urlbatch_scrape_urlsasync_batch_scrape_urlsasync_crawl_urlcheck_crawl_statusmap_urlextract deep_researchgenerate_llms_textselfrs E/home/rurouni/.local/lib/python3.13/site-packages/firecrawl/client.py__init__V1Proxy.__init__%& -88DO,66DN%4%F%FD "+:+R+RD (#2#B#BD &5&H&HD #*22DL*22DL!0!>!>D &5&H&HD #  rrr rr!rr$r#r%r"rN) __name__ __module__ __qualname____firstlineno____doc__rr __annotations__r)__static_attributes__r,r(rr!s#5 n %% I(@ Ir,rcD\rSrSr%Sr\\\S'S\\4SjrSr Sr g) V2Proxy4IProxy class that forwards method calls to the appropriate version client.rrcXlU(Ga1URUlURUlURUlURUlURUlURUlURUlURUlURUl URUl URUl URUl URUl URUlURUlUR UlUR"UlUR$UlUR&UlUR(UlUR*UlUR,UlUR.UlUR0UlUR2UlUR4UlUR6UlUR8UlUR:UlUR<UlUR>UlUR@Ul URBUl!URDUl"URFUl#URHUl$URJUl%URLUl&URNUl'URPUl(URRUl)URTUl*URVUl+URXUl,URZUl-UR\Ul.UR^Ul/UR`Ul0ggr)1rscrapeinteractstop_interactionstop_interactive_browserscrape_executedelete_scrape_browserparsesearchcrawl start_crawlget_crawl_statusget_crawl_status_page cancel_crawlget_crawl_errorsget_active_crawls active_crawlscrawl_params_previewr# start_extractget_extract_statusagent start_agentget_agent_status cancel_agentstart_batch_scrapeget_batch_scrape_statusget_batch_scrape_status_pagecancel_batch_scrape batch_scrapeget_batch_scrape_errorsmapcreate_monitor list_monitors get_monitorupdate_monitordelete_monitor run_monitorlist_monitor_checksget_monitor_checkget_concurrencyget_credit_usageget_token_usageget_queue_statusbrowserbrowser_executedelete_browser list_browserswatcherr&s r(r)V2Proxy.__init__8s& )00DK+44DM$3$D$DD !,;,T,TD )"&--D )-)>)>D &(..DJ)00DK(..DJ.::D $3$D$DD !)8)N)ND & / < !>D (7(L(LD %*22DL!0!>!>D &5&H&HD #(..DJ.::D $3$D$DD ! / < !>D .::D "1"@"@D "1"@"@D .::D '6'J'JD $%4%F%FD "#2#B#BD $3$D$DD !#2#B#BD $3$D$DD !*22DL#2#B#BD "1"@"@D !0!>!>D *22DLm r,c.[URU5$)2Forward attribute access to the underlying client.)getattrrr'names r( __getattr__V2Proxy.__getattr__sst||T**r,)1rrJrNrVrerfrQrUrGrCrKrYrgr]r@r#rIrPrWrSrTrarHrErFrbrMr[r`rdrcr<rhr_rZrXrAr^r;r?rBrOrRrDrLr=r>r\riN) r.r/r0r1r2rV2FirecrawlClientr3r)rpr4r5r,r(r7r74s)S ' ((931B(C93v+r,r7c>\rSrSr%Sr\\\S'S\\4SjrSr g) AsyncV1ProxywrrrctXlU(aURUlURUlURUlURUlUR UlUR UlURUlURUlURUl URUl ggrrr&s r(r)AsyncV1Proxy.__init__{r+r,r-N) r.r/r0r1r2rr r3r)r4r5r,r(rtrtws%5 ) ** I1D(E Ir,rtcL\rSrSr%SrSr\\\S'S S\\4Sjjr Sr Sr g) AsyncV2Proxyr9NrrcXlU(GaSURUlURUlURUlURUlURUlURUlURUlURUlURUl URUl URUl URUl URUl URUlURUlUR UlUR"UlUR$UlUR&UlUR(UlUR*UlUR,UlUR.UlUR0UlUR2UlUR4UlUR6UlUR8UlUR:UlUR<UlUR>UlUR@Ul URBUl!URDUl"URFUl#URHUl$URJUl%URLUl&URNUl'URPUl(URRUl)URTUl*URVUl+URXUl,URZUl-UR\Ul.UR^Ul/UR`Ul0URbUl1URdUl2ggr)3rr;r<r=r>r?r@rArBrCrD wait_crawlrErFrGrHrIrJrKr#rLrMrNrOrPrQrRrSrTrUwait_batch_scraperVrWrXrYrZr[r\r]r^r_r`rarbrcrdrerfrgrhrir&s r(r)AsyncV2Proxy.__init__s& )00DK+44DM$3$D$DD !,;,T,TD )"&--D )-)>)>D &(..DJ)00DK(..DJ.::D -88DO$3$D$DD !)8)N)ND & / < !>D (7(L(LD %*22DL!0!>!>D &5&H&HD #(..DJ.::D $3$D$DD ! / < !>D .::D "1"@"@D "1"@"@D .::D '6'J'JD $%4%F%FD "#2#B#BD $3$D$DD !#2#B#BD $3$D$DD !*22DL#2#B#BD "1"@"@D !0!>!>D *22DLq r,clUR(a[URU5$[SU35e)rlz%Async v2 client not implemented yet: )rrmAttributeErrorrns r(rpAsyncV2Proxy.__getattr__s- <<4<<. .DTFKLLr,)3rrJrNrVrerfrQrUrGrCrKrYrgr]r@r#rIrPrWrSrTrarHrErFrbrMr[r`rdrcr<rhr_rZrXrAr^r;r?rBrOrRrDrLr=r>r\r}r|rir) r.r/r0r1r2rrrr3r)rpr4r5r,r(ryrys.S.2GX* +2;31E(F;3zMr,ryc \rSrSrSrSS\S\S\S\S\4 S jjrSSSS .S \ \\ \ \ \ 4S \\S \\S\\S\4 SjjrSrg) Firecrawlz Unified Firecrawl client (v2 by default, v1 under ``.v1``). Provides a single entrypoint that exposes the latest API directly while keeping a feature-frozen v1 available for incremental migration. Napi_keyapi_urltimeout max_retriesbackoff_factorc XlX l[(a [XS9OSUl[(a [ UUUUUS9OSUlUR(a[ UR5OSUl[UR 5Ul UR RUl UR RUl UR RUl UR RUl URUlURUlUR R UlUR R"UlUR R$UlUR R&UlUR R(UlUR R*UlUR R,UlUR R.UlUR R0UlUR R2UlUR R4UlUR R6UlUR R8UlUR R:UlUR R<UlUR R>UlUR R@Ul UR RBUl!UR RDUl"UR RFUl#UR RHUl$UR RJUl%UR RLUl&UR RNUl'UR RPUl(UR RRUl)UR RTUl*UR RVUl+UR RXUl,UR RZUl-UR R\Ul.UR R^Ul/UR R`Ul0UR RbUl1UR RdUl2UR RfUl3UR RhUl4UR RjUl5UR RlUl6UR RnUl7UR RpUl8UR RrUl9g)asInitialize the unified client. Args: api_key: Firecrawl API key (or set ``FIRECRAWL_API_KEY``) api_url: Base API URL (defaults to production) timeout: Default request timeout in seconds for all HTTP requests max_retries: Maximum number of retries for failed requests (default: 3) backoff_factor: Exponential backoff factor for retries (default: 0.5) rrNrrrrr):rrr _v1_clientrr _v2_clientrv1r7v2r;r<r=r>r?r@rArBrXrYrZr[r\r]r^r_r`rCrDrKrErFrGrHrIrJrRrSrTrUrVrWrLrMr#rOrPrQrNrarbrcrdrerfrgrhrir'rrrrrs r(r)Firecrawl.__init__s"  O]n.Jbf  ,#)  %) /3oo'$//*4$//*oo,, 00 $ @ @(,(P(P%"mm%)%:%:"__** oo,, ??&&"oo<<!__::??66"oo<<"oo<<??66#'??#F#F !%!B!B__** ??66$(OO$H$H! $ @ @%)__%J%J" OO88 $ @ @!%!B!B!__::"&//"D"D'+'N'N$,0OO,X,X)#'??#F#F  OO88'+'N'N$!__::"&//"D"D.. ??66 $ @ @ OO88__** #>> $ @ @#>> $ @ @.. #>>"oo<<!__::.. r,filename content_typeoptionsfilerrrreturnc:URRUUUUS9$)1Parse an uploaded file via the v2 parse endpoint.rrrAr'rrrrs r(rAFirecrawl.parse4s,$$ % %  r,)6rrrJrNrrrVrerfrQrUrGrCrKrYrgr]r@r#rIrPrWrSrTrarHrErFrbrMr[r`rdrcr<rhr_rZrXrAr^r;r?rBrOrRrDrLr=r>r\rrriNzhttps://api.firecrawl.devNg?r.r/r0r1r2strfloatintr)rrbytes bytearrayr rrrrAr4r5r,r(rrs2 # X/X/X/ X/  X/  X/|#'&**.  Cui9: 3-  sm  ,'     r,rc \rSrSrSrSS\S\S\S\S\4 S jjrSSSS .S \ \\ \ \ \ 4S \\S \\S\\S\4 SjjrSrg)AsyncFirecrawliDzAAsync unified Firecrawl client (v2 by default, v1 under ``.v1``).Nrrrrrc XlX l[(a [XS9OSUl[(a [ UUUUUS9OSUlUR(a[ UR5OSUl[UR 5Ul UR RUl UR RUl UR RUl UR RUl URUlURUlUR R UlUR R"UlUR R$UlUR R&UlUR R(UlUR R*UlUR R,UlUR R.UlUR R0UlUR R2UlUR R4UlUR R6UlUR R8UlUR R:UlUR R<UlUR R>UlUR R@Ul UR RBUl!UR RDUl"UR RFUl#UR RHUl$UR RJUl%UR RLUl&UR RNUl'UR RPUl(UR RRUl)UR RTUl*UR RVUl+UR RXUl,UR RZUl-UR R\Ul.UR R^Ul/UR R`Ul0UR RbUl1UR RdUl2UR RfUl3UR RhUl4UR RjUl5UR RlUl6UR RnUl7UR RpUl8g)Nrr)9rrr rrrrtrryrr;r<r=r>r?r@rArBrXrYrZr[r\r]r^r_r`rDrErFrGrCrHrJrKrRrSrTrUrVrWrLrMr#rOrPrQrNrarbrcrdrerfrgrhrirs r(r)AsyncFirecrawl.__init__Gs  TgSf-gOlp" ! /#)  (, 48??,t/t/oo,, 00 $ @ @(,(P(P%"mm%)%:%:"__** oo,, ??&&"oo<<!__::??66"oo<<"oo<<??66#'??#F#F !%!B!B??66 $ @ @%)__%J%J" OO88__** $ @ @!__::$(OO$H$H!"&//"D"D'+'N'N$,0OO,X,X)#'??#F#F  OO88'+'N'N$!__::"&//"D"D.. ??66 $ @ @ OO88__** #>> $ @ @#>> $ @ @.. #>>"oo<<!__::.. r,rrrrrrcV# URRUUUUS9IShvN $N7f)rrNrrs r(rAAsyncFirecrawl.parses9__** % +    s )'))5rrrJrNrrrVrerfrQrUrGrCrKrYrgr]r@r#rPrWrSrTrarHrErFrbrMr[r`rdrcr<rhr_rZrXrAr^r;r?rBrOrRrDrLr=r>r\rrrirrr5r,r(rrDsK2 # P/P/P/ P/  P/  P/l#'&**.  Cui9: 3-  sm  ,'     r,r)!r2pathlibrtypingrrrrrr loggingrr r rr rrv2.client_asyncrv2.typesrrr getLoggerloggerrr7rtryrr FirecrawlAppAsyncFirecrawlAppr5r,r(rs(==441;;   ; 'II&A+A+FII&EMEMPp p dc c L "r,