Gå til indholdet
Library
of Alexandria
Log indPrøv gratis i 3 månederStart gratis

Udviklere

Bibliotekets katalog, dens hylde med gratis bøger og trykte udgaver er tilgængelige for programmer, assistenter og modeller via nitten offentlige skrivebeskyttede værktøjer. Du skal hverken bruge en nøgle eller tilmelde dig. Syv værktøjer mere kan læse en persons eget bibliotek, når personen har forbundet sin konto med sin assistent (se Dit eget bibliotek). Værktøjerne logger aldrig nogen ind, opkræver betaling eller ændrer noget: Hver titel vises med adressen til dens side på libraryofalexandria.com, hvor man kan læse, lytte, printe eller gå i gang.

Tre måder at komme i gang på

  • MCP (Streamable HTTP) på https://mcp.libraryofalexandria.com/mcp: til Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose og alle andre MCP-klienter.
  • REST og OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> og OpenAPI-filen på https://api.libraryofalexandria.com/v1/openapi.json: til scripts, automatiseringsværktøjer (n8n, Zapier, Make, Dify, Flowise), Open WebUI-værktøjsservere og Copilot Studio.
  • Værktøjsfiler til modeludviklere: GET https://api.libraryofalexandria.com/v1/tools?format=openai: til ethvert program, der sender værktøjsdefinitioner til en model. Formaterne er openai, openai-chat, anthropic, gemini, ollama og mcp.

Prøv det på et minut

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

Svaret er {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. Hver titel i data.results har et id, en title, en author og sidens url.

De nitten værktøjer

Otte slår en titel op, ét viser de trykte udgaver, fire gør en personlig trykt kopi klar, og seks hjælper med at studere og vælge. Vælg, hvilke værktøjer en assistent får vist, med ?toolset= på MCP-adressen; en kort liste passer godt til små lokale modeller:

  • https://api.libraryofalexandria.com/mcp: de nitten offentlige værktøjer uden login (adressen til vores katalogoversigter).
  • https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: de samme nitten offentlige værktøjer.
  • ?toolset=catalogue,orders: de tretten værktøjer, der slår en titel op, viser dens trykte udgaver og gør en personlig trykt kopi klar.
  • ?toolset=study: de seks studieværktøjer.
  • https://mcp.libraryofalexandria.com/mcp uden toolset: de nitten offentlige værktøjer og de syv værktøjer til en persons eget bibliotek, i alt seksogtyve; de syv svarer kun med personens tilladelse.
  • search_books (query, language, limit): find titler ud fra ord fra en titel, en forfatter eller et emne på alle katalogets sprog.
  • get_book (id, language): fakta om en titel: forfatter, originaltitel, omslag, trykte udgaver og dens side på hvert sprog.
  • get_summary (id, language, part): den første hovedidé fra en titels 15-minutters resumé i sin helhed samt overskrifterne på de øvrige.
  • get_sample (id, language, page): begyndelsen af en titel, som kan læses gratis, i sider på højst 400 ord.
  • list_free_shelf (language, subject, limit): titlerne på hylden med gratis bøger, sorteret efter sprog og emne.
  • read_free_chapter (id, chapter, page, language): et kapitel fra en titel på hylden med gratis bøger, i sider på højst 400 ord.
  • get_print_options (id, language): en titels trykte udgaver (standard- og storskrift, paperback eller indbundet) med prisen på hver i amerikanske dollars.
  • quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): prisen på et trykt eksemplar af en titel med en personlig beskedside, det samlede beløb for det ønskede antal eksemplarer samt siden, hvor beskeden skrives og bestillingen afgives.
  • get_cover_upload_link (id, language): siden, hvor man kan tilføje sit eget omslagsbillede til et trykt eksemplar.
  • create_custom_print_order (quote_id): siden, hvor man skriver beskeden, ser korrekturen og betaler. Man kan hverken bestille eller betale via assistenten.
  • get_order_status (order_ref, email, language): se status på en trykt bestilling.
  • get_publisher_info: hvem der udgiver biblioteket, dets sprog, vilkårene og siden om privatliv.
  • browse_collection (collection, language, limit, cursor): en færdig hylde med otte titler ad gangen: gratis bøger, let, mellemsvært eller udfordrende niveau, de glemte bøger, titler med et resumé og de mest populære.
  • get_book_facts (id, language): læsefakta om en titel: niveau, længde, læsetid ved tre hastigheder, sider, lydlængde og året for første udgivelse.
  • get_themes (id, language): en titels studievejledning: temaer, symboler, miljø og motiver samt adressen til den fulde vejledning.
  • get_chapter_summary (id, language, chapter): et resumé af et kapitel, en akt eller en scene, eller en liste over kapitler, hvis der ikke er angivet et kapitel.
  • find_quote_source (quote, language): den åbne tekst, det kapitel og det afsnit, som et citat på mindst seks ord stammer fra. Værktøjet angiver steder og gengiver aldrig ordene fra en bog.
  • explain_phrase (phrase, language): hvad et mundheld eller idiom betyder, hvor det stammer fra, og hvilke titler der bruger det.
  • recommend_classics (query, language, level, free_only, limit): forslag til, hvad man kan læse som det næste, ud fra en titel, man har syntes om, eller et emne eller en stemning.

