Skills + CLI

# Globale Installation
npm install -g @thunderbit/thunderbit-cli

# Oder einmalig per npx ausführen
npx -y @thunderbit/thunderbit-cli --help

export THUNDERBIT_API_KEY=tb_YOUR_API_KEY

thunderbit --api-key tb_YOUR_API_KEY distill https://example.com

# Pro Aufruf
thunderbit --base-url https://api.your-domain.com distill https://example.com

# Oder per Umgebungsvariable
export THUNDERBIT_API_BASE_URL=https://api.your-domain.com
thunderbit distill https://example.com

thunderbit --version
# oder
thunderbit -V

# Grundlegende Verwendung
thunderbit distill https://example.com/article

# Markdown nach stdout streamen
thunderbit distill https://example.com --format markdown

# In Datei speichern
thunderbit distill https://example.com --format markdown > article.md

# Basic-JS-Renderer verwenden (deckt die meisten modernen Sites ab)
thunderbit distill https://example.com --render-mode basic

# Vollen Headless-Browser nutzen (am langsamsten, höchste Genauigkeit)
thunderbit distill https://example.com --render-mode full

# Geo-Targeting für regionsspezifische Sites
thunderbit distill https://example.com --country-code DE

# Timeout pro Seite erhöhen
thunderbit distill https://example.com --timeout 60000

# Synchrones /distill statt des standardmäßigen async submit + poll
thunderbit distill https://example.com --sync

# Inline-Schema — flache Map aus Feld → Anweisung
thunderbit extract https://example.com/product \
  --schema '{"name":"product name","price":"the listed price as a number","currency":"3-letter currency code"}'

# Schema aus Datei
thunderbit extract https://example.com/product --schema ./schema.json

# Extrahiertes JSON speichern
thunderbit extract https://example.com/product --schema ./schema.json --format json -o data.json

{
  "success": true,
  "data": {
    "url": "https://example.com/product",
    "data": [
      { "name": "iPhone 15 Pro", "price": 999, "currency": "USD" }
    ]
  }
}

# Die KI schlägt Felder vor, du toggelst/editierst, dann läuft die Extraktion mit dem kuratierten Schema
thunderbit extract https://example.com/product --interactive

# Vorschlag mit Prompt steuern
thunderbit extract https://example.com/product -i --prompt "focus on pricing and availability"

# Schema zur Wiederverwendung speichern
thunderbit extract https://example.com/product -i --save-schema ./product-schema.json

# Render-Zeit für SPAs erhöhen
thunderbit extract https://example.com --schema ./schema.json --render-mode full

# Sync-Modus
thunderbit extract https://example.com --schema ./schema.json --sync

# Längeres Timeout für komplexe Seiten
thunderbit extract https://example.com --schema ./schema.json --timeout 120000

# Grundlegend
thunderbit suggest-fields https://example.com/product

# Mit Prompt steuern
thunderbit suggest-fields https://example.com/listings --prompt "extract job postings only"

# Regionsspezifisch
thunderbit suggest-fields https://example.com --country-code DE

# URLs als Positionsargumente
thunderbit batch distill https://a.com https://b.com https://c.com

# Oder URLs aus Datei lesen (eine pro Zeile)
thunderbit batch distill --file urls.txt

# Nur einreichen — Job-ID ausgeben und beenden (Webhook nutzen oder später pollen)
thunderbit batch distill --file urls.txt --no-poll

# Timeout pro Seite erhöhen
thunderbit batch distill --file urls.txt --timeout 60000

# Ergebnisse in ein anderes Tool pipen
thunderbit batch distill --file urls.txt --format json \
  | jq -r '.data.results[] | select(.success == true) | .markdown' \
  > distilled.md

thunderbit batch cancel-distill <jobId>

# URLs als Positionsargumente + Inline-Schema
thunderbit batch extract https://a.com https://b.com \
  --schema ./schema.json

# URLs aus Datei lesen
thunderbit batch extract --file urls.txt --schema ./schema.json

# Nur einreichen
thunderbit batch extract --file urls.txt --schema ./schema.json --no-poll

thunderbit batch cancel-extract <jobId>

# Markdown in ein anderes Tool pipen
thunderbit distill https://example.com --format markdown | head -50

# In Datei umleiten
thunderbit distill https://example.com --format markdown > output.md

# Extraktions-JSON speichern
thunderbit extract https://example.com --schema ./schema.json --format json > data.json

# Markdown-Body direkt auf Disk
thunderbit distill https://example.com --format markdown

# Vollständige strukturierte Antwort
thunderbit distill https://example.com --format json

# Einen Artikel destillieren
thunderbit distill https://docs.thunderbit.com/introduction --format markdown

# HTML-konvertiertes Markdown auf Disk speichern
thunderbit distill https://example.com --format markdown -o page.md

# Eine Doku-Site aus urls.txt destillieren und jede Seite auf Disk schreiben
thunderbit batch distill --file urls.txt --format json \
  | jq -r '.data.results[] | select(.success == true) | "\(.url)\t\(.markdown)"' \
  > corpus.tsv

# Schritt 1: KI schlägt Felder vor, du kuratierst, Schema wird auf Disk gespeichert
thunderbit extract https://example.com/product -i --save-schema ./schema.json

# Schritt 2: über den ganzen Katalog wiederverwenden
thunderbit batch extract --file urls.txt --schema ./schema.json --format json > products.json

thunderbit extract "$URL" --schema ./schema.json --format json \
  | jq -e '.data | length > 0'

# URLs aus einer JSON-Suchergebnisantwort herausziehen
thunderbit distill https://example.com --format json \
  | jq -r '.data.metadata.canonicalUrl'

# Destillierten Inhalt zur Zusammenfassung in ein Modell pipen
thunderbit distill "$URL" --format markdown \
  | claude -p "summarise the article in 5 bullets"

# Erfolgreiche Seiten in einem Batch zählen
thunderbit batch distill --file urls.txt --format json \
  | jq '[.data.results[] | select(.success == true)] | length'