Разработчикам

Каталог библиотеки, её бесплатная полка и печатные издания доступны программам, помощникам и моделям через девятнадцать общедоступных инструментов только для чтения. Ключ не нужен, регистрироваться не требуется. Ещё семь инструментов читают личную библиотеку пользователя после того, как он подключит свой аккаунт к своему помощнику (см. Ваша личная библиотека). Инструменты никогда не выполняют вход в аккаунт, не принимают оплату и ничего не меняют: каждая книга возвращается с адресом её страницы на libraryofalexandria.com, где пользователь читает, слушает, заказывает печать или начинает работу.

Три способа подключения

MCP (Streamable HTTP) по адресу https://mcp.libraryofalexandria.com/mcp: для Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose и любого другого клиента MCP.
REST и OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> и файл OpenAPI по адресу https://api.libraryofalexandria.com/v1/openapi.json: для скриптов, инструментов автоматизации (n8n, Zapier, Make, Dify, Flowise), серверов инструментов Open WebUI и Copilot Studio.
Файлы инструментов для разработчиков моделей: GET https://api.libraryofalexandria.com/v1/tools?format=openai: для любой программы, которая передаёт модели описания инструментов. Доступные форматы: openai, openai-chat, anthropic, gemini, ollama и mcp.

Попробуйте за минуту

curl -s https://api.libraryofalexandria.com/v1/search_books \
  -H 'content-type: application/json' \
  -d '{"query":"moby dick","limit":3}'

Ответ имеет вид {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. У каждой книги в data.results есть id, title, author и url её страницы.

Девятнадцать инструментов

Восемь находят книги, один показывает печатные издания, четыре подготавливают личный печатный экземпляр, а шесть помогают изучать и выбирать книги. Выберите инструменты, доступные помощнику, с помощью ?toolset= в адресе MCP; короткий список подходит небольшим локальным моделям:

https://api.libraryofalexandria.com/mcp: девятнадцать общедоступных инструментов без входа в аккаунт (адрес, указанный в наших записях в каталогах).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: те же девятнадцать общедоступных инструментов.
?toolset=catalogue,orders: тринадцать инструментов, которые находят книги, показывают их печатные издания и подготавливают личный печатный экземпляр.
?toolset=study: шесть инструментов для изучения книг.
https://mcp.libraryofalexandria.com/mcp без toolset: девятнадцать общедоступных инструментов и семь инструментов личной библиотеки пользователя, всего двадцать шесть; эти семь отвечают только с разрешения пользователя.

search_books (query, language, limit): поиск книг по словам из названия, имени автора или теме на любом языке каталога.
get_book (id, language): сведения об одной книге: автор, оригинальное название, обложка, печатные издания и её страница на каждом языке.
get_summary (id, language, part): первая ключевая мысль из краткого содержания на 15 минут одной книги — полностью, а также заголовки остальных.
get_sample (id, language, page): бесплатный начальный отрывок одной книги, разбитый на страницы не более чем по 400 слов.
list_free_shelf (language, subject, limit): книги на бесплатной полке по языку и теме.
read_free_chapter (id, chapter, page, language): одна глава книги с бесплатной полки, разбитая на страницы не более чем по 400 слов.
get_print_options (id, language): печатные издания одной книги (обычным и крупным шрифтом, в мягкой обложке или твёрдом переплёте) с ценой каждого в долларах США.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): цена печатного экземпляра одной книги со страницей для личного послания, общая стоимость указанного количества экземпляров и страница для написания послания и оформления заказа.
get_cover_upload_link (id, language): страница, на которой можно добавить собственное изображение обложки для печатного экземпляра.
create_custom_print_order (quote_id): страница для написания послания, просмотра макета и оплаты. Через помощника нельзя оформить или оплатить заказ.
get_order_status (order_ref, email, language): статус заказа печатных книг.
get_publisher_info: кто издаёт книги библиотеки, на каких языках, условия использования и страница конфиденциальности.
browse_collection (collection, language, limit, cursor): готовая полка, по восемь книг за раз: бесплатные книги, книги начального, среднего или сложного уровня, утраченные книги, книги с кратким содержанием, самые популярные.
get_book_facts (id, language): сведения об одной книге: уровень сложности, объём, время чтения в трёх темпах, количество страниц, длительность аудиокниги и год первой публикации.
get_themes (id, language): материалы для изучения одной книги: темы, символы, место и время действия, мотивы, а также адрес полных материалов.
get_chapter_summary (id, language, chapter): краткое содержание одной главы, действия или сцены либо список глав, если глава не указана.
find_quote_source (quote, language): доступный текст, глава и абзац, из которых взята цитата длиной не менее шести слов. Указывает место в тексте и никогда не возвращает сам текст книги.
explain_phrase (phrase, language): значение поговорки или идиомы, её происхождение и книги, в которых она встречается.
recommend_classics (query, language, level, free_only, limit): что почитать дальше — на основе понравившейся книги, темы или настроения.

