Exceptions

Custom exceptions for IntelliScraper.

exception intelliscraper.exception.HTMLParserInputError

Bases: ValueError

Raised when the input provided to HTMLParser is invalid.

Typically occurs when html is None, empty, or not a string.

exception intelliscraper.exception.LocalBrowserConnectionError

Bases: Exception

Raised when unable to connect to a local browser via CDP.

This can happen when:

• Chrome is not running with --remote-debugging-port=9222.

• The debug profile is locked by another Chrome instance.

• The CDP endpoint is unreachable after the timeout period.

exception intelliscraper.exception.ScraperNotInitializedError

Bases: RuntimeError

Raised when scraper methods are called before initialisation.

Ensure you call await scraper.initialize() or use the async context manager (async with AsyncScraper() as scraper:) before calling scrape() or batch_scrape().

exception intelliscraper.exception.RateLimitExceededError

Bases: Exception

Raised when a server responds with HTTP 429 Too Many Requests.

This indicates the target site has detected too many requests from this client. Consider reducing max_requests_per_minute or adding delays between batches.

exception intelliscraper.exception.BotDetectionError

Bases: Exception

Raised when bot detection is triggered by the target site.

This typically manifests as HTTP 403 responses combined with CAPTCHA pages or JavaScript challenges. Consider using session data with the local browser backend for authenticated access.