Kehittäjät

Kirjaston luettelo, maksuttomien kirjojen hylly ja painetut painokset ovat ohjelmien, avustajien ja mallien käytettävissä yhdeksäntoista julkisena, vain luku -työkaluna. Avainta ei tarvita eikä palveluun tarvitse rekisteröityä. Seitsemän muuta työkalua lukee henkilön omaa kirjastoa, kun hän on yhdistänyt tilinsä avustajaansa (katso Oma kirjastosi). Työkalut eivät koskaan kirjaudu kenenkään puolesta sisään, ota vastaan maksua tai muuta mitään: jokaisen nimekkeen mukana palautetaan sen sivun osoite osoitteessa libraryofalexandria.com, jossa voi lukea, kuunnella, tulostaa tai aloittaa.

Kolme tapaa käyttää työkaluja

MCP (Streamable HTTP) osoitteessa https://mcp.libraryofalexandria.com/mcp: Claudea, ChatGPT:tä, Geminiä, Grokia, Copilotia, Perplexityä, Le Chat’ta, LM Studiota, Open WebUIta, Cursoria, VS Codea, Goosea ja kaikkia muita MCP-asiakasohjelmia varten.
REST ja OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> ja OpenAPI-tiedosto osoitteessa https://api.libraryofalexandria.com/v1/openapi.json: skriptejä, automaatiotyökaluja (n8n, Zapier, Make, Dify, Flowise), Open WebUI -työkaluohjelmia ja Copilot Studiota varten.
Työkalutiedostot mallien kehittäjille: GET https://api.libraryofalexandria.com/v1/tools?format=openai: ohjelmille, jotka välittävät työkalumäärityksiä mallille. Muodot ovat openai, openai-chat, anthropic, gemini, ollama ja mcp.

Kokeile minuutissa

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

Vastaus on {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. Jokaisella data.results-tuloksen nimekkeellä on id, title, author ja sivun url.

Yhdeksäntoista työkalua

Kahdeksan hakee nimekkeen, yksi näyttää painetut painokset, neljä valmistelee henkilökohtaisen painetun kappaleen ja kuusi auttaa opiskelemaan ja valitsemaan. Valitse MCP-osoitteessa kohdalla ?toolset=, mitkä työkalut avustaja näkee. Lyhyt luettelo sopii pienille paikallisille malleille:

https://api.libraryofalexandria.com/mcp: yhdeksäntoista julkista työkalua, ei sisäänkirjautumista (hakemistomme luetteloiden osoite).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: samat yhdeksäntoista julkista työkalua.
?toolset=catalogue,orders: kolmetoista työkalua, jotka hakevat nimekkeen, näyttävät sen painetut painokset ja valmistelevat henkilökohtaisen painetun kappaleen.
?toolset=study: kuusi opiskelutyökalua.
https://mcp.libraryofalexandria.com/mcp ilman toolset-määritystä: yhdeksäntoista julkista työkalua ja seitsemän henkilön oman kirjaston työkalua, yhteensä kaksikymmentäkuusi. Seitsemän jälkimmäistä vastaa vain henkilön luvalla.

search_books (query, language, limit): etsi nimekkeitä nimen, tekijän tai aiheen sanoilla millä tahansa luettelon kielellä.
get_book (id, language): yhden nimekkeen tiedot: tekijä, alkuperäinen nimi, kansi, painetut painokset ja sen sivu kullakin kielellä.
get_summary (id, language, part): yhden nimekkeen 15 minuutin yhteenvedon ensimmäinen keskeinen ajatus kokonaisuudessaan ja muiden osien otsikot.
get_sample (id, language, page): yhden nimekkeen maksuton alkuteksti enintään 400 sanan sivuina.
list_free_shelf (language, subject, limit): maksuttomien kirjojen hyllyn nimekkeet kielen ja aiheen mukaan.
read_free_chapter (id, chapter, page, language): yksi luku maksuttomien kirjojen hyllyn nimekkeestä enintään 400 sanan sivuina.
get_print_options (id, language): yhden nimekkeen painetut painokset (tavallinen ja isotekstinen, pehmeäkantinen tai kovakantinen) sekä kunkin hinta Yhdysvaltain dollareina.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): yhden nimekkeen painetun kappaleen hinta henkilökohtaisella viestisivulla, kappaleiden yhteishinta sekä sivu, jolla viesti kirjoitetaan ja tilaus tehdään.
get_cover_upload_link (id, language): sivu, jolla voi lisätä omaan painettuun kappaleeseen oman kansikuvan.
create_custom_print_order (quote_id): sivu, jolla kirjoitetaan viesti, tarkistetaan vedos ja maksetaan. Avustajan kautta ei tilata eikä makseta mitään.
get_order_status (order_ref, email, language): painetun tilauksen tilanne.
get_publisher_info: kuka julkaisee kirjastoa, sen kielet, käyttöehdot ja tietosuojasivu.
browse_collection (collection, language, limit, cursor): valmiiksi koottu hylly, kahdeksan nimekettä kerrallaan: maksuttomat kirjat, helppo, keskitasoinen tai haastava taso, kadonneet kirjat, yhteenvedon sisältävät nimekkeet ja suosituimmat.
get_book_facts (id, language): yhden nimekkeen lukutiedot: taso, pituus, lukuaika kolmella tahdilla, sivut, äänitteen kesto ja ensimmäisen julkaisun vuosi.
get_themes (id, language): yhden nimekkeen opas: teemat, symbolit, tapahtumapaikka ja motiivit sekä koko oppaan osoite.
get_chapter_summary (id, language, chapter): yhden luvun, näytöksen tai kohtauksen yhteenveto tai lukuluettelo, jos lukua ei ole annettu.
find_quote_source (quote, language): avoin teksti, luku ja kappale, josta vähintään kuuden sanan sitaatti on peräisin. Työkalu kertoo kohdat eikä koskaan palauta kirjan sanoja.
explain_phrase (phrase, language): sanonnan tai idiomin merkitys ja alkuperä sekä nimekkeet, joissa sitä käytetään.
recommend_classics (query, language, level, free_only, limit): mitä lukea seuraavaksi henkilön pitämän nimekkeen, aiheen tai tunnelman perusteella.

