About book-reader
book-reader is a command-line tool for reading and searching digital books, suited to readers and researchers looking up book content. It supports several common formats and ranks BM25 search results with chapter or page references.
Key features
- 01Supports PDF, EPUB, MOBI, and text
- 02View book metadata and contents
- 03Read content by chapter
- 04Search books with BM25
- 05Results include chapter or page location
- 06Cache extracted content and detect file changes
Use cases
- 01Answer questions about a book’s contents
- 02Find specific quotes or passages
- 03Navigate to a page or chapter
- 04Research topics across digital books
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/book-readerin Claude Code to confirm it loaded.
Bundled filesREFERENCE.mdbook.py
Details
From the project READMEBook Reader
Read and query digital book formats from the command line using BM25 search.
Quick Start
# Get book metadata
uv run ~/.claude/skills/book-reader/book.py info ~/Books/mybook.pdf
# Show table of contents
uv run ~/.claude/skills/book-reader/book.py toc ~/Books/mybook.epub
# Read a specific chapter
uv run ~/.claude/skills/book-reader/book.py read ~/Books/mybook.pdf --chapter 3
# Read a specific page
uv run ~/.claude/skills/book-reader/book.py read ~/Books/mybook.pdf --page 42
# Search for content (BM25 ranked)
uv run ~/.claude/skills/book-reader/book.py search ~/Books/mybook.pdf "query"
# Extract full text
uv run ~/.claude/skills/book-reader/book.py extract ~/Books/mybook.txt
Supported Formats
| Format | Extensions | Features |
|---|---|---|
.pdf | Page numbers, TOC detection, metadata | |
| EPUB | .epub | Chapters from spine, full metadata |
| MOBI | .mobi, .azw, .azw3 | Basic extraction |
| Text | .txt, .text, .md | Chapter pattern detection |
When to Use
- User provides a book file and asks questions about its content
- Need to find specific quotes, passages, or information
- Navigating to specific pages or chapters in a document
- Researching topics across digital books
- Extracting text for further processing
How It Works
- First access: Extracts and caches the book content
- Subsequent access: Uses cached version (invalidates on file change)
- Search: BM25 algorithm ranks results by relevance
- Results: Include chapter/page location for reference
See Also
See REFERENCE.md for complete command documentation.
Comments
Markdown supported