A powerful command-line interface for interacting with OPDS catalogs to search, browse, and download digital books.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install opdscli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install opdscli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is opdscli?
opdscli is a specialized tool designed to streamline the management of digital book collections through the Open Publication Distribution System (OPDS) protocol. By integrating this capability into Openclaw Skills, users can empower their AI agents to programmatically interact with library catalogs, handle authentication, and automate the retrieval of ebooks across various formats.
Whether you are managing a personal collection or accessing public repositories like Project Gutenberg, this skill provides a structured way to navigate library metadata and download content directly to your local environment. It serves as an essential bridge for developers looking to incorporate digital library management into their automated workflows.
opdscli Use Cases
- Searching for specific book titles or authors across multiple configured OPDS catalogs.
- Downloading ebooks in preferred formats such as PDF or EPUB to specific local directories.
- Browsing the latest additions to a library feed to stay updated on new releases.
- Automating the addition and management of multiple authenticated and public library sources.
How opdscli Works
- The skill verifies the environment by checking the availability of the opdscli binary.
- Catalogs are managed by adding URLs to the local configuration, supporting both public and private feeds.
- Users or agents perform search or browse queries to identify specific ebook entries within the catalogs.
- The tool executes the download lifecycle, handling authentication headers and saving the file to the user-specified path.
opdscli Setup
To get started with this skill, you need to install the opdscli tool. Use the following commands to set up the environment:
# Add the repository and install opdscli
brew tap rafadc/opdscli
brew install opdscli
# Verify the installation
opdscli --version
# Add a default public catalog
opdscli catalog add gutenberg https://m.gutenberg.org/ebooks.opds/
opdscli Data Schema & Taxonomy
The skill manages its state and metadata through a centralized configuration file. Below is the structure of the data it handles:
| Data Component | Location / Format | Description |
|---|---|---|
| Configuration | ~/.config/opdscli.yaml |
Stores catalog names, URLs, and authentication types. |
| Authentication | YAML keys | Supports Basic Auth and Bearer Token credentials. |
| Search Results | CLI Output | Displays book titles, IDs, and available download formats. |
| Output Files | User-defined path | Downloaded ebook files in requested formats. |
opdscli Advanced Features
- Support for authenticated catalogs using Basic Auth or Bearer tokens for private library access.
- Custom output directory mapping to organize downloads automatically.
- Search depth customization to explore deeper levels of large OPDS catalogs.
- Verbose logging and quiet modes for better integration with shell scripts and debugging.
- Global configuration management via subcommands to avoid manual YAML editing.
SKILL.md
Loading
Related Openclaw Skills
Outlit CLI
A professional command-line interface for querying customer intelligence, executing SQL analytics, and providing context to AI agents.
Elliott Wave Principle
An expert-level analytical skill for identifying market trends and price patterns using the Elliott Wave Principle.
Feishu/Lark Office Toolkit
A comprehensive integration toolkit that connects AI agents to the Feishu Open Platform for seamless office automation and team collaboration.
Juliette Psychose Agent
A specialized AI agent that brings the Juliette Psychose narrative and musical universe to life through conversational intelligence.
Organizze
A comprehensive tool for managing personal finances, from tracking bank transactions to monitoring budget goals, directly through an AI agent.
Flight Tracker
Track real-time flight details, including status, gates, and live positions, with a professional Flighty-style visual output.
Featured*
