CitationEasy dla asystentów i agentów AI

Dlaczego wywołać API zamiast samodzielnie pisać cytowanie

Formatowanie cytowań wygląda jak problem generowania tekstu, ale nim nie jest. Każdy styl koduje setki zasad dotyczących odwrócenia kolejności autorów, inicjałów, wielkości liter w tytułach, interpunkcji kontenera, oznaczeń wydania i umiejscowienia daty — a style różnią się w sposób, który łatwo subtelnie pomylić, pisząc z pamięci. CitationEasy uruchamia citeproc-js na oficjalnych definicjach Citation Style Language — tym samym silniku, którego używają Zotero i Mendeley — dzięki czemu wynik jest deterministyczny i zgodny z tym, czego oczekuje system zgłoszeń danego czasopisma. Metadane pochodzą z Crossref, Open Library i PubMed; nic nie jest wymyślane, a pole brakujące u źródła pozostaje puste zamiast być uzupełnione prawdopodobnym zgadywaniem.

Wygeneruj cytowanie

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…": "" }
    }
  ]
}

Wyślij inputs zamiast input, aby obsłużyć do 10 źródeł w jednym wywołaniu, albo entry z posiadanymi już metadanymi CSL-JSON, aby całkowicie pominąć wyszukiwanie. Dodaj note: true, aby otrzymać formę przypisu. Błędy dotyczące pojedynczego źródła są zwracane przy tym źródle, więc cała partia nigdy nie zawodzi jako całość.

Połącz się przez MCP

Punkt końcowy Model Context Protocol pod adresem /api/mcp komunikuje się protokołem JSON-RPC 2.0 przez streamable HTTP i nie wymaga danych uwierzytelniających.

# 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" }
  }
}

Punkty końcowe

Pliki odkrywania

/llms.txt

Wyselekcjonowany indeks witryny napisany z myślą o modelach językowych.

/llms-full.txt

Każda strona publikowana przez witrynę, pogrupowana według typu, po jednej linijce.

/openapi.json

Opis OpenAPI 3.1 całego publicznego API.

/api/mcp

Punkt końcowy MCP (streamable HTTP). Wykonaj GET w przeglądarce, aby zobaczyć opis.

/.well-known/mcp.json

Dokument odkrywania MCP dla agentów sprawdzających domenę.

/.well-known/ai-plugin.json

Starszy manifest wtyczki, dla frameworków, które go jeszcze wyszukują.

/md/{any path}

Widok markdown dowolnej strony w witrynie.

/sitemap.xml

Każdy indeksowalny adres URL.

Co znajduje się w katalogu

Każda z poniższych stron jest dostępna jako HTML, jako markdown pod /md/ oraz jako ustrukturyzowany wpis z /api/v1/pages.

• 10 834 stylów cytowania, każdy z rzeczywistymi przykładami wygenerowanymi na podstawie jego własnej definicji CSL
• 250 darmowych narzędzi przeglądarkowych
• 125 poradników edukacyjnych
• 1290 stron „jak zacytować”
• 105 porównań stylów
• 21 konwerterów
• 32 dziedzin naukowych
• 30 stron głównych popularnych stylów z pełnymi zasadami formatowania

Najczęściej zadawane pytania

Czy API CitationEasy jest darmowe i czy potrzebuję klucza API?

Jest darmowe i nie wymaga klucza API. Każdy punkt końcowy pod /api/v1 nie wymaga uwierzytelnienia i jest otwarty na CORS, więc możesz go wywołać z przeglądarki, notebooka lub agenta bez rejestracji. Nie ma naszego własnego limitu zapytań, ale wyszukiwania identyfikatorów są przekazywane do Crossref, Open Library i PubMed, które stosują własne limity uczciwego użytku — grupuj żądania za pomocą `inputs` zamiast wysyłać wiele równoległych zapytań.

Czy cytowania są generowane przez model językowy?

Nie. Formatowanie uruchamia citeproc-js na oficjalnych definicjach Citation Style Language — tym samym silniku, którego używają menedżery bibliografii. Te same dane wejściowe i ten sam styl zawsze dają ten sam ciąg znaków. Metadane bibliograficzne pochodzą z Crossref (DOI), Open Library (ISBN) i PubMed (PMID) — CitationEasy nie wymyśla pól, więc wszystko, czego brakuje u źródła, brakuje też w wyniku, zamiast być zgadywane.

Jak połączyć agenta z CitationEasy przez MCP?

Skieruj dowolnego klienta Model Context Protocol na https://www.citationeasy.com/api/mcp, używając transportu streamable HTTP. Nie są potrzebne żadne dane uwierzytelniające. W Claude Code: `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. Serwer udostępnia narzędzia do generowania cytowań, przeszukiwania 10 834 stylów, instrukcji dla rodzajów źródeł, wyszukiwania po witrynie oraz odczytu dowolnej strony jako markdown.

Jakie style cytowania może wygenerować API?

Wszystkie 10 834 stylów z repozytorium Citation Style Language, w tym APA 7, MLA 9, oba systemy Chicago, Harvard, Vancouver, IEEE, AMA oraz tysiące indywidualnych stylów czasopism. Przekaż slug stylu w polu `style`. Przyjazne slugi, takie jak „chicago” i „harvard”, rozpoznają właściwy wariant CSL, a /api/v1/styles?q= znajduje resztę.

Czym jest llms.txt i gdzie znajduje się plik CitationEasy?

llms.txt to zwykły tekstowy indeks witryny napisany z myślą o modelach językowych, a nie przeglądarkach. Plik CitationEasy znajduje się pod /llms.txt; wyczerpująca wersja wymieniająca każdą stronę witryny znajduje się pod /llms-full.txt.

Czy mogę odczytać strony CitationEasy jako markdown zamiast HTML?

Tak. Poprzedź dowolną ścieżkę witryny prefiksem /md/ — na przykład /md/citation-style/apa lub /md/tools/word-counter. Strony oparte na danych zwracają swoją pełną treść, w tym rzeczywiste sformatowane przykłady wygenerowane na podstawie własnej definicji CSL każdego stylu. Strony z ręcznie napisaną prozą (poradniki, ściągawki) zwracają kartę podsumowującą oraz kanoniczny adres URL HTML, ponieważ ich tekst znajduje się na samej stronie.

Czy mogę wykorzystać wynik CitationEasy we własnym produkcie?

Tak. Sformatowane cytowanie jest faktem dotyczącym źródła — możesz go używać dowolnie. Same definicje stylów CSL pochodzą z projektu Citation Style Language na licencji CC BY-SA 3.0. Wskazanie CitationEasy jako źródła jest mile widziane, ale nie jest wymagane.