yoanbernabeu/babeliocli · Archived
Read the authenticated user's Babelio shelves (lus, à lire, en cours, pense-bête, abandonnés, critiqués, non critiqués) using babeliocli.
npx skills add yoanbernabeu/babeliocli --skill babeliocli-library
This repository is archived — consider an actively maintained alternative.
Install babeliocli, authenticate against Babelio (password or SSO cookie import), and manage th…
2 installsSearch the Babelio catalogue, open a book's detail page, and read its reader critiques using ba…
2 installsTest Row Level Security (RLS) policies for common bypass vulnerabilities and misconfigurations.
894 installsBasic semantic code search with GrepAI. Use this skill to learn fundamental search commands and…
824 installsOther skills from yoanbernabeu/babeliocli.
npx skills add yoanbernabeu/babeliocli
Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.
main
Files included with this skill beyond the listing page.
SKILL.md
3,756 B
SUMMARY.md
416 B
babeliocli exposes the logged-in user's library. It is read-only and never modifies Babelio state.
A session must exist. If needed, see the babeliocli-setup skill or run:
babeliocli whoami # confirms the sessionbabeliocli shelves # JSON (default)
babeliocli shelves -f text # human viewSupported shelf keys:
| Key | Label | Babelio filter |
|---|---|---|
all |
Mes livres | ?action=toute |
lus |
Lus | ?s1=1 |
a-lire |
À lire | ?s1=2 |
en-cours |
En cours | ?s1=0 |
pense-bete |
Pense-bête | ?s1=3 |
abandonnes |
Abandonnés | ?s1=4 |
critiques |
Critiqués | ?s3=10 |
non-critiques |
Non critiqués | ?s3=11 |
babeliocli books --shelf lus # all "read" books, JSON
babeliocli books --shelf lus --limit 10 # first 10 books
babeliocli books --shelf a-lire -f text # human viewFlags:
--shelf (required, default all): one of the keys above.--limit N (default 0 = no limit): stop after N books.--max-pages N (default 50): safety cap on HTTP pagination.Pagination is handled automatically. The CLI requests the first page with the filter, then follows pageN=N because Babelio stores the active filter in the PHP session.
{
"id_biblio": "90486207",
"book_id": "1917163",
"title": "Une espèce en voie de disparition",
"author": "Lavie Tidhar",
"author_id": "271314",
"book_url": "https://www.babelio.com/livres/Tidhar-Une-espece-en-voie-de-disparition/1917163",
"status": "Lu",
"rating": 4,
"readers": 259,
"tags": [],
"read_start": "2025-09-01",
"read_end": "2025-09-05"
}Notes:
idbiblio is the per-user shelf entry (useful for debugging Babelio URLs); bookid is the globally-shared identifier used in /livres/.../BOOK_ID.rating is an integer 0–5 (0 = not rated).readstart / readend are the user-entered dates (YYYY-MM-DD). Empty when the user has never filled them.status matches Babelio's French labels: Lu, À lire, En cours, Pense bête, Abandonné, Possédé.babeliocli books --shelf lus |
jq -r '.books[] | select(.read_end != "") | "\(.read_end[0:7])\t\(.title)"' |
sortbabeliocli books --shelf lus |
jq -r '.books[] | select(.read_end != "") | .read_end[0:4]' |
sort | uniq -c | sort -rnbabeliocli books --shelf all |
jq '.books | map(select(.rating == 5)) | map({title, author})'babeliocli books --shelf all |
jq --arg q "hyperion" '.books[] | select(.title | ascii_downcase | contains($q))'read_end, do not assume "not read yet"; it may mean the user never filled the date."Lu" is authoritative; dates are metadata.critiques and non-critiques intersect lus, so summing counts would double-count.session expired: … on stderr with a non-zero exit code — your script should detect this and trigger a re-auth path.