Thunderbit Web Scraping

Open-source toolkit for the Thunderbit Open API — CLI, MCP server, and Claude Code plugin.

npm: @thunderbit/mcp-server npm: @thunderbit/thunderbit-cli License: MIT

This monorepo ships three packages, all backed by the Thunderbit Open API:

Package	Purpose	Audience
@thunderbit/thunderbit-cli	Command-line tool for distill / extract / batch	Developers, scripts, CI
@thunderbit/mcp-server	Model Context Protocol server (7 tools)	AI assistants — Claude Desktop, Cursor, Cline, Claude Code
thunderbit Claude Code plugin	Bundled MCP + 4 skills	Claude Code users

Get a free API key at app.thunderbit.com/console/api-keys.

---

Quick Start

CLI

npm i -g @thunderbit/thunderbit-cli
export THUNDERBIT_API_KEY=tb_your_api_key_here
thunderbit distill https://example.com -f markdown

MCP Server (Claude Desktop / Cursor / Cline)

Edit your MCP client config:

{
  "mcpServers": {
    "thunderbit": {
      "command": "npx",
      "args": ["-y", "@thunderbit/mcp-server"],
      "env": { "THUNDERBIT_API_KEY": "tb_your_api_key_here" }
    }
  }
}

Claude Code Plugin

claude plugin marketplace add thunderbit-com/thunderbit-mcp-server
claude plugin add thunderbit
export THUNDERBIT_API_KEY=tb_your_api_key_here

---

What you can do

• Convert any web page into clean, LLM-ready Markdown
• Extract structured data from pages using JSON Schema
• Get AI-suggested fields when you don't know what's on a page
• Run batch jobs on up to 100 URLs at a time

---

Pricing

Distill — 1 credit. Extract — 20 credits. Suggest fields — free. Batch jobs scale per URL. Status polling is free.

Top up at app.thunderbit.com/console/billing.

---

Development

git clone https://github.com/thunderbit-com/thunderbit-mcp-server.git
cd thunderbit-mcp-server
# each package is independent
cd packages/mcp-server && npm install
cd packages/cli && npm install

---

API Reference

The full HTTP contract is documented in openapi.yaml (OpenAPI 3.1) — base URL https://openapi.thunderbit.com, Bearer auth with your THUNDERBIT_API_KEY.

---

License

MIT © Thunderbit