Hvis et resumé, en prøveside eller et kapitel fra hylden med gratis bøger ikke er åbent endnu (en titel, et sprog eller alle tekster, før de er lagt online), får man et tydeligt svar om, at det snart bliver tilgængeligt her. Derefter bliver det udfyldt uden at du behøver at gøre noget. Intet værktøj returnerer en hel bog: Værktøjerne giver kun små, afgrænsede tekststykker og tæller ordene, de udleverer til hver klient (72.000 om dagen og 48.000 i timen; svaret viser, hvor mange der er tilbage).

Forbind en assistent

Alle seksogtyve værktøjer kan kun læse, så enhver klient kan få adgang til dem uden at spørge hver gang. Adressen er https://mcp.libraryofalexandria.com/mcp (tilføj ?toolset=catalogue,study,orders, eller brug https://api.libraryofalexandria.com/mcp, hvis du kun vil bruge de nitten offentlige værktøjer).

  • Claude: Indstillinger, Connectors, Add custom connector. I Claude Code: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
  • ChatGPT: Åbn chatgpt.com/plugins, vælg plusknappen og Add custom MCP server, indtast adressen, og opret pluginet.
  • Cursor: Tilføj "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} under mcpServers i ~/.cursor/mcp.json.
  • VS Code: Kør MCP: Add Server fra Command Palette, vælg HTTP, og indtast adressen.
  • LM Studio (0.3.17 eller nyere): Fanen Program, Install, Edit mcp.json, og tilføj derefter den samme url-post under mcpServers.
  • Open WebUI (0.6.31 eller nyere): Settings, Admin, Integrations, External Tool Servers, Add Connection, vælg MCP (Streamable HTTP), indtast adressen, og vælg ingen godkendelse. Eller vælg OpenAPI-typen, og indtast adressen til OpenAPI-filen.
  • OpenAI Responses API: angiv {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} i tools.

Små lokale modeller fungerer bedst med en kort værktøjsliste: Tilslut kun de værktøjer, opgaven kræver.

Dit eget bibliotek (syv værktøjer, med din tilladelse)

En person med en konto på libraryofalexandria.com kan give sin egen assistent adgang til at se i biblioteket og tale om den bog, personen læser. Assistenten spørger én gang; personen godkender det på libraryofalexandria.com og kan når som helst afbryde forbindelsen på siden med tilsluttede assistenter.

  • get_my_plan: abonnementet, dets status, og hvor mange ord tekst der er tilbage i dag.
  • list_my_library: bøgerne i biblioteket efter status (ønsker at læse, læser, færdig, sat på pause, opgivet).
  • get_book_outline: bogens kapitler og hvilke der er gratis, åbne eller låste. Ingen tekst.
  • get_listen_link: adressen til bogens eller kapitlets lytteside.
  • open_in_reader: adressen til et kapitel (og afsnit) i læseren.
  • search_in_book: søgning efter et søgeord i én bogs åbne kapitler: korte uddrag med en henvisning.
  • get_passage: ét tekstuddrag fra en henvisning, højst 400 ord, med kildeangivelse og en adresse.

