Fejlesztők

A könyvtár katalógusa, ingyenes polca és nyomtatott kiadásai tizenkilenc, programok, asszisztensek és modellek számára elérhető, csak olvasásra használható eszközzel érhetők el. Nincs szükség kulcsra vagy regisztrációra. További hét eszköz a felhasználó saját könyvtárában olvas, miután összekapcsolja a fiókját az asszisztensével (lásd: Saját könyvtár). Az eszközök soha nem léptetnek be senkit, nem fogadnak el fizetést, és nem módosítanak semmit: minden címhez visszaadják a libraryofalexandria.com oldalon található könyvoldal címét, ahol olvasni, hallgatni, nyomtatni vagy nekilátni lehet.

Háromféle csatlakozás

MCP (Streamable HTTP) a https://mcp.libraryofalexandria.com/mcp címen: Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose és minden más MCP-kliens számára.
REST és OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> és az OpenAPI-fájl itt található: https://api.libraryofalexandria.com/v1/openapi.json: szkriptekhez, automatizálási eszközökhöz (n8n, Zapier, Make, Dify, Flowise), Open WebUI-eszközszerverekhez és Copilot Studio-hoz.
Eszközfájlok modellkészítőknek: GET https://api.libraryofalexandria.com/v1/tools?format=openai: minden olyan programhoz, amely eszközdefiníciókat ad át egy modellnek. A formátumok: openai, openai-chat, anthropic, gemini, ollama és mcp.

Próbáld ki egy perc alatt

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

A válasz: {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. A data.results minden címéhez tartozik egy id, egy title, egy author és az oldalára mutató url.

A tizenkilenc eszköz

Nyolc címek keresésére szolgál, egy a nyomtatott kiadásokat mutatja meg, négy személyre szabott nyomtatott példányt készít elő, hat pedig a tanulásban és a választásban segít. Az asszisztens által látott eszközöket az MCP-címhez adott ?toolset= paraméterrel választhatod ki; a rövid lista jól illik a kisebb, helyben futó modellekhez:

https://api.libraryofalexandria.com/mcp: a tizenkilenc nyilvános eszköz, bejelentkezés nélkül (címtárunk bejegyzéseinek címe).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: ugyanaz a tizenkilenc nyilvános eszköz.
?toolset=catalogue,orders: az a tizenhárom eszköz, amely címeket keres, megmutatja a nyomtatott kiadásokat, és előkészíti a személyre szabott nyomtatott példányokat.
?toolset=study: a hat tanulási eszköz.
https://mcp.libraryofalexandria.com/mcp toolset nélkül: a tizenkilenc nyilvános eszköz és a felhasználó saját könyvtárának hét eszköze, összesen huszonhat; a hét eszköz csak a felhasználó engedélyével válaszol.

search_books (query, language, limit): címek keresése egy cím, szerző vagy téma szavai alapján, a katalógus bármely nyelvén.
get_book (id, language): egy cím adatai: szerző, eredeti cím, borító, nyomtatott kiadások és az oldal nyelvenkénti változata.
get_summary (id, language, part): egy cím 15 perces összefoglalójának első kulcsfontosságú gondolata teljes egészében, a többi rész címsoraival együtt.
get_sample (id, language, page): egy cím ingyenes nyitórészlete, legfeljebb 400 szavas oldalakon.
list_free_shelf (language, subject, limit): az ingyenes polcon található címek nyelv és téma szerint.
read_free_chapter (id, chapter, page, language): egy cím fejezete az ingyenes polcról, legfeljebb 400 szavas oldalakon.
get_print_options (id, language): egy cím nyomtatott kiadásai (normál és nagybetűs, puha vagy kemény kötésben), mindegyik ára amerikai dollárban.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): egy cím nyomtatott példányának ára személyes üzenetoldallal, a példányszám szerinti végösszeg, valamint az oldal, ahol megírható az üzenet és leadható a rendelés.
get_cover_upload_link (id, language): az az oldal, ahol saját borítókép adható hozzá egy nyomtatott példányhoz.
create_custom_print_order (quote_id): az az oldal, ahol a felhasználó megírja az üzenetet, megtekinti a nyomdai próbát és fizet. Az asszisztensen keresztül nem történik rendelés vagy fizetés.
get_order_status (order_ref, email, language): a nyomtatott rendelés állapota.
get_publisher_info: ki adja ki a könyvtárat, milyen nyelveken érhető el, valamint a felhasználási feltételek és az adatvédelmi oldal.
browse_collection (collection, language, limit, cursor): előre összeállított polc, egyszerre nyolc címmel: ingyenes könyvek, könnyű, közepes vagy kihívást jelentő szintű könyvek, elveszett könyvek, összefoglalóval rendelkező címek, legnépszerűbbek.
get_book_facts (id, language): egy cím olvasási adatai: nehézségi szint, hossz, olvasási idő három tempóban, oldalszám, hanganyag hossza és az első megjelenés éve.
get_themes (id, language): egy cím tanulási útmutatója: témák, szimbólumok, helyszín és motívumok, a teljes útmutató címével együtt.
get_chapter_summary (id, language, chapter): egy fejezet, felvonás vagy jelenet összefoglalója, vagy a fejezetek listája, ha nincs megadva fejezet.
find_quote_source (quote, language): az a szabadon hozzáférhető szöveg, fejezet és bekezdés, ahonnan legalább hat szóból álló idézet származik. Megnevezi a műveket, de könyvszöveget soha nem ad vissza.
explain_phrase (phrase, language): egy mondás vagy idióma jelentése, eredete, valamint hogy mely címekben szerepel.
recommend_classics (query, language, level, free_only, limit): olvasnivaló-ajánlás egy felhasználónak tetsző cím, téma vagy hangulat alapján.

