openbd-cli

CLI for OpenBD API. Built with Go + Cobra.

Install

go install github.com/lumiere/openbd-cli@latest

Or build from source:

git clone git@github.com:dugabot0/openbd-cli.git
cd openbd-cli
go build -o openbd-cli .

Usage

openbd-cli [command] [flags]

Global Flags

Flag	Description
--pretty	Pretty-print JSON output
--quiet	Suppress stderr log output
--timeout	HTTP request timeout (default 30s)

Books

# Get book info by ISBN
openbd-cli books get 9784780802047 --pretty

# Get multiple books at once
openbd-cli books get 9784780802047 9784873117386 --pretty

# List all ISBNs in the database (very large response)
openbd-cli books coverage

# Get the JSON schema for /get response
openbd-cli books schema --pretty

Response Format

The books get command returns a JSON array. Each element corresponds to a requested ISBN (in order). If an ISBN is not found, its element is null.

Each book record has three sections:

Section	Description
summary	Simplified view: isbn, title, volume, series, author, publisher, pubdate, cover
onix	Full JPRO-ONIX standard metadata
hanmoto	Publisher-specific fields (reviews, stock status, etc.)

Notes

• No authentication required — the API is fully public
• No rate limits — designed for high-volume access

License

MIT