Setup & Installation
openclaw skills install @rafadc/opdscli
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install opdscli
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
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: download Don Quixote as a PDF from Project Gutenberg
AGENT
- 1Verify the CLI is available: opdscli --version
- 2Add the Gutenberg catalog: opdscli catalog add gutenberg https://m.gutenberg.org/ebooks.opds/
- 3Set it as the default: opdscli catalog set-default gutenberg
- 4Search for the title: opdscli search "don quixote"
- 5Download in PDF format: opdscli download "Don Quixote" --format pdf --output ~/Books
OUTPUT
Don Quixote downloaded as a PDF file to ~/Books
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
opdscli CLI installed (available via: brew install rafadc/opdscli/opdscli)