Jos yhteenveto, näytesivu tai maksuttoman kirjan luku ei ole vielä saatavilla (nimeke, kieli tai kaikki tekstit ennen niiden julkaisemista), työkalu kertoo selkeästi, että se avautuu täällä pian. Sisältö täydentyy sen jälkeen ilman, että sinun tarvitsee tehdä mitään. Mikään työkalu ei palauta kokonaista kirjaa: työkalut palauttavat pieniä, rajattuja katkelmia ja laskevat kullekin asiakkaalle luovuttamiensa sanojen määrän (72 000 päivässä ja 48 000 tunnissa; vastauksessa näytetään jäljellä oleva määrä).

Yhdistä avustaja

Kaikki kaksikymmentäkuusi työkalua ovat vain luku -työkaluja, joten mikä tahansa asiakasohjelma voi sallia niiden käytön kysymättä joka kerta. Osoite on https://mcp.libraryofalexandria.com/mcp (lisää ?toolset=catalogue,study,orders tai käytä osoitetta https://api.libraryofalexandria.com/mcp, jos haluat vain yhdeksäntoista julkista työkalua).

Claude: Settings, Connectors, Add custom connector. Claude Codessa: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: avaa chatgpt.com/plugins, valitse pluspainike ja Add custom MCP server, anna osoite ja luo liitännäinen.
Cursor: lisää "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} kohtaan mcpServers tiedostossa ~/.cursor/mcp.json.
VS Code: suorita komentovalikosta MCP: Add Server, valitse HTTP ja anna osoite.
LM Studio (0.3.17 tai uudempi): Program-välilehti, Install, Edit mcp.json ja lisää sitten sama url-määritys kohtaan mcpServers.
Open WebUI (0.6.31 tai uudempi): Settings, Admin, Integrations, External Tool Servers, Add Connection; valitse MCP (Streamable HTTP), anna osoite ja valitse ei tunnistautumista. Tai valitse OpenAPI-tyyppi ja anna OpenAPI-tiedoston osoite.
OpenAI Responses API: lisää {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} kohtaan tools.

Pienet paikalliset mallit toimivat parhaiten lyhyellä työkaluluettelolla: yhdistä vain tehtävässä tarvittavat työkalut.

Oma kirjastosi (seitsemän työkalua, luvallasi)

libraryofalexandria.com-sivuston käyttäjä voi antaa oman avustajansa tutustua kirjastoonsa ja keskustella lukemastaan kirjasta. Avustaja kysyy luvan kerran; käyttäjä hyväksyy sen libraryofalexandria.com-sivustolla ja voi katkaista yhteyden milloin tahansa yhdistettyjen avustajien sivulta.

get_my_plan: tilaus, sen tila ja tämän päivän jäljellä oleva tekstimäärä sanoina.
list_my_library: kirjaston kirjat tilan mukaan (haluan lukea, luen, luettu, tauolla, keskeytetty).
get_book_outline: kirjan luvut ja tieto siitä, mitkä ovat maksuttomia, avoimia tai lukittuja. Ei tekstiä.
get_listen_link: kirjan tai luvun kuuntelusivun osoite.
open_in_reader: luvun (ja kappaleen) osoite lukijassa.
search_in_book: avointen lukujen avainsanahaku yhdessä kirjassa: lyhyitä tekstikatkelmia sijaintitiedon kera.
get_passage: yksi tekstikatkelma sijaintitiedon perusteella, enintään 400 sanaa, lähdeviitteen ja osoitteen kera.