Ha egy összefoglaló, mintarészlet vagy ingyenes polcon található fejezet még nem érhető el (mert a cím, a nyelv vagy még egyik szöveg sem került fel), az eszköz egyértelműen jelzi, hogy hamarosan megnyílik itt. Ezután magától megjelenik, teendőd nincs. Egyik eszköz sem ad vissza teljes könyvet: csak kis, korlátozott részleteket küldenek, és ügyfelenként számolják a továbbított szavakat (naponta 72 000-et, óránként 48 000-et; a válasz megmutatja a fennmaradó keretet).

Asszisztens csatlakoztatása

Mind a huszonhat eszköz csak olvasásra szolgál, ezért bármelyik kliens külön jóváhagyás kérése nélkül engedélyezheti őket. A cím: https://mcp.libraryofalexandria.com/mcp (add hozzá a ?toolset=catalogue,study,orders paramétert, vagy használd a https://api.libraryofalexandria.com/mcp címet, ha csak a tizenkilenc nyilvános eszközre van szükség).

Claude: Settings, Connectors, Add custom connector. A Claude Code-ban: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: nyisd meg a chatgpt.com/plugins oldalt, válaszd a plusz gombot és az Add custom MCP server lehetőséget, add meg a címet, majd hozd létre a bővítményt.
Cursor: add hozzá a "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} bejegyzést a ~/.cursor/mcp.json fájl mcpServers részéhez.
VS Code: indítsd el az MCP: Add Server parancsot a Command Palette-ben, válaszd a HTTP-t, és add meg a címet.
LM Studio (0.3.17 vagy újabb): Program lap, Install, Edit mcp.json, majd add hozzá ugyanazt a url bejegyzést a mcpServers részhez.
Open WebUI (0.6.31 vagy újabb): Settings, Admin, Integrations, External Tool Servers, Add Connection, majd válaszd az MCP (Streamable HTTP) lehetőséget, add meg a címet, és hagyd üresen a hitelesítést. Vagy válaszd az OpenAPI típust, és add meg az OpenAPI-fájl címét.
OpenAI Responses API: addja meg a {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} értéket a tools mezőben.

A kisebb, helyben futó modellek rövid eszközlistával működnek a legjobban: csak a feladathoz szükséges eszközöket csatlakoztassa.

Saját könyvtár (hét eszköz, az Ön engedélyével)

A libraryofalexandria.com oldalon fiókkal rendelkező személy engedélyezheti saját asszisztensének, hogy betekintsen a könyvtárába, és beszélgessen vele az éppen olvasott könyvről. Az asszisztens egyszer kér engedélyt; a személy ezt a libraryofalexandria.com oldalon hagyja jóvá, és a csatlakoztatott asszisztensek oldalán bármikor megszüntetheti a kapcsolatot.

get_my_plan: a csomag, annak állapota, valamint az aznapra még rendelkezésre álló szavak száma.
list_my_library: a könyvtár könyvei állapot szerint (tervezett, olvasás alatt, befejezett, szüneteltetett, félbehagyott).
get_book_outline: egy könyv fejezetei, és hogy melyik ingyenes, nyitott vagy zárolt. Szöveget nem ad vissza.
get_listen_link: egy könyv vagy fejezet meghallgatási oldalának címe.
open_in_reader: egy fejezet (és bekezdés) címe az olvasóban.
search_in_book: kulcsszavas keresés egy könyv megnyitott fejezeteiben: rövid részletek hivatkozási hellyel.
get_passage: egy részlet a megadott hivatkozási helyről, legfeljebb 400 szóban, forrásmegjelöléssel és címmel.

Szöveg csak olyan könyvekből érkezik, amelyeknek a szövege nyitott, és olyan fejezetekből, amelyeket az illető olvashat; egyszerre legfeljebb 400 szó. A kapcsolat OAuth 2.1-et használ PKCE-vel: a dokumentumok itt találhatók: /.well-known/oauth-protected-resource/mcp és /.well-known/oauth-authorization-server; a token nélküli hívás 401-es választ ad egy WWW-Authenticate fejléccel, amely ezekre mutat. Az asszisztens Client ID Metadata Document vagy POST /oauth/register útján regisztrál (óránként öt új kliens egy címről).

