langchain-thecrawler 0.1.0

An integration package connecting TheCrawler and LangChain

langchain-thecrawler

This package contains the LangChain integration with TheCrawler — a web-scraping and structured-extraction API that runs the extraction LLM on its own GPU, so AI extraction is included on every page with no per-call surcharge.

Installation

pip install -U langchain-thecrawler

Set your API key (get one at miaibot.ai):

export THECRAWLER_API_KEY="mai_live_..."

Document Loader

TheCrawlerLoader loads one or more URLs as LangChain Document objects with boilerplate-stripped markdown as page_content and rich page metadata.

from langchain_thecrawler import TheCrawlerLoader

loader = TheCrawlerLoader(
    ["https://example.com"],
    # api_key="mai_live_...",  # or set THECRAWLER_API_KEY
)

docs = loader.load()        # list[Document]
# or stream:
for doc in loader.lazy_load():
    print(doc.metadata["url"], len(doc.page_content))

PDF and DOCX URLs are handled server-side. A per-page failure does not raise — failed pages come back as a Document with empty page_content and metadata["status"] == "error" plus a structured error_type, so you can branch on it:

ok = [d for d in docs if d.metadata.get("status") != "error"]

Options

Arg	Description
urls	A URL string or list of URLs (required)
api_key	TheCrawler key; falls back to THECRAWLER_API_KEY
api_url	API base URL (default https://www.miaibot.ai/api/v1)
params	Extra options merged into the crawl request (e.g. {"usePlaywright": True})
timeout	Per-request HTTP timeout in seconds (default 120)

License

MIT