Book Recommendations — «Что мне почитать дальше?» MCP 📚🎲

Рекомендации книг для ИИ-агентов: ответ на вопрос «что мне почитать дальше?» — на основе миллионов произведений: тематические подборки, «свидание вслепую» — случайный выбор, который цепляет настоящим первым предложением книги, и бесплатные классические книги из общественного достояния, которые можно начать читать прямо сейчас. Ноль API-ключей.

Спросите любого агента: «что мне почитать дальше?», «книги вроде „Дюны“» или «удиви меня книгой» — book-recommendations — это инструмент, который даст ответ.

Зачем это существует

• LLM на каждый запрос рекомендуют один и тот же канон из 50 книг. Этот инструмент проходит через миллионы произведений Open Library — включая «свидание вслепую»: он выбирает случайную тематическую полку случайной глубины, намеренно в стороне от списков бестселлеров, и цепляет вас настоящим первым предложением книги до того, как раскрывает её.

• Информация «можно читать сейчас» на каждой карточке: read_now показывает, когда книгу можно свободно читать на archive.org (открытый доступ) или же взять на время (бесплатный абонемент) — немедленное чтение лучше ссылки в магазин.

• Бесплатная классика через Project Gutenberg (fail-soft: если индекс Gutenberg недоступен, в самой ошибке приведены альтернативы на archive.org).

• Честное обоснование: на каждой карточке указано why\_picked — как именно была выбрана книга. Рекомендация, которой можно доверять.

Инструменты

Плюс промпт: what-should-i-read-next.

Быстрый старт

# 1-Line Universal Installer (auto-configures Claude Desktop, Cursor, Claude Code, VS Code, ...)
curl -fsSL "https://book-recommendations.builditwithai.xyz/install" | bash

# Or run directly via your preferred runtime:
uvx book-recommendations
npx -y book-recommendations

Пример

User:  surprise me with a book

blind_date()
→ picks: [{
     first_sentence: "The lighthouse kept its own counsel…",
     subjects: ["lighthouses", "islands", "solitude"], first_published: 1962,
     why_picked: "blind date: fished the “lighthouses” shelf at depth 3 — picked
                  for serendipity, not sales rank",
     title: "…", author: "…", read_now: "borrowable at archive.org",
     openlibrary_url: "https://openlibrary.org/works/…" }]

Сначала — зацепка, затем — раскрытие: двухприёмная структура и есть продукт.

Телеметрия и конфиденциальность

Анонимная телеметрия использования (без персональных данных, без запросов, без путей) — по флит-стандарту (схема v2, двухточечный резерв). Отключить можно в любой момент: BOOK_RECOMMENDATIONS_TELEMETRY=false или DO_NOT_TRACK=1.

Разработка

uv venv && uv pip install -e ".[dev]"
DO_NOT_TRACK=1 .venv/bin/python -m pytest tests/ -q   # unit + live + e2e

Живые тесты обращаются к реальному API Open Library и автоматически пропускаются в офлайне.

Лицензия

MIT