Babeliocli

babeliocli — a read-only, agent-friendly CLI for Babelio

[](https://github.com/yoanbernabeu/babeliocli/actions/workflows/ci.yml) [](https://opensource.org/licenses/MIT) [](https://goreportcard.com/report/github.com/yoanbernabeu/babeliocli)

`babeliocli` is an unofficial, read-only command-line client for [babelio.com](https://www.babelio.com) — the French book community. It is built for shell scripting and AI coding agents: every command emits JSON by default (`-f text` is available for humans), errors go to stderr, and exit codes are meaningful.

Babelio does not expose a public API, so `babeliocli` authenticates through the regular web form (or imports cookies from your browser for Google/Facebook SSO) and parses the HTML of the logged-in pages.

Features

• Read your shelves (lus, à lire, en cours, pense-bête, abandonnés, critiqués, non critiqués) with exact counts
• List books per shelf with title, author IDs, rating, reading status, start/end dates, number of readers
• Search the catalogue by title, author, or free text
• Book details: synopsis, publisher, number of pages, average rating, review count, genres
• Reviews: paginated list of critiques with author, date (raw + ISO), rating, and full body
• JSON-first output, -f text for a readable terminal view
• Classic login (username / password) or cookie import for SSO-linked accounts
• Session file stored under $XDG_CONFIG_HOME/babeliocli/session.json (mode 0600)
• Expired-session detection: commands return a clear error instead of silently returning empty data
• Proper ISO-8859-1 → UTF-8 charset handling (Babelio still serves legacy Latin-1 HTML)

Install

One-liner (Linux / macOS, amd64 / arm64):

curl -fsSL https