Если краткое содержание, пробная страница или глава с бесплатной полки ещё недоступны (отдельная книга, язык или все тексты до их публикации на сайте), в ответе прямо говорится, что они скоро появятся здесь. Затем содержимое появится без каких-либо изменений с вашей стороны. Ни один инструмент не возвращает книгу целиком: инструменты возвращают небольшие фрагменты ограниченного объёма и подсчитывают выданные слова для каждого клиента (72,000 в день и 48,000 в час; в ответе указан остаток).

Подключить помощника

Все двадцать шесть инструментов работают только на чтение, поэтому любой клиент может разрешить их использование без запроса каждый раз. Адрес: https://mcp.libraryofalexandria.com/mcp (добавьте ?toolset=catalogue,study,orders или используйте https://api.libraryofalexandria.com/mcp, чтобы получить доступ только к девятнадцати общедоступным инструментам).

Claude: Настройки, Коннекторы, Добавить пользовательский коннектор. В Claude Code: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: откройте chatgpt.com/plugins, нажмите кнопку с плюсом и выберите «Добавить пользовательский сервер MCP», введите адрес и создайте плагин.
Cursor: добавьте "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} в раздел mcpServers файла ~/.cursor/mcp.json.
VS Code: выполните команду «MCP: Добавить сервер» из палитры команд, выберите HTTP и введите адрес.
LM Studio (0.3.17 или новее): вкладка «Программа», «Установить», «Редактировать mcp.json», затем добавьте ту же запись url в раздел mcpServers.
Open WebUI (0.6.31 или новее): Настройки, Администрирование, Интеграции, Внешние серверы инструментов, Добавить подключение; укажите тип MCP (Streamable HTTP), адрес и отсутствие аутентификации. Либо выберите тип OpenAPI и введите адрес файла OpenAPI.
OpenAI Responses API: передайте {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} в tools.

Небольшие локальные модели лучше работают с коротким списком инструментов: подключайте только те, которые нужны для задачи.

Ваша библиотека (семь инструментов, с вашего разрешения)

Пользователь с аккаунтом на libraryofalexandria.com может разрешить своему помощнику просматривать свою библиотеку и обсуждать книгу, которую читает. Помощник запрашивает разрешение один раз; пользователь подтверждает его на libraryofalexandria.com и может в любой момент отключить помощника на странице подключённых помощников.

get_my_plan: тарифный план, его статус и сколько слов текста ещё доступно сегодня.
list_my_library: книги в библиотеке по статусу (хочу прочитать, читаю, прочитано, отложено, чтение прекращено).
get_book_outline: главы книги и сведения о том, какие из них бесплатны, открыты или закрыты. Без текста.
get_listen_link: адрес страницы прослушивания книги или главы.
open_in_reader: адрес главы (и абзаца) в читалке.
search_in_book: поиск по ключевым словам в открытых главах одной книги: короткие фрагменты с указанием местоположения.
get_passage: один отрывок по указателю местоположения, не более 400 слов, с библиографической ссылкой и адресом.

Текст поступает только из книг с открытым текстом и из глав, которые пользователь вправе читать, не более 400 слов за раз. Подключение использует OAuth 2.1 с PKCE: документы доступны по адресам /.well-known/oauth-protected-resource/mcp и /.well-known/oauth-authorization-server; на вызов без токена возвращается ответ 401 с заголовком WWW-Authenticate, который указывает на эти адреса. Помощник регистрируется с помощью Client ID Metadata Document или POST /oauth/register (пять новых клиентов в час с одного адреса).

Вызов REST API

