Razvojni programeri

Katalog knjižnice, polica besplatnih knjiga i njezina tiskana izdanja dostupni su programima, asistentima i modelima putem devetnaest javnih alata samo za čitanje. Nije potreban ključ ni registracija. Još sedam alata može čitati osobnu knjižnicu korisnika, nakon što korisnik poveže svoj račun sa svojim asistentom (pogledajte Vaša osobna knjižnica). Alati nikoga ne prijavljuju, ne naplaćuju i ništa ne mijenjaju: uz svaki naslov vraćaju adresu njegove stranice na libraryofalexandria.com, gdje ga korisnik može čitati, slušati, ispisati ili započeti čitati.

Tri načina pristupa

MCP (Streamable HTTP) na adresi https://mcp.libraryofalexandria.com/mcp: za Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose i sve druge MCP klijente.
REST i OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> i datoteka OpenAPI na adresi https://api.libraryofalexandria.com/v1/openapi.json: za skripte, alate za automatizaciju (n8n, Zapier, Make, Dify, Flowise), poslužitelje alata Open WebUI i Copilot Studio.
Datoteke alata za autore modela: GET https://api.libraryofalexandria.com/v1/tools?format=openai: za svaki program koji modelu prosljeđuje definicije alata. Formati su openai, openai-chat, anthropic, gemini, ollama i mcp.

Isprobajte za minutu

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

Odgovor glasi {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. Svaki naslov u data.results sadrži id, title, author i url svoje stranice.

Devetnaest alata

Osam služi za pronalaženje naslova, jedan prikazuje tiskana izdanja, četiri pripremaju personalizirani primjerak za tisak, a šest pomaže pri učenju i odabiru. Odaberite koje alate asistent vidi dodavanjem ?toolset= na MCP adresu; kraći popis odgovara manjim lokalnim modelima:

https://api.libraryofalexandria.com/mcp: devetnaest javnih alata, bez prijave (adresa za naše unose u direktorijima).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: istih devetnaest javnih alata.
?toolset=catalogue,orders: trinaest alata za pronalaženje naslova, prikaz tiskanih izdanja i pripremu personaliziranog primjerka za tisak.
?toolset=study: šest alata za učenje.
https://mcp.libraryofalexandria.com/mcp bez toolseta: devetnaest javnih alata i sedam alata za osobnu knjižnicu korisnika, ukupno dvadeset šest; za tih sedam potrebna je korisnikova dozvola.

search_books (query, language, limit): pronađite naslove prema riječima iz naslova, imenu autora ili temi, na bilo kojem jeziku kataloga.
get_book (id, language): podaci o naslovu: autor, izvorni naslov, naslovnica, tiskana izdanja i stranica na svakom jeziku.
get_summary (id, language, part): prva ključna ideja sažetka naslova od 15 minuta u cijelosti te naslovi ostalih dijelova.
get_sample (id, language, page): besplatni početak naslova, podijeljen na stranice od najviše 400 riječi.
list_free_shelf (language, subject, limit): naslovi na polici besplatnih knjiga, prema jeziku i temi.
read_free_chapter (id, chapter, page, language): jedno poglavlje naslova s police besplatnih knjiga, podijeljeno na stranice od najviše 400 riječi.
get_print_options (id, language): tiskana izdanja naslova (standardni i krupni tisak, meki ili tvrdi uvez) s cijenom svakog izdanja u američkim dolarima.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): cijena tiskanog primjerka naslova s osobnom porukom na stranici, ukupna cijena za odabrani broj primjeraka te stranica na kojoj se poruka upisuje i narudžba predaje.
get_cover_upload_link (id, language): stranica na kojoj korisnik dodaje vlastitu sliku za naslovnicu tiskanog primjerka.
create_custom_print_order (quote_id): stranica na kojoj korisnik upisuje poruku, pregledava probni primjerak i plaća. Asistent ne naručuje niti plaća.
get_order_status (order_ref, email, language): prikazuje status tiskane narudžbe.
get_publisher_info: tko izdaje knjižnicu, njezini jezici, uvjeti korištenja i stranica o privatnosti.
browse_collection (collection, language, limit, cursor): unaprijed pripremljena polica s osam naslova odjednom: besplatne knjige, lagani, srednje zahtjevni ili zahtjevni naslovi, izgubljene knjige, naslovi sa sažetkom i najpopularniji naslovi.
get_book_facts (id, language): podaci za čitanje naslova: razina, opseg, vrijeme čitanja trima brzinama, broj stranica, trajanje audioknjige i godina prvog izdanja.
get_themes (id, language): vodič za proučavanje naslova: teme, simboli, mjesto radnje i motivi, uz poveznicu na cijeli vodič.
get_chapter_summary (id, language, chapter): sažetak poglavlja, čina ili prizora, odnosno popis poglavlja ako poglavlje nije navedeno.
find_quote_source (quote, language): javno dostupni tekst, poglavlje i odlomak iz kojeg potječe citat od najmanje šest riječi. Navodi mjesta, ali nikad ne vraća tekst knjige.
explain_phrase (phrase, language): značenje i podrijetlo izreke ili idioma te naslovi u kojima se pojavljuje.
recommend_classics (query, language, level, free_only, limit): preporuke za sljedeće čitanje prema naslovu koji se korisniku svidio ili prema temi odnosno raspoloženju.

