Yapay zeka asistanları ve ajanları için CitationEasy

Kaynağı kendiniz yazmak yerine neden API'yi çağırmalısınız

Kaynak biçimlendirme bir metin üretme problemi gibi görünür ama değildir. Her stil; yazar adı ters çevirme, baş harfler, başlık büyük/küçük harf kullanımı, kapsayıcı noktalama, baskı bilgisi ve tarih yerleşimiyle ilgili yüzlerce kural kodlar ve bunlar, ezberden yapıldığında ince şekillerde yanlış gidilmesi kolay biçimlerde farklılık gösterir. CitationEasy, resmî Citation Style Language tanımlarına karşı citeproc-js'i çalıştırır — Zotero ve Mendeley'in kullandığı aynı motor — böylece çıktı deterministiktir ve bir derginin gönderim sisteminin beklediğiyle eşleşir. Üst veriler Crossref, Open Library ve PubMed'den gelir; hiçbir şey uydurulmaz ve kaynağında eksik olan bir alan, olası bir tahminle doldurulmak yerine eksik kalır.

Bir kaynak oluşturun

curl -s https://www.citationeasy.com/api/v1/cite \
  -H 'Content-Type: application/json' \
  -d '{"input":"10.1038/nature12373","style":"apa","inText":true}'

{
  "style": { "requested": "apa", "slug": "apa", "name": "American Psychological Association (APA) 7th edition" },
  "language": "en-US",
  "results": [
    {
      "input": "10.1038/nature12373",
      "citation": "…formatted reference…",
      "inText": "(Author, 2013)",
      "entry": { "…resolved CSL metadata…": "" }
    }
  ]
}

Tek çağrıda 10'a kadar kaynak için input yerine inputs gönderin ya da aramayı tamamen atlamak için zaten elinizde olan CSL-JSON üst verisiyle entry gönderin. Dipnot biçimi için note: true ekleyin. Kaynak başına oluşan hatalar o kaynakla birlikte döner, bu yüzden bir toplu işlem asla bütün olarak başarısız olmaz.

MCP üzerinden bağlanın

/api/mcp adresindeki Model Context Protocol uç noktası, streamable HTTP üzerinden JSON-RPC 2.0 konuşur ve kimlik bilgisi gerektirmez.

# Claude Code
claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp

# Any MCP client config
{
  "mcpServers": {
    "citationeasy": { "type": "http", "url": "https://www.citationeasy.com/api/mcp" }
  }
}

Uç noktalar

Keşif dosyaları

/llms.txt

Dil modelleri için yazılmış, derlenmiş site dizini.

/llms-full.txt

Sitenin yayınladığı, türe göre gruplandırılmış, her biri tek satır halindeki tüm sayfalar.

/openapi.json

Tüm herkese açık API'nin OpenAPI 3.1 tanımı.

/api/mcp

MCP uç noktası (streamable HTTP). Bir açıklama için tarayıcıda GET isteği yapın.

/.well-known/mcp.json

Bir alan adını sorgulayan ajanlar için MCP keşif belgesi.

/.well-known/ai-plugin.json

Hâlâ bir tane arayan çerçeveler için eski eklenti bildirimi.

/md/{any path}

Sitedeki herhangi bir sayfanın markdown görünümü.

/sitemap.xml

Dizine eklenebilen her URL.

Katalogda neler var

Aşağıdaki her sayfaya HTML olarak, /md/ altında markdown olarak ve /api/v1/pages'ten yapılandırılmış bir girdi olarak ulaşılabilir.

• Her biri kendi CSL tanımından üretilmiş gerçek örneklere sahip 10.834 atıf stili
• 250 ücretsiz tarayıcı aracı
• 125 eğitim rehberi
• 1.290 "nasıl kaynak gösterilir" sayfası
• 105 stil karşılaştırması
• 21 dönüştürücü
• 32 akademik alan
• Tam biçimlendirme kurallarına sahip 30 başlıca stil sayfası

Sık sorulan sorular

CitationEasy API'si ücretsiz mi ve bir API anahtarına ihtiyacım var mı?

Ücretsizdir ve bir API anahtarı yoktur. /api/v1 altındaki her uç nokta kimlik doğrulama gerektirmez ve CORS'a açıktır, bu yüzden onu bir tarayıcıdan, bir not defterinden veya bir ajandan kayıt olmadan çağırabilirsiniz. Kendi hız sınırımız yoktur, ancak tanımlayıcı aramaları kendi adil kullanım sınırlarını uygulayan Crossref, Open Library ve PubMed üzerinden vekil olarak yapılır — birçok paralel istek göndermek yerine `inputs` ile toplu işlem yapın.

Kaynaklar bir dil modeli tarafından mı üretiliyor?

Hayır. Biçimlendirme, kaynakça yöneticilerinin kullandığı aynı motor olan resmî Citation Style Language tanımlarına karşı citeproc-js'i çalıştırır. Aynı girdi ve stil her zaman aynı dizeyi üretir. Bibliyografik üst veriler Crossref'ten (DOI'ler), Open Library'den (ISBN'ler) ve PubMed'den (PMID'ler) gelir — CitationEasy alan uydurmaz, bu yüzden kaynağında eksik olan her şey, tahmin edilmek yerine çıktıda da eksik kalır.

Bir ajanı MCP üzerinden CitationEasy'ye nasıl bağlarım?

Herhangi bir Model Context Protocol istemcisini, streamable HTTP taşımasını kullanarak https://www.citationeasy.com/api/mcp adresine yönlendirin. Herhangi bir kimlik bilgisi gerekmez. Claude Code'da: `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. Sunucu; kaynak oluşturma, 10.834 stilde arama yapma, kaynak türü rehberliği, site araması ve herhangi bir sayfayı markdown olarak okuma için araçlar sunar.

API hangi atıf stillerini üretebilir?

APA 7, MLA 9, her iki Chicago sistemi, Harvard, Vancouver, IEEE, AMA ve binlerce bireysel dergi stili dahil olmak üzere Citation Style Language deposundaki tüm 10.834 stil. Stil slug'ını `style` alanında iletin. "chicago" ve "harvard" gibi kullanıcı dostu slug'lar doğru CSL varyantına çözümlenir, gerisini ise /api/v1/styles?q= bulur.

llms.txt nedir ve CitationEasy'ninki nerede?

llms.txt, tarayıcılar yerine dil modelleri için yazılmış düz metin bir site dizinidir. CitationEasy'ninki /llms.txt adresindedir; sitenin her sayfasını listeleyen eksiksiz sürüm ise /llms-full.txt adresindedir.

CitationEasy sayfalarını HTML yerine markdown olarak okuyabilir miyim?

Evet. Herhangi bir site yoluna /md/ önekini ekleyin — örneğin /md/citation-style/apa veya /md/tools/word-counter. Veri odaklı sayfalar, her stilin kendi CSL tanımından üretilen gerçek biçimlendirilmiş örnekler dahil tam içeriklerini döndürür. Elle yazılmış düzyazı sayfaları (rehberler, özet kılavuzlar), metinleri sayfanın kendisinde yaşadığı için bir özet kartı ile birlikte kanonik HTML URL'sini döndürür.

CitationEasy çıktısını kendi ürünümde kullanabilir miyim?

Evet. Biçimlendirilmiş bir kaynak, bir kaynak hakkındaki bir gerçektir; onu özgürce kullanın. CSL stil tanımlarının kendisi, CC BY-SA 3.0 lisansı altında Citation Style Language projesinden gelir. CitationEasy'ye atıfta bulunmak takdir edilir ama zorunlu değildir.