Kommandozeilen-Tool und TypeScript-Bibliothek

`ddb`

Das digitalisierte Kulturerbe Deutschlands direkt im Terminal durchsuchen. ddb ist ein Kommandozeilen-Tool für die v2-API der Deutschen Digitalen Bibliothek: Dutzende Millionen Objekte aus deutschen Archiven, Bibliotheken, Museen und Forschungseinrichtungen – durchsuchbar, facettiert und als sauberes JSON, das Sie direkt an jq weitergeben können.

Version 0.0.5 npm GitHub API-Referenz

Installation

Benötigt Node.js 20 oder neuer. Installiert den Befehl ddb:

npm i -g @maschinenlesbar.org/deutsche-digitale-bibliothek-cli

Zugang

Kein Konto, kein API-Schlüssel, keine Konfiguration – installieren und loslegen.

Schnellstart

# Search objects matching a keyword (10 results by default)
ddb search Goethe

# How many objects match in total?
ddb search Goethe | jq '.response.numFound'

# Narrow to images in Berlin, and count the type distribution
ddb search Goethe --filter 'place_fct:"Berlin"' --filter type_fct:mediatype_002 --facet objecttype_fct

# Grab an object id from a result, then fetch its detail
ddb search Goethe --fields id | jq -r '.response.docs[0].id'
ddb item TNPFDKO2VDGBZ72RWC6RKDNZYZQZP3XK

Befehle

Die Beschreibungen der Befehle stammen direkt aus der CLI und sind englisch.

search

Search cultural-heritage objects via the v2 Solr index (returns native Solr JSON)
item

Fetch one item component by its 32-character id (GET /2/items/{id})
version

Print the DDB backend version — a quick connectivity check (no key needed)

Alle Befehle, Argumente und Optionen →

Skills für Claude Code

Das Plugin ddb bringt Claude bei, ddb zu nutzen. Installation über den Marketplace von maschinenlesbar.org:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install ddb@maschinenlesbar

/ddb:ddb-item
/ddb:ddb-search

Was die Skills beantworten, mit echten Beispielen → Beschreibungen und Voraussetzungen der Skills →

TypeScript-Bibliothek

@maschinenlesbar.org/deutsche-digitale-bibliothek-cli ist auch ein typisierter API-Client, den Sie in eigenem Code importieren können – ohne HTTP-Abhängigkeiten zur Laufzeit.

API-Referenz → Nutzung als Bibliothek und Architektur →

Das Werkzeug, nicht die Daten

Die Daten stammen vom Anbieter hinter der API und unterliegen dessen Bedingungen – siehe DATA_LICENSE.md. Der Code steht unter AGPL-3.0-or-later oder einer kommerziellen Lizenz – siehe LICENSING.md.