{"skill":{"slug":"opdscli","displayName":"Opdscli","summary":"Browse, search, and download ebooks from OPDS catalogs using the opdscli CLI. Use when adding/managing catalogs, searching for books, downloading ebooks, or...","description":"---\nname: opdscli\ndescription: Browse, search, and download ebooks from OPDS catalogs using the opdscli CLI. Use when adding/managing catalogs, searching for books, downloading ebooks, or browsing latest additions.\nhomepage: https://github.com/rafadc/opdscli\nmetadata: {\"clawdbot\":{\"emoji\":\"📚\",\"requires\":{\"bins\":[\"opdscli\"]},\"install\":[{\"id\":\"brew\",\"kind\":\"brew\",\"tap\":\"rafadc/opdscli\",\"formula\":\"opdscli\",\"bins\":[\"opdscli\"],\"label\":\"Install opdscli (brew)\"}]}}\n---\n\n# opdscli\n\nOPDS catalog browser and ebook downloader. Follow the CLI reference below.\n\n## References\n\n- `references/cli-reference.md` (commands, flags, and examples)\n\n## Workflow\n\n1. Verify CLI present: `opdscli --version`.\n2. Check configured catalogs: `opdscli catalog list`.\n3. If no catalogs configured, add one (see cli-reference for auth options).\n4. Set a default catalog if needed: `opdscli catalog set-default <name>`.\n5. Search, browse, or download as requested.\n\n## Common patterns\n\n### Add a public catalog\n\n```bash\nopdscli catalog add gutenberg https://m.gutenberg.org/ebooks.opds/\n```\n\n### Add a catalog with authentication\n\n```bash\n# Basic auth (will prompt for credentials)\nopdscli catalog add mylib https://my-library.example.com/opds --auth-type basic\n\n# Bearer token\nopdscli catalog add mylib https://my-library.example.com/opds --auth-type bearer\n```\n\n### Search and download\n\n```bash\nopdscli search \"don quixote\"\nopdscli download \"Don Quixote\"\nopdscli download \"Don Quixote\" --format pdf --output ~/Books\n```\n\n### Browse latest additions\n\n```bash\nopdscli latest\nopdscli latest --limit 50\n```\n\n## Guardrails\n\n- Config lives at `~/.config/opdscli.yaml`. Do not edit it directly; use `opdscli catalog` subcommands.\n- Credentials stored in config are plaintext. Never log or echo catalog config that may contain passwords or tokens.\n- When downloading, respect the user's preferred format and output directory.\n- If a search returns no results, suggest increasing `--depth` or checking the catalog URL.\n- Use `--verbose` for debugging connection issues, `--quiet` when piping output.\n","tags":{"latest":"0.1.0"},"stats":{"comments":0,"downloads":354,"installsAllTime":13,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1771283441412,"updatedAt":1778991069408},"latestVersion":{"version":"0.1.0","createdAt":1771283441412,"changelog":"Initial release of opdscli skill.\n\n- Browse, search, and download ebooks from OPDS catalogs via the opdscli command-line tool.\n- Add and manage OPDS catalogs, including support for public and authenticated sources.\n- Search for books, browse latest additions, and download ebooks in various formats.\n- Provides workflow guidance and common usage patterns.\n- Includes guardrails for safe credential handling and configuration management.","license":null},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"rafadc","userId":"s176vj9sam7a42x3dg57j264sh8854a5","displayName":"Rafa de Castro","image":"https://avatars.githubusercontent.com/u/525892?v=4"},"moderation":null}