Geliştiriciler

Kütüphanenin kataloğu, ücretsiz kitap rafı ve basılı edisyonları, herkese açık on dokuz salt okunur araç olarak programlara, asistanlara ve modellere açıktır. Anahtar veya kayıt gerekmez. Yedi araç daha, kişi hesabını asistanına bağladıktan sonra kendi kütüphanesini okur (bkz. Kendi kütüphanen). Araçlar kimsenin oturumunu açmaz, ödeme almaz veya herhangi bir şeyi değiştirmez: her kitap, kişinin okuyabileceği, dinleyebileceği, bastırabileceği veya başlayabileceği libraryofalexandria.com sayfasının adresiyle döner.

Üç erişim yolu

MCP (Streamable HTTP), https://mcp.libraryofalexandria.com/mcp adresinde: Claude, ChatGPT, Gemini, Grok, Copilot, Perplexity, Le Chat, LM Studio, Open WebUI, Cursor, VS Code, Goose ve diğer tüm MCP istemcileri için.
REST ve OpenAPI 3.1: POST https://api.libraryofalexandria.com/v1/<tool> ve https://api.libraryofalexandria.com/v1/openapi.json adresindeki OpenAPI dosyası: betikler, otomasyon araçları (n8n, Zapier, Make, Dify, Flowise), Open WebUI araç sunucuları ve Copilot Studio için.
Model geliştiricileri için araç dosyaları: GET https://api.libraryofalexandria.com/v1/tools?format=openai: bir modele araç tanımları ileten her program için. Biçimler: openai, openai-chat, anthropic, gemini, ollama ve mcp.

Bir dakikada dene

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

Yanıt şöyledir: {"ok": true, "data": {...}, "source": "Library of Alexandria, libraryofalexandria.com"}. data.results içindeki her kitapta bir id, bir title, bir author ve sayfasının url adresi bulunur.

On dokuz araç

Sekizi kitap arar, biri basılı edisyonları gösterir, dördü kişisel bir basılı kopya hazırlar, altısı ise inceleme ve seçim yapmaya yardımcı olur. MCP adresinde ?toolset= kullanarak asistanın göreceği araçları seç; kısa bir liste, küçük yerel modellere uygundur:

https://api.libraryofalexandria.com/mcp: herkese açık on dokuz araç, oturum açmak gerekmez (dizin kayıtlarımızdaki adres).
https://mcp.libraryofalexandria.com/mcp?toolset=catalogue,study,orders: herkese açık aynı on dokuz araç.
?toolset=catalogue,orders: kitap arayan, basılı edisyonlarını gösteren ve kişisel bir basılı kopya hazırlayan on üç araç.
?toolset=study: altı inceleme aracı.
https://mcp.libraryofalexandria.com/mcp, toolset olmadan: herkese açık on dokuz araç ve kişinin kendi kütüphanesine ait yedi araç, toplam yirmi altı araç; bu yedi araç yalnızca kişinin izniyle yanıt verir.

search_books (query, language, limit): katalogdaki herhangi bir dilde kitap adı, yazar veya konuyla ilgili sözcüklerle kitap bul.
get_book (id, language): bir kitabın bilgileri: yazarı, özgün adı, kapağı, basılı edisyonları ve her dildeki sayfası.
get_summary (id, language, part): bir kitabın 15 dakikalık özetindeki ilk ana fikrin tamamı ve diğerlerinin başlıkları.
get_sample (id, language, page): bir kitabın ücretsiz başlangıç bölümü, en fazla 400 sözcüklük sayfalar halinde.
list_free_shelf (language, subject, limit): dil ve konuya göre ücretsiz kitap rafındaki kitaplar.
read_free_chapter (id, chapter, page, language): ücretsiz kitap rafındaki bir kitabın bir bölümü, en fazla 400 sözcüklük sayfalar halinde.
get_print_options (id, language): bir kitabın basılı edisyonları (standart ve büyük puntolu baskı, karton kapak veya sert kapak) ve her birinin ABD doları cinsinden fiyatı.
quote_custom_print (id, language, edition, quantity, dedication, gift, cover, country): bir kitabın kişisel mesaj sayfası içeren basılı kopyasının fiyatı, kopya sayısına göre toplam tutar ve mesajın yazılıp siparişin verildiği sayfa.
get_cover_upload_link (id, language): kişinin basılı kopyaya kendi kapak görselini eklediği sayfa.
create_custom_print_order (quote_id): kişinin mesajını yazdığı, baskı önizlemesini gördüğü ve ödeme yaptığı sayfa. Asistan üzerinden sipariş verilmez veya ödeme yapılmaz.
get_order_status (order_ref, email, language): basılı kitap siparişinin durumu.
get_publisher_info: kütüphanenin yayıncısı, dilleri, koşulları ve gizlilik sayfası.
browse_collection (collection, language, limit, cursor): her seferinde sekiz kitap sunan hazır bir raf: ücretsiz kitaplar, kolay, orta veya zor düzeydeki kitaplar, kayıp kitaplar, özeti olan kitaplar, en popüler kitaplar.
get_book_facts (id, language): bir kitabın okuma bilgileri: düzey, uzunluk, üç farklı hızda okuma süresi, sayfa sayısı, sesli kitap süresi ve ilk yayımlanma yılı.
get_themes (id, language): bir kitabın inceleme rehberi: temalar, semboller, zaman ve mekân ile motifler ve tam rehberin adresi.
get_chapter_summary (id, language, chapter): bir bölümün, perdenin veya sahnenin özeti ya da bölüm belirtilmediğinde bölüm listesi.
find_quote_source (quote, language): en az altı kelimelik bir alıntının geldiği erişime açık metin, bölüm ve paragraf. Konumları belirtir ve hiçbir zaman kitabın sözlerini döndürmez.
explain_phrase (phrase, language): bir sözün veya deyimin anlamı, kökeni ve hangi kitaplarda kullanıldığı.
recommend_classics (query, language, level, free_only, limit): kişinin beğendiği bir kitaba, bir konuya veya ruh hâline göre sırada ne okuyabileceği.