A REST API hívása

Minden eszköz egy művelet: POST /v1/<tool>, az eszköz argumentumaival JSON-objektumként, kulcs nélkül.

// JavaScript (Node 18 vagy újabb, böngészők, 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, csak a standard könyvtár
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"])

Az OpenAPI-fájl és az eszközfájlok

A /v1/openapi.json címen található OpenAPI 3.1-fájl leír minden műveletet, annak argumentumait és a válasz formátumát. Importálja az Open WebUI-ba, Difyba, Flowise-ba, Copilot Studio-ba vagy bármely OpenAPI-eszközbe. Azoknak a programoknak, amelyek eszközdefiníciókat adnak át egy modellnek, a GET /v1/tools?format= a különböző fejlesztők által használt formátumban adja vissza az eszközöket (csak a tizenkilenc nyilvános eszköz lekéréséhez adja hozzá ezt: &toolset=catalogue,study,orders): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama és mcp (a lista, amelyet az MCP-szerver mutat). A modell hívásaira a fenti REST-műveletekkel válaszoljon.

Hibák

Hiba esetén a válasz application/problem+json formátumú (RFC 9457), és tartalmazza a type, title, status, detail és stabil code mezőket.

400 invalid_json, invalid_request, unknown_format: a törzs nem JSON, hiányzik vagy hibás egy argumentum (a részletek megadják, melyik), vagy ismeretlen az eszközfájl formátuma.
404 unknown_tool, not_found: nincs ilyen eszköz vagy cím.
405 method_not_allowed: az eszközök POST-ot, a dokumentumok GET-et használnak.
413 payload_too_large: a törzs mérete meghaladja a 8 KB-ot.
415 unsupported_media_type: a törzsnek JSON-formátumúnak kell lennie.
500 internal: a könyvtár most nem tudott válaszolni. Próbálja újra egy kis idő múlva.

A válaszok használata

Adja vissza a válasz tartalmát, és használja a könyv url címét változtatás nélkül. Ne találjon ki árat vagy ajánlatot.
A könyvtár nem az ókori alexandriai könyvtár, és nem is a Bibliotheca Alexandrina.
Fizetni és regisztrálni kizárólag a libraryofalexandria.com oldalon lehet. Az eszköz átadhat egy hivatkozást, de fizetést soha nem fogad el.
Nincs szükség kulcsra. Kérjük, másodpercenként csak néhány kérést küldjön, és adjon meg egy, a programját azonosító User-Agent értéket.

Fejlesztői feltételek

A nyilvános eszközök kulcs nélkül, az ezen az oldalon feltüntetett korlátokon belül ingyenesen használhatók. A libraryofalexandria.com oldalon bejelentkezett személy által létrehozott fejlesztői kulccsal magasabbak a korlátok, és nyomon követhető a használat; a fiók alapcsomagjában percenként 60, naptári hónaponként pedig 1000 hívás engedélyezett, a kulcsok számától függetlenül.
A válaszokat arra használja, hogy segítsen az embereknek könyveket találni, olvasni és megrendelni. A válasz tartalmát adja vissza, tartsa meg az oldalunkra mutató hivatkozást, és ne tüntesse fel sajátjaként az összefoglalóinkat, tanulási útmutatóinkat vagy szövegeinket.
Ne másolja le tömegesen a szövegeinket, összefoglalóinkat vagy tanulási útmutatóinkat, ne tárolja őket válaszadásra, ne értékesítse tovább, és ne tanítson rajtuk modellt. Ehhez írásos licenc szükséges: lásd az MI- és adatlicencek oldalt.
Ne próbálja megkerülni a korlátozásokat, ne ossza meg a kulcsát, és ne hívja úgy az eszközöket, hogy azzal lelassítja őket mások számára. Az ilyen kulcs vagy cím hozzáférését lassíthatjuk, korlátozhatjuk vagy megszüntethetjük, a kulcs tulajdonosa pedig bármikor visszavonhatja azt.
Az eszközöket jelenlegi állapotukban biztosítjuk. Gondoskodunk a működésükről, de módosíthatjuk vagy megszüntethetjük őket; a változásokat ezen az oldalon tesszük közzé.

Adatvédelem

A szolgáltatás az eszköz neve, az állapot, valamint a kliens neve és verziója szerint számolja a hívásokat. A kérések tartalmát nem tárolja, és nem használ sütiket. Az adatvédelmi irányelvek és a szolgáltatási feltételek érvényesek.

Verziók

Az API verziója egy dátum, amelyet a LOA-Version fejlécben küldünk vissza (jelenleg: 2026-10-25). A változásokat ezen az oldalon tesszük közzé.