Tekstiä saa vain kirjoista, joiden teksti on avoinna, ja luvuista, joita käyttäjä saa lukea; kerralla enintään 400 sanaa. Yhteys käyttää OAuth 2.1:tä ja PKCE:tä: dokumentit ovat osoitteissa /.well-known/oauth-protected-resource/mcp ja /.well-known/oauth-authorization-server; ilman tunnusta tehty pyyntö palauttaa 401-vastauksen, jonka WWW-Authenticate-otsake osoittaa niihin. Avustaja rekisteröityy Client ID Metadata Document -asiakirjalla tai pyynnöllä POST /oauth/register (viisi uutta asiakasta tunnissa yhdestä osoitteesta).

REST API:n käyttö

Jokainen työkalu on yksi toiminto, POST /v1/<tool>, jossa työkalun argumentit annetaan JSON-objektina ilman avainta.

// JavaScript (Node 18 tai uudempi, selaimet, 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, vain vakiokirjasto
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-tiedosto ja työkalutiedostot

Osoitteessa /v1/openapi.json oleva OpenAPI 3.1 -tiedosto kuvaa kaikki toiminnot, niiden argumentit ja vastausten rakenteen. Tuo se Open WebUI:hin, Difyyn, Flowiseen, Copilot Studioon tai mihin tahansa OpenAPI-työkaluun. Ohjelmille, jotka välittävät työkalumääritykset mallille, GET /v1/tools?format= palauttaa työkalut kunkin valmistajan tarvitsemassa muodossa (lisää &toolset=catalogue,study,orders, jos haluat vain yhdeksäntoista julkista työkalua): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama ja mcp (MCP-palvelimen näyttämä luettelo). Vastaa mallin tekemiin kutsuihin yllä mainituilla REST-toiminnoilla.

Virheet

Virhe palautetaan muodossa application/problem+json (RFC 9457), ja se sisältää kentät type, title, status, detail ja pysyvän code-arvon.

400 invalid_json, invalid_request, unknown_format: runko ei ole JSON-muodossa, argumentti puuttuu tai on virheellinen (lisätiedossa kerrotaan mikä), tai työkalutiedoston muotoa ei tunnisteta.
404 unknown_tool, not_found: työkalua tai nimekettä ei löydy.
405 method_not_allowed: työkalut käyttävät POST-pyyntöjä, dokumentit GET-pyyntöjä.
413 payload_too_large: runko ylittää 8 kilotavua.
415 unsupported_media_type: rungon on oltava JSON-muodossa.
500 internal: kirjasto ei juuri nyt pystynyt vastaamaan. Yritä hetken kuluttua uudelleen.

Vastausten käyttö

Kerro vastauksen sisältö ja käytä nimekkeen url-osoitetta sellaisenaan. Älä keksi hintaa tai tarjousta.
Kirjasto ei ole antiikin Aleksandrian kirjasto eikä Bibliotheca Alexandrina.
Maksaminen ja rekisteröityminen tapahtuvat vain libraryofalexandria.com-sivustolla. Työkalu voi antaa linkin, mutta sillä ei voi maksaa.
Avain ei ole tarpeen. Pidä pyyntömäärä muutamassa sekunnissa ja lähetä User-Agent, jossa ohjelmasi nimi näkyy.

Kehittäjien käyttöehdot

Julkisia työkaluja voi käyttää ilman avainta ja maksutta tämän sivun rajoitusten puitteissa. libraryofalexandria.com-sivustolle kirjautunut käyttäjä voi luoda kehittäjäavaimen, joka nostaa rajoja ja näyttää käyttötiedot; maksuton tilaus sallii tilille 60 kutsua minuutissa ja 1 000 kutsua kalenterikuukaudessa avainten määrästä riippumatta.
Käytä vastauksia auttaaksesi ihmisiä löytämään, lukemaan ja tilaamaan kirjoja. Kerro vastauksen sisältö, säilytä linkki sivullemme äläkä esitä yhteenvetojamme, opinto-oppaitamme tai tekstejämme ominasi.
Älä kopioi tekstejämme, yhteenvetojamme tai opinto-oppaitamme suuria määriä, säilytä niitä vastausten lähdeaineistona, myy niitä edelleen tai kouluta niillä mallia. Tähän tarvitaan kirjallinen lisenssi: katso AI- ja datalisenssit.
Älä yritä kiertää rajoituksia, jakaa avainta tai käyttää työkaluja tavalla, joka hidastaa niitä muille. Voimme hidastaa tai rajoittaa tällaisen avaimen tai osoitteen käyttöä tai lopettaa sen; avaimen omistaja voi myös mitätöidä avaimen milloin tahansa.
Työkalut tarjotaan sellaisinaan. Pidämme ne toiminnassa, mutta voimme muuttaa tai poistaa työkalun; muutoksista ilmoitetaan tällä sivulla.

Tietosuoja

Palvelu laskee kutsut työkalun nimen, tilan sekä asiakkaan nimen ja version perusteella. Se ei tallenna kysyttyä sisältöä eikä aseta evästeitä. Tietosuojakäytäntöä ja käyttöehtoja sovelletaan.

Versiot

API-versio ilmoitetaan päivämääränä LOA-Version-otsakkeessa (nyt 2026-10-25). Muutoksista ilmoitetaan tällä sivulla.