Henüz erişime açılmamış bir özet, örnek sayfa veya ücretsiz kitap rafı bölümü için (bir kitap, bir dil ya da çevrimiçi yayımlanmadan önce tüm metinler) burada yakında erişime açılacağı açıkça belirtilir. Ardından senin herhangi bir değişiklik yapmana gerek kalmadan içerik tamamlanır. Kitabın tamamını döndüren bir araç yoktur: araçlar küçük, sınırlı parçalar döndürür ve her istemciye sundukları kelimeleri sayar (günde 72.000 ve saatte 48.000; yanıtta kalan miktar gösterilir).

Bir asistan bağla

Yirmi altı aracın tümü yalnızca okuma yapar. Bu nedenle herhangi bir istemci, her seferinde sormadan bu araçlara izin verebilir. Adres: https://mcp.libraryofalexandria.com/mcp (yalnızca herkese açık on dokuz araç için ?toolset=catalogue,study,orders ekle veya https://api.libraryofalexandria.com/mcp adresini kullan).

Claude: Ayarlar, Bağlayıcılar, Özel bağlayıcı ekle. Claude Code içinde: claude mcp add --transport http library-of-alexandria https://mcp.libraryofalexandria.com/mcp
ChatGPT: chatgpt.com/plugins adresini aç, artı düğmesini ve Özel MCP sunucusu ekle seçeneğini seç, adresi gir ve eklentiyi oluştur.
Cursor: ~/.cursor/mcp.json dosyasındaki mcpServers altına "library-of-alexandria": {"url": "https://mcp.libraryofalexandria.com/mcp"} ekle.
VS Code: Komut Paleti üzerinden MCP: Sunucu Ekle komutunu çalıştır, HTTP seç ve adresi gir.
LM Studio (0.3.17 veya daha yeni): Program sekmesi, Yükle, mcp.json dosyasını düzenle seçeneklerini izle, ardından aynı url girdisini mcpServers altına ekle.
Open WebUI (0.6.31 veya daha yeni): Ayarlar, Yönetici, Entegrasyonlar, Harici Araç Sunucuları, Bağlantı Ekle seçeneklerini izle; tür olarak MCP (Streamable HTTP) seç, adresi gir ve kimlik doğrulamayı kapalı bırak. Ya da OpenAPI türünü seç ve OpenAPI dosyasının adresini gir.
OpenAI Responses API: tools içinde {"type": "mcp", "server_label": "library", "server_url": "https://mcp.libraryofalexandria.com/mcp", "allowed_tools": ["search_books", "get_book"], "require_approval": "never"} ilet.

Küçük yerel modeller, kısa bir araç listesiyle en iyi sonucu verir: yalnızca görevin gerektirdiği araçları bağla.

Kendi kütüphanen (izninle çalışan yedi araç)

libraryofalexandria.com hesabı olan bir kişi, kendi asistanına kütüphanesine bakma ve okuduğu kitap hakkında konuşma izni verebilir. Asistan bir kez izin ister; kişi bunu libraryofalexandria.com üzerinden onaylar ve bağlı asistanlar sayfasından bağlantıyı istediği zaman kesebilir.

get_my_plan: plan, planın durumu ve bugün kaç kelimelik metin hakkı kaldığı.
list_my_library: durumlarına göre kütüphanedeki kitaplar (okumak istiyor, okuyor, bitirdi, ara verdi, bıraktı).
get_book_outline: bir kitabın bölümleri ve hangilerinin ücretsiz, açık veya kilitli olduğu. Metin içermez.
get_listen_link: bir kitabın veya bölümün dinleme sayfasının adresi.
open_in_reader: bir bölümün (ve paragrafın) okuyucudaki adresi.
search_in_book: bir kitabın açık bölümlerinde anahtar kelime araması: konum bilgisi içeren kısa metin parçaları.
get_passage: konum bilgisiyle alınan, kaynak gösterimi ve adres içeren, en fazla 400 kelimelik bir pasaj.