Ako sažetak, ogledna stranica ili poglavlje s police besplatnih knjiga još nije dostupno (naslov, jezik ili svi tekstovi prije objave), alat jasno javlja da će uskoro biti dostupno ovdje. Sadržaj će se pojaviti naknadno, bez ikakve vaše intervencije. Nijedan alat ne vraća cijelu knjigu: alati vraćaju samo kratke, ograničene dijelove i broje riječi koje daju svakom klijentu (72.000 dnevno i 48.000 na sat; u odgovoru se prikazuje preostali broj).

Povežite asistenta

Svi alati služe samo za čitanje, pa ih svaki klijent može odobriti bez traženja potvrde svaki put. Adresa je https://mcp.libraryofalexandria.com/mcp (dodajte ?toolset=catalogue,study,orders ili upotrijebite https://api.libraryofalexandria.com/mcp za pristup samo devetnaest javnih alata).

Claude: Settings, Connectors, Add custom connector. U Claude Codeu: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: otvorite chatgpt.com/plugins, odaberite gumb plus i Add custom MCP server, unesite adresu i izradite dodatak.
Cursor: pod mcpServers u datoteci ~/.cursor/mcp.json dodajte "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"}.
VS Code: u paleti naredbi pokrenite MCP: Add Server, odaberite HTTP i unesite adresu.
LM Studio (0.3.17 ili noviji): kartica Program, Install, Edit mcp.json, zatim pod mcpServers dodajte isti unos url.
Open WebUI (0.6.31 ili noviji): Settings, Admin, Integrations, External Tool Servers, Add Connection, odaberite MCP (Streamable HTTP), unesite adresu i odaberite bez autentifikacije. Ili odaberite vrstu OpenAPI i unesite adresu datoteke OpenAPI.
OpenAI Responses API: proslijedite {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} u tools.

Manji lokalni modeli najbolje rade s kratkim popisom alata: povežite samo one koji su potrebni za zadatak.

Vaša knjižnica (sedam alata, uz vaše dopuštenje)

Osoba s korisničkim računom na libraryofalexandria.com može dopustiti vlastitom asistentu da pregleda njezinu knjižnicu i razgovara o knjizi koju čita. Asistent to zatraži jednom; osoba to odobri na libraryofalexandria.com, a vezu može prekinuti u bilo kojem trenutku na stranici povezanih asistenata.

get_my_plan: plan, njegov status i broj riječi teksta koje su vam još danas dostupne.
list_my_library: knjige u knjižnici, prema statusu (želim čitati, čitam, pročitano, pauzirano, odustao/la).
get_book_outline: poglavlja knjige i označeno je li im pristup besplatan, otvoren ili zaključan. Bez teksta.
get_listen_link: adresa stranice za slušanje knjige ili poglavlja.
open_in_reader: adresa poglavlja (i odlomka) u čitaču.
search_in_book: pretraživanje po ključnoj riječi u otvorenim poglavljima jedne knjige: kratki isječci s oznakom mjesta.
get_passage: jedan ulomak s određene lokacije, do 400 riječi, s citatom i adresom.

Tekst dolazi samo iz knjiga čiji je tekst otvoren i iz poglavlja koja osoba smije čitati, najviše 400 riječi odjednom. Veza koristi OAuth 2.1 s PKCE-om: dokumenti su na adresama /.well-known/oauth-protected-resource/mcp i /.well-known/oauth-authorization-server; poziv bez tokena vraća odgovor 401 sa zaglavljem WWW-Authenticate koje upućuje na njih. Asistent se registrira dokumentom Client ID Metadata Document ili putem POST /oauth/register (pet novih klijenata na sat s jedne adrese).

