opdscli
by rafadc
Search & ResearchBrief
Browse, search, and download ebooks from OPDS catalogs using the opdscli CLI.
Description
What This Skill Does
opdscli browses, searches, and downloads ebooks from OPDS catalog servers via the command line. It supports multiple catalogs with basic auth or bearer token authentication. All catalog config is managed through subcommands stored in ~/.config/opdscli.yaml.
A CLI approach enables scripting and headless ebook retrieval without running a full GUI ebook manager like Calibre.
When to Use It
- Downloading a specific book from Project Gutenberg without opening a browser
- Searching a private library's OPDS catalog for titles by author
- Browsing the 50 latest additions to a self-hosted ebook server
- Managing multiple OPDS catalog endpoints from a single config
- Downloading books in PDF format to a chosen local directory
Example Workflow
User asks: download Don Quixote as a PDF from Project Gutenberg
- 1
Verify the CLI is available: opdscli --version
- 2
Add the Gutenberg catalog: opdscli catalog add gutenberg https://m.gutenberg.org/ebooks.opds/
- 3
Set it as the default: opdscli catalog set-default gutenberg
- 4
Search for the title: opdscli search "don quixote"
- 5
Download in PDF format: opdscli download "Don Quixote" --format pdf --output ~/Books
Don Quixote downloaded as a PDF file to ~/Books
Requirements
- opdscli CLI installed (available via: brew install rafadc/opdscli/opdscli)
Installation
clawhub install rafadc/opdscliRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.