Metin yalnızca metni açık olan kitaplardan ve kişinin okuyabildiği bölümlerden alınır; tek seferde en fazla 400 kelime sunulur. Bağlantı, PKCE ile OAuth 2.1 kullanır: belgeler /.well-known/oauth-protected-resource/mcp ve /.well-known/oauth-authorization-server adreslerindedir; belirteç olmadan yapılan çağrı, bu adreslere yönlendiren bir WWW-Authenticate başlığıyla 401 yanıtı döndürür. Asistan, bir Client ID Metadata Document veya POST /oauth/register ile kaydolur (bir adresten saatte beş yeni istemci).

REST API'yi çağır

Her araç, argümanları JSON nesnesi olarak iletilen ve anahtar gerektirmeyen tek bir işlemdir: POST /v1/<tool>.

// JavaScript (Node 18 veya daha yenisi, tarayıcılar, 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, yalnızca standart kütüphane
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 dosyası ve araç dosyaları

/v1/openapi.json adresindeki OpenAPI 3.1 dosyası her işlemi, argümanlarını ve yanıt yapısını açıklar. Dosyayı Open WebUI, Dify, Flowise, Copilot Studio veya herhangi bir OpenAPI aracına aktar. Araç tanımlarını bir modele ileten programlar için GET /v1/tools?format=, araçları her sağlayıcının istediği yapıda döndürür (yalnızca herkese açık on dokuz araç için &toolset=catalogue,study,orders ekle): openai (Responses API), openai-chat (Chat Completions), anthropic, gemini, ollama ve mcp (MCP sunucusunun gösterdiği liste). Modelin yaptığı çağrıları yukarıdaki REST işlemleriyle yanıtla.

Hatalar

Bir sorun, type, title, status, detail ve sabit bir code içeren application/problem+json (RFC 9457) olarak döner.

400 invalid_json, invalid_request, unknown_format: gövde JSON biçiminde değildir, bir argüman eksik veya yanlıştır (hangisi olduğu ayrıntıda belirtilir) ya da araç dosyasının biçimi bilinmiyordur.
404 unknown_tool, not_found: böyle bir araç veya kitap adı yok.
405 method_not_allowed: araçlar POST, belgeler GET kullanır.
413 payload_too_large: gövde 8 KB sınırını aşıyor.
415 unsupported_media_type: gövde JSON biçiminde olmalıdır.
500 internal: kütüphane şu anda yanıt veremedi. Biraz sonra yeniden deneyin.

Yanıtların kullanımı

Yanıtta söyleneni aktarın ve bir kitabın url değerini verildiği gibi kullanın. Fiyat veya teklif uydurmayın.
Bu kütüphane, antik İskenderiye Kütüphanesi veya Bibliotheca Alexandrina değildir.
Ödemeler ve kayıt işlemleri yalnızca libraryofalexandria.com üzerinden yapılır. Bir araç bağlantı sunabilir; asla ödeme almaz.
Anahtar gerekmez. Lütfen saniyede birkaç istekle sınırlı kalın ve programınızın adını belirten bir User-Agent gönderin.

Geliştirici koşulları

Herkese açık araçlar, bu sayfadaki sınırlar içinde anahtarsız ve ücretsiz kullanılabilir. libraryofalexandria.com üzerinde oturum açmış bir kişinin oluşturduğu geliştirici anahtarı, sınırları yükseltir ve kullanımınızı gösterir; ücretsiz plan, hesabın kaç anahtarı olursa olsun hesap başına dakikada 60 çağrı ve takvim ayı başına 1,000 çağrı sunar.
Yanıtları, bir kişinin kitap bulmasına, okumasına ve sipariş etmesine yardımcı olmak için kullanın. Yanıtta söyleneni aktarın, sayfamıza verilen bağlantıyı koruyun ve özetlerimizi, inceleme rehberlerimizi veya metinlerimizi kendinizinmiş gibi sunmayın.
Metinlerimizi, özetlerimizi veya inceleme rehberlerimizi toplu olarak kopyalamayın, yanıt vermek üzere bir veri deposunda tutmayın, yeniden satmayın veya bunlarla bir model eğitmeyin. Bunun için yazılı lisans gerekir: Yapay zekâ ve veri lisansları sayfasına bakın.
Bir sınırı aşmaya çalışmayın, anahtar paylaşmayın veya araçları başkaları için yavaşlatacak şekilde çağırmayın. Bunu yapan bir anahtarın veya adresin erişimini yavaşlatabilir, sınırlayabilir veya sonlandırabiliriz. Anahtarın sahibi de anahtarı istediği zaman iptal edebilir.
Araçlar olduğu gibi sunulur. Çalışır durumda kalmalarını sağlarız ve bir aracı değiştirebilir veya kullanımdan kaldırabiliriz; değişiklikler bu sayfada duyurulur.

Gizlilik

Hizmet, çağrıları araç adına, durumuna ve istemcinin adına ve sürümüne göre sayar. Sorulanları saklamaz ve çerez yerleştirmez. Gizlilik politikası ve hizmet koşulları geçerlidir.

Sürümler

API sürümü, LOA-Version başlığında geri gönderilen bir tarihtir (şu anda 2026-10-25). Değişiklikler bu sayfada duyurulur.