Pozivanje REST API-ja

Svaki je alat jedna operacija, POST /v1/<tool>, s argumentima alata kao JSON objektom i bez ključa.

// JavaScript (Node 18 ili noviji, preglednici, 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, samo standardna biblioteka
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"])

Datoteka OpenAPI i datoteke alata

Datoteka OpenAPI 3.1 na adresi /v1/openapi.json opisuje svaku operaciju, njezine argumente i oblik odgovora. Uvezite je u Open WebUI, Dify, Flowise, Copilot Studio ili bilo koji OpenAPI alat. Za programe koji modelu prosljeđuju definicije alata, GET /v1/tools?format= vraća alate u obliku koji traži svaki proizvođač (dodajte &toolset=catalogue,study,orders za samo devetnaest javnih alata): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama i mcp (popis koji prikazuje MCP poslužitelj). Odgovorite na pozive modela pomoću REST operacija navedenih iznad.

Pogreške

Problem se vraća kao application/problem+json (RFC 9457) s poljima type, title, status, detail i stabilnim poljem code.

400 invalid_json, invalid_request, unknown_format: tijelo nije JSON, argument nedostaje ili je pogrešan (u detaljima piše koji) ili je format datoteke alata nepoznat.
404 unknown_tool, not_found: takav alat ili naslov ne postoji.
405 method_not_allowed: alati koriste POST; dokumenti koriste GET.
413 payload_too_large: tijelo je veće od 8 KB.
415 unsupported_media_type: tijelo mora biti u JSON formatu.
500 internal: knjižnica trenutačno nije mogla odgovoriti. Pokušajte ponovno za koji trenutak.

Korištenje odgovora

Prenesite ono što odgovor kaže i koristite url naslova točno kako je navedena. Nemojte izmišljati cijenu ili ponudu.
Ova knjižnica nije drevna Aleksandrijska knjižnica ni Bibliotheca Alexandrina.
Plaćanje i registracija odvijaju se samo na libraryofalexandria.com. Alat može proslijediti poveznicu; ne prima plaćanje.
Ključ nije potreban. Ograničite se na nekoliko zahtjeva u sekundi i navedite User-Agent koji identificira vaš program.

Uvjeti za razvojne programere

Javni alati mogu se koristiti bez ključa, u okviru ograničenja navedenih na ovoj stranici. Ključ za razvojne programere, koji može izraditi osoba prijavljena na libraryofalexandria.com, povećava ograničenja i prikazuje vašu upotrebu; besplatni plan omogućuje 60 poziva u minuti i 1.000 poziva u kalendarskom mjesecu po računu, bez obzira na broj ključeva.
Koristite odgovore kako biste ljudima pomogli pronaći, čitati i naručivati knjige. Prenesite ono što odgovor kaže, zadržite poveznicu na našu stranicu i ne predstavljajte naše sažetke, vodiče za učenje ni tekstove kao svoje.
Nemojte masovno kopirati naše tekstove, sažetke ili vodiče za učenje, pohranjivati ih kao bazu za odgovore, preprodavati ih ni trenirati model na njima. Za to je potrebna pisana licencija: pogledajte Licencije za AI i podatke.
Nemojte pokušavati zaobići ograničenja, dijeliti ključ ni pozivati alate na način koji usporava njihovo korištenje drugima. Možemo usporiti, ograničiti ili ukinuti pristup ključa ili adrese s koje se to radi, a vlasnik u bilo kojem trenutku može opozvati ključ.
Alati se pružaju takvi kakvi jesu. Održavamo ih i možemo ih mijenjati ili povući; promjene ćemo objaviti na ovoj stranici.

Privatnost

Usluga bilježi broj poziva prema nazivu alata, statusu te nazivu i verziji klijenta. Ne pohranjuje sadržaj zahtjeva i ne postavlja kolačiće. Primjenjuju se pravila o privatnosti i uvjeti korištenja.

Verzije

Verzija API-ja označena je datumom i vraća se u zaglavlju LOA-Version (trenutačno 2026-10-25). Promjene ćemo objaviti na ovoj stranici.