Tekst hentes kun fra bøger med åben tekst og fra kapitler, personen må læse, højst 400 ord ad gangen. Forbindelsen bruger OAuth 2.1 med PKCE: dokumenterne findes på /.well-known/oauth-protected-resource/mcp og /.well-known/oauth-authorization-server; et kald uden token svarer med 401 og en WWW-Authenticate-header, der henviser dertil. En assistent registrerer sig med et Client ID Metadata Document eller POST /oauth/register (fem nye klienter i timen fra én adresse).

Kald REST API'et

Hvert værktøj er én handling, POST /v1/<tool>, med værktøjets argumenter som et JSON-objekt og uden nøgle.

// JavaScript (Node 18 eller nyere, browsere, 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, kun standardbiblioteket
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-filen og værktøjsfilerne

OpenAPI 3.1-filen på /v1/openapi.json beskriver hver handling, dens argumenter og formen på svaret. Importér den i Open WebUI, Dify, Flowise, Copilot Studio eller et hvilket som helst OpenAPI-værktøj. For programmer, der sender værktøjsdefinitioner til en model, returnerer GET /v1/tools?format= værktøjerne i det format, den enkelte udbyder ønsker (tilføj &toolset=catalogue,study,orders for kun de nitten offentlige værktøjer): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama og mcp (listen, som MCP-serveren viser). Besvar modellens kald med REST-handlingerne ovenfor.

Fejl

Et problem returneres som application/problem+json (RFC 9457) med type, title, status, detail og en stabil code.

  • 400 invalid_json, invalid_request, unknown_format: indholdet er ikke JSON, et argument mangler eller er forkert (detaljerne angiver hvilket), eller værktøjsfilens format er ukendt.
  • 404 unknown_tool, not_found: værktøjet eller titlen findes ikke.
  • 405 method_not_allowed: værktøjer bruger POST; dokumenterne bruger GET.
  • 413 payload_too_large: indholdet fylder over 8 KB.
  • 415 unsupported_media_type: indholdet skal være JSON.
  • 500 internal: biblioteket kunne ikke svare lige nu. Prøv igen om et øjeblik.

Brug af svarene

  • Gengiv det, svaret siger, og brug titlens url, som den er angivet. Opfind ikke en pris eller et tilbud.
  • Biblioteket er hverken det antikke bibliotek i Alexandria eller Bibliotheca Alexandrina.
  • Betaling og tilmelding foregår kun på libraryofalexandria.com. Et værktøj kan videregive et link; det tager aldrig imod betaling.
  • Der kræves ingen nøgle. Begræns dig til nogle få forespørgsler i sekundet, og send en User-Agent, der angiver navnet på dit program.

Vilkår for udviklere

  • De offentlige værktøjer kan bruges uden nøgle inden for grænserne på denne side. En udviklernøgle, som oprettes af en person, der er logget ind på libraryofalexandria.com, hæver grænserne og viser dit forbrug; den gratis plan tillader 60 kald i minuttet og 1.000 kald i en kalendermåned for kontoen, uanset hvor mange nøgler den har.
  • Brug svarene til at hjælpe folk med at finde, læse og bestille bøger. Gengiv det, et svar siger, behold linket til vores side, og giv ikke vores resuméer, studievejledninger eller tekster ud for at være dine egne.
  • Kopiér ikke vores tekster, resuméer eller studievejledninger i store mængder, gem dem som et lager til at hente svar fra, videresælg dem, eller træn en model på dem. Det kræver en skriftlig licens: se AI- og datalicenser.
  • Forsøg ikke at omgå en grænse, dele en nøgle eller kalde værktøjerne på en måde, der gør dem langsommere for andre. Vi kan sænke hastigheden, begrænse eller afslutte adgangen for en nøgle eller adresse, der gør det, og ejeren kan til enhver tid tilbagekalde en nøgle.
  • Værktøjerne stilles til rådighed, som de er. Vi sørger for, at de virker, og kan ændre eller fjerne et værktøj; ændringer annonceres på denne side.

Privatliv

Tjenesten tæller kald efter værktøjsnavn, status samt klientens navn og version. Den gemmer ikke, hvad der blev spurgt om, og bruger ingen cookies. Privatlivspolitikken og servicevilkårene gælder.

Versioner

API-versionen er en dato, der sendes tilbage i LOA-Version-headeren (nu 2026-10-25). Ændringer annonceres på denne side.