Каждому инструменту соответствует одна операция — POST /v1/<tool>, с аргументами инструмента в виде объекта JSON, без ключа.

// JavaScript (Node 18 или новее, браузеры, Deno, Bun, Workers)
const res = await fetch("https://api.libraryofalexandria.com/v1/get_book", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ id: "top3500-00002", language: "en" }),
});
const { ok, data } = await res.json();
console.log(data.title, data.url);

# Python, только стандартная библиотека
import json, urllib.request

req = urllib.request.Request(
    "https://api.libraryofalexandria.com/v1/list_free_shelf",
    data=json.dumps({"language": "es", "limit": 5}).encode(),
    headers={"content-type": "application/json"},
)
print(json.load(urllib.request.urlopen(req))["data"]["titles"])

Файл OpenAPI и файлы инструментов

Файл OpenAPI 3.1 по адресу /v1/openapi.json описывает каждую операцию, её аргументы и структуру ответа. Импортируйте его в Open WebUI, Dify, Flowise, Copilot Studio или любой инструмент с поддержкой OpenAPI. Для программ, которые передают модели определения инструментов, GET /v1/tools?format= возвращает инструменты в формате нужного разработчика (добавьте &toolset=catalogue,study,orders, чтобы получить только девятнадцать общедоступных инструментов): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama и mcp (список, который показывает сервер MCP). Отвечайте на вызовы модели с помощью описанных выше операций REST.

Ошибки

При ошибке возвращается application/problem+json (RFC 9457) с полями type, title, status, detail и постоянным кодом code.

400 invalid_json, invalid_request, unknown_format: тело запроса не является JSON, аргумент отсутствует или неверен (поле detail указывает, какой именно), либо формат файла инструментов неизвестен.
404 unknown_tool, not_found: такого инструмента или такого названия нет.
405 method_not_allowed: инструменты принимают POST; документы — GET.
413 payload_too_large: размер тела запроса превышает 8 КБ.
415 unsupported_media_type: тело запроса должно быть в формате JSON.
500 internal: библиотека сейчас не смогла ответить. Повторите попытку чуть позже.

Использование ответов

Передавайте содержание ответа и используйте url книги в том виде, в котором он указан. Не придумывайте цены или предложения.
Эта библиотека — не древняя Александрийская библиотека и не Bibliotheca Alexandrina.
Оплата и регистрация проходят только на libraryofalexandria.com. Инструмент может предоставить ссылку, но никогда не принимает оплату.
Ключ не нужен. Пожалуйста, ограничьтесь несколькими запросами в секунду и передавайте User-Agent с названием вашей программы.

Условия для разработчиков

Общедоступные инструменты можно использовать бесплатно без ключа в пределах ограничений, указанных на этой странице. Ключ разработчика, созданный пользователем, вошедшим в аккаунт на libraryofalexandria.com, повышает лимиты и позволяет видеть статистику использования; бесплатный план предусматривает 60 вызовов в минуту и 1 000 вызовов за календарный месяц на аккаунт независимо от количества ключей.
Используйте ответы, чтобы помогать людям находить, читать и заказывать книги. Передавайте содержание ответа, сохраняйте ссылку на нашу страницу и не выдавайте наши краткие содержания, материалы для изучения книг или тексты за свои.
Не копируйте массово наши тексты, краткие содержания или материалы для изучения книг, не храните их как базу для ответов, не перепродавайте и не обучайте на них модели. Для этого нужна письменная лицензия: см. Лицензии на использование искусственного интеллекта и данных.
Не пытайтесь обходить ограничения, передавать ключ другим или вызывать инструменты так, что их работа для других пользователей замедляется. Мы можем замедлить, ограничить или прекратить доступ по ключу или адресу, с которого это происходит; владелец ключа может отозвать его в любой момент.
Инструменты предоставляются как есть. Мы поддерживаем их работу и можем изменять или выводить инструменты из эксплуатации; об изменениях сообщается на этой странице.

Конфиденциальность

Сервис подсчитывает вызовы по названию инструмента, статусу, названию и версии клиента. Он не сохраняет содержание запросов и не устанавливает файлы cookie. Действуют политика конфиденциальности и условия использования.

Версии

Версия API — это дата, которая возвращается в заголовке LOA-Version (сейчас 2026-10-25). Об изменениях сообщается на этой странице.