Integrations

LangChain

Use Thunderbit as a document loader or tool inside a LangChain agent

Drop Thunderbit into a LangChain pipeline as a document loader (for RAG ingestion) or a tool (for agent-driven web research).

Install

pip install langchain-core httpx

As a document loader

from langchain_core.documents import Document
import httpx, time

API = "https://openapi.thunderbit.com/openapi/v1"
H = {"Authorization": "Bearer YOUR_API_KEY"}

class ThunderbitLoader:
    def __init__(self, urls: list[str]):
        self.urls = urls

    def load(self) -> list[Document]:
        # 1. submit batch — POST returns {id, status, total, ...}, no `results` yet
        job_id = httpx.post(f"{API}/batch/distill",
                            headers=H,
                            json={"urls": self.urls}).json()["data"]["id"]
        # 2. poll until terminal — see Batch Job Lifecycle guide
        while True:
            data = httpx.get(f"{API}/batch/distill/{job_id}", headers=H).json()["data"]
            if data["status"] in ("COMPLETED", "FAILED", "CANCELLED"):
                break
            time.sleep(5)
        # 3. read results from GET response (each item: {index, url, status, markdown, error})
        return [
            Document(page_content=r["markdown"], metadata={"source": r["url"]})
            for r in data.get("results", []) if r["status"] == "SUCCEEDED"
        ]

docs = ThunderbitLoader(["https://docs.example.com"]).load()

Pipe docs into your usual LangChain text splitter + vector store.

As an agent tool

from langchain_core.tools import tool

@tool
def read_url(url: str) -> str:
    """Fetch a URL and return clean Markdown for the agent to read.

    Use for any web research task: docs, articles, search results, product pages.
    """
    resp = httpx.post(f"{API}/distill",
                      headers=H,
                      json={"url": url, "renderMode": "basic"},
                      timeout=60.0)
    resp.raise_for_status()
    return resp.json()["data"]["markdown"]

# Pass [read_url] into create_react_agent / AgentExecutor / etc.

This integration is being expanded with a langchain-thunderbit package — check back soon.