Set up the Firecrawl Python SDK (firecrawl-py): install, auth, scrape, and structured extraction

Documented steps

1. Auth: SDK wraps the v2 Bearer-token REST API. Pass api_key="fc-..." to the client, or set the FIRECRAWL_API_KEY environment variable and construct with no arguments.
2. Install: pip install firecrawl-py; get an API key (fc-...) from the Firecrawl dashboard.
3. Initialize: from firecrawl import Firecrawl; app = Firecrawl(api_key="fc-YOUR-API-KEY") - or set FIRECRAWL_API_KEY and call Firecrawl().
4. Basic scrape: result = app.scrape("https://example.com"); print(result.markdown).
5. Structured extraction: build a Pydantic model, then result = app.scrape(url, formats=[{"type":"json","schema":MyModel.model_json_schema()}]) and read result.json.
6. Batch scrape (blocking, polls internally): job = app.batch_scrape([url1, url2], formats=["markdown"], poll_interval=2, wait_timeout=120).
7. Wrap calls in try/except for API-level failures (402 out of credits, 429 rate limited, 500 server error); confirm exact exception classes against your installed firecrawl-py version - they are not enumerated in the docs pages.
8. Official docs: https://docs.firecrawl.dev/quickstarts/python ; https://docs.firecrawl.dev/features/batch-scrape ; https://docs.firecrawl.dev/api-reference/v2-introduction