russian-books-downloader

name	russian-books-downloader
description	Search for and download Russian-language books from free online libraries and book repositories. Use when the user wants to find, download, or search for books in Russian (художественная, техническая, научная литература на русском языке). Includes scripts for downloading from sites like pdfdrive.com, openlibrary.org, Flibusta, and others.

Russian Books Downloader

Search and download Russian-language books from free online resources.

Workflow

1. Ask the user what book they need — title, author, or topic
2. Search across available sources (see references/sources.md)
3. Try each source in priority order until found
4. Download using the appropriate script or method
5. Save to workspace and notify the user

Search Priority Order

1. Flibusta (rus) — largest Russian book library. Mirror: flibusta.is or use Tor
2. pdfdrive.com — many Russian books, harder search
3. openlibrary.org — some Russian books, borrow/download
4. pdfcoffee.com / pdfroom.com — user-uploaded, check manually
5. Литмир / lib.ru / ruslit.com — Russian-language sites

Available Scripts

• scripts/search_pdfdrive.py — search and download from pdfdrive.com
• scripts/search_flibusta.py — search Flibusta via its API/mirrors

When scripts fail or don't exist yet, fall back to:

• Manual web search + curl download for the specific book
• Sourcing from user-provided links

Notes

• Russian books are often in FB2, EPUB, or PDF format
• FB2 is the standard format for Russian ebooks
• Convert FB2 to EPUB/MOBI if needed using Calibre
• Some sites (Flibusta) require Tor for access in some regions

Sources

1. Flibusta

• Поиск: https://flibusta.is/booksearch?chs=0&chp=1&search=<запрос>
• API: OPDS-каталог https://flibusta.is/opds/
• Прямая ссылка: https://flibusta.is/b/<book_id>/download
• Tor: http://flibustahezeous3.onion

2. PDF Drive

• Поиск: https://www.pdfdrive.com/search?q=<запрос>
• Скачивание: https://www.pdfdrive.com/download.pdf?id=<ID>&h=<HASH>

3. Open Library

• Поиск: https://openlibrary.org/search?q=<запрос>&language=rus

4. Литмир

• URL: https://www.litmir.me

5. Прочие: pdfcoffee.com, pdfroom.com, lib.ru, ruslit.com

Format Conversion (FB2 → EPUB/PDF/TXT)

# Calibre
ebook-convert book.fb2 book.epub

# FB2 → TXT via Python
python3 -c "
from xml.etree import ElementTree as ET
tree = ET.parse('book.fb2')
root = tree.getroot()
ns = {'fb': 'http://www.gribuser.ru/xml/fictionbook/2.0'}
for p in root.findall('.//fb:p', ns):
    print(''.join(p.itertext()))
" > book.txt