Vývojáři

Katalog knihovny, její volně dostupná sekce a tištěná vydání jsou programům, asistentům a modelům zpřístupněny prostřednictvím devatenácti veřejných nástrojů pouze pro čtení. Není potřeba žádný klíč ani registrace. Dalších sedm nástrojů čte obsah vlastní knihovny člověka, jakmile svůj účet propojí s asistentem (viz Vaše vlastní knihovna). Nástroje nikdy nikoho nepřihlašují, nepřijímají platby ani nic nemění: u každého titulu vrátí odkaz na jeho stránku na libraryofalexandria.com, kde si jej člověk může přečíst, poslechnout, vytisknout nebo začít číst.

Tři způsoby připojení

MCP (Streamable HTTP) na adrese https://mcp.libraryofalexandria.com/mcp: pro Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose a všechny ostatní klienty MCP.
REST a OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> a soubor OpenAPI na adrese https://api.libraryofalexandria.com/v1/openapi.json: pro skripty, automatizační nástroje (n8n, Zapier, Make, Dify, Flowise), servery nástrojů Open WebUI a Copilot Studio.
Soubory nástrojů pro tvůrce modelů: GET https://api.libraryofalexandria.com/v1/tools?format=openai: pro jakýkoli program, který předává modelu definice nástrojů. Dostupné formáty jsou openai, openai-chat, anthropic, gemini, ollama a mcp.

Vyzkoušejte za minutu

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

Odpověď má tvar {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. Každý titul v data.results obsahuje id, title, author a url své stránky.

Devatenáct nástrojů

Osm vyhledává tituly, jeden zobrazuje tištěná vydání, čtyři připravují výtisk na míru a šest pomáhá se studiem a výběrem. Nástroje, které asistent uvidí, vyberte pomocí ?toolset= v adrese MCP; kratší seznam se hodí pro menší lokální modely:

https://api.libraryofalexandria.com/mcp: devatenáct veřejných nástrojů bez přihlášení (adresa pro naše výpisy v adresáři).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: stejných devatenáct veřejných nástrojů.
?toolset=catalogue,orders: třináct nástrojů pro vyhledání titulu, zobrazení jeho tištěných vydání a přípravu výtisku na míru.
?toolset=study: šest studijních nástrojů.
https://mcp.libraryofalexandria.com/mcp bez parametru toolset: devatenáct veřejných nástrojů a sedm nástrojů pro vlastní knihovnu člověka, celkem dvacet šest; těchto sedm odpovídá pouze se svolením daného člověka.

search_books (query, language, limit): vyhledá tituly podle slov z názvu, jména autora nebo tématu v libovolném jazyce katalogu.
get_book (id, language): informace o jednom titulu: autor, původní název, obálka, tištěná vydání a jeho stránka v jednotlivých jazycích.
get_summary (id, language, part): první klíčová myšlenka patnáctiminutového shrnutí jednoho titulu v plném znění a nadpisy ostatních částí.
get_sample (id, language, page): úvodní část jednoho titulu v úryvcích o nejvýše 400 slovech.
list_free_shelf (language, subject, limit): tituly z volně dostupné sekce podle jazyka a tématu.
read_free_chapter (id, chapter, page, language): jedna kapitola titulu z volně dostupné sekce, po úryvcích o nejvýše 400 slovech.
get_print_options (id, language): tištěná vydání jednoho titulu (standardní a velké písmo, brožovaná nebo vázaná kniha) včetně ceny každého z nich v amerických dolarech.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): cena tištěného výtisku jednoho titulu s osobní věnovací stránkou, celková cena za zadaný počet výtisků a stránka, kde se napíše věnování a zadá objednávka.
get_cover_upload_link (id, language): stránka, kde si člověk přidá vlastní obrázek obálky k tištěnému výtisku.
create_custom_print_order (quote_id): stránka, kde člověk napíše věnování, zkontroluje náhled a zaplatí. Přes asistenta se nic neobjednává ani neplatí.
get_order_status (order_ref, email, language): informace o stavu tištěné objednávky.
get_publisher_info: kdo knihovnu vydává, v jakých jazycích je dostupná, její podmínky a stránka o ochraně soukromí.
browse_collection (collection, language, limit, cursor): připravená kolekce, osm titulů najednou: knihy zdarma, snadná, střední či náročná četba, ztracené knihy, tituly se shrnutím a nejoblíbenější tituly.
get_book_facts (id, language): údaje o četbě jednoho titulu: úroveň, rozsah, doba čtení při třech rychlostech, počet stran, délka audioknihy a rok prvního vydání.
get_themes (id, language): studijní průvodce k jednomu titulu: témata, symboly, prostředí a motivy, včetně odkazu na celý průvodce.
get_chapter_summary (id, language, chapter): shrnutí jedné kapitoly, dějství nebo scény, případně seznam kapitol, pokud kapitola není zadána.
find_quote_source (quote, language): volně dostupný text, kapitola a odstavec, odkud pochází citát o nejméně šesti slovech. Uvede místa, ale nikdy nevrací znění knihy.
explain_phrase (phrase, language): význam rčení či idiomu, jeho původ a tituly, ve kterých se používá.
recommend_classics (query, language, level, free_only, limit): doporučení, co číst dál, podle titulu, který se člověku líbil, nebo podle tématu či nálady.

Pokud shrnutí, ukázková stránka nebo kapitola z bezplatné kolekce ještě není dostupná (protože titul či jazyk, případně všechny texty, budou zveřejněny až později), odpověď jednoduše sdělí, že bude brzy k dispozici zde. Poté se obsah doplní bez nutnosti cokoli dělat. Žádný nástroj nevrací celou knihu: nástroje poskytují jen malé, omezené části a počítají počet slov, které předají každému klientovi (72 000 denně a 48 000 za hodinu; odpověď ukáže, kolik jich zbývá).

Připojte asistenta

Všech dvacet šest nástrojů pouze čte, takže je klient může povolit bez opakovaného dotazování. Adresa je https://mcp.libraryofalexandria.com/mcp (přidejte ?toolset=catalogue,study,orders nebo použijte https://api.libraryofalexandria.com/mcp, kde je k dispozici pouze devatenáct veřejných nástrojů).

Claude: Settings, Connectors, Add custom connector. V Claude Code: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: otevřete chatgpt.com/plugins, vyberte tlačítko plus a Add custom MCP server, zadejte adresu a vytvořte plugin.
Cursor: přidejte "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} pod mcpServers v souboru ~/.cursor/mcp.json.
VS Code: spusťte MCP: Add Server z Command Palette, vyberte HTTP a zadejte adresu.
LM Studio (0.3.17 nebo novější): karta Program, Install, Edit mcp.json a přidejte stejnou položku url pod mcpServers.
Open WebUI (0.6.31 nebo novější): Settings, Admin, Integrations, External Tool Servers, Add Connection, zadejte MCP (Streamable HTTP), adresu a vyberte ověřování bez přihlášení. Nebo zvolte typ OpenAPI a zadejte adresu souboru OpenAPI.
OpenAI Responses API: do tools vložte {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"}.

Menší lokální modely si nejlépe poradí s krátkým seznamem nástrojů: připojte jen ty, které úkol vyžaduje.

Vaše vlastní knihovna (sedm nástrojů, s vaším svolením)

Člověk s účtem na libraryofalexandria.com může svému asistentovi povolit nahlédnout do knihovny a mluvit o knize, kterou právě čte. Asistent se jednou zeptá; člověk to schválí na libraryofalexandria.com a kdykoli může připojeného asistenta odpojit na stránce připojených asistentů.

get_my_plan: tarif, jeho stav a kolik slov textu zbývá pro dnešek.
list_my_library: knihy v knihovně podle stavu (chci číst, rozečtené, dočtené, pozastavené, odložené).
get_book_outline: kapitoly knihy a informace, které jsou volně dostupné, otevřené nebo zamčené. Bez textu.
get_listen_link: adresa stránky pro poslech knihy nebo kapitoly.
open_in_reader: adresa kapitoly (a odstavce) ve čtečce.
search_in_book: hledání klíčového slova v otevřených kapitolách jedné knihy: krátké úryvky s označením místa.
get_passage: jeden úryvek z určeného místa, nejvýše 400 slov, s citací a adresou.

Text pochází pouze z knih, jejichž text je otevřený, a z kapitol, které člověk smí číst, nejvýše 400 slov najednou. Připojení využívá OAuth 2.1 s PKCE: dokumenty jsou na adresách /.well-known/oauth-protected-resource/mcp a /.well-known/oauth-authorization-server; volání bez tokenu vrátí odpověď 401 s hlavičkou WWW-Authenticate, která na ně odkazuje. Asistent se zaregistruje pomocí dokumentu metadat klienta Client ID Metadata Document nebo přes POST /oauth/register (pět nových klientů za hodinu z jedné adresy).

Volání REST API

Každý nástroj odpovídá jedné operaci POST /v1/<tool> s argumenty nástroje jako objektem JSON a bez klíče.

// JavaScript (Node 18 nebo novější, prohlížeče, 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, pouze standardní knihovna
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"])

Soubor OpenAPI a soubory nástrojů

Soubor OpenAPI 3.1 na adrese /v1/openapi.json popisuje každou operaci, její argumenty i podobu odpovědi. Importujte ho do Open WebUI, Dify, Flowise, Copilot Studio nebo libovolného nástroje OpenAPI. Programům, které předávají modelu definice nástrojů, vrací GET /v1/tools?format= nástroje ve formátu požadovaném jednotlivými poskytovateli (přidejte &toolset=catalogue,study,orders pouze pro devatenáct veřejných nástrojů): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama a mcp (seznam zobrazovaný serverem MCP). Odpovídejte na volání modelu pomocí výše uvedených operací REST.

Chyby

Chyba se vrací ve formátu application/problem+json (RFC 9457) s položkami type, title, status, detail a stabilním code.

400 invalid_json, invalid_request, unknown_format: tělo není JSON, chybí argument nebo je nesprávný (podrobnosti uvádějí který), případně není znám formát souboru nástrojů.
404 unknown_tool, not_found: takový nástroj ani název knihy neexistuje.
405 method_not_allowed: nástroje používají POST; dokumenty používají GET.
413 payload_too_large: tělo je větší než 8 KB.
415 unsupported_media_type: tělo musí být ve formátu JSON.
500 internal: knihovna právě nedokázala odpovědět. Zkuste to za chvíli znovu.

Používání odpovědí

Řekněte, co odpověď uvádí, a adresu url knihy použijte beze změny. Nevymýšlejte cenu ani nabídku.
Knihovna není starověká Alexandrijská knihovna ani Bibliotheca Alexandrina.
Platby a registrace probíhají pouze na libraryofalexandria.com. Nástroj může předat odkaz; nikdy nepřijímá platbu.
Klíč není potřeba. Omezte se prosím na několik požadavků za sekundu a posílejte hlavičku User-Agent s názvem svého programu.

Podmínky pro vývojáře

Veřejné nástroje lze používat bez klíče v rámci limitů uvedených na této stránce. Vývojářský klíč, který si může vytvořit přihlášený uživatel na libraryofalexandria.com, zvýší limity a zobrazí vaše využití; bezplatný tarif účtu umožňuje 60 volání za minutu a 1 000 volání za kalendářní měsíc bez ohledu na počet klíčů.
Odpovědi používejte k tomu, abyste lidem pomohli najít, číst a objednávat knihy. Uvádějte informace tak, jak jsou v odpovědi, zachovejte odkaz na naši stránku a nevydávejte naše shrnutí, studijní příručky ani texty za vlastní.
Nekopírujte hromadně naše texty, shrnutí ani studijní příručky, neuchovávejte je jako databázi pro odpovídání, neprodávejte je dál ani na nich netrénujte model. K tomu je potřeba písemná licence: viz Licence pro AI a data.
Nesnažte se obcházet limity, sdílet klíč ani volat nástroje způsobem, který zpomaluje jejich používání ostatním. Klíč nebo adresu, která to dělá, můžeme zpomalit, omezit či zablokovat; jeho vlastník může klíč kdykoli odvolat.
Nástroje poskytujeme v aktuální podobě. Dbáme na jejich funkčnost a můžeme nástroj změnit nebo přestat nabízet; změny oznamujeme na této stránce.

Soukromí

Služba počítá volání podle názvu nástroje, stavu a názvu a verze klienta. Neuchovává znění dotazů a nenastavuje žádné cookies. Platí zásady ochrany osobních údajů a podmínky služby.

Verze

Verze API je datum vracené v hlavičce LOA-Version (aktuálně 2026-10-25). Změny oznamujeme na této stránce.