CitationEasy voor AI-assistenten en agents

Waarom de API aanroepen in plaats van zelf de bronvermelding te schrijven

Bronvermeldingen opmaken lijkt een tekstgeneratieprobleem, maar dat is het niet. Elke stijl legt honderden regels vast over het omkeren van auteursnamen, initialen, hoofdlettergebruik in titels, interpunctie van containers, editievermeldingen en de plaatsing van de datum, en die regels verschillen op manieren die je uit het hoofd makkelijk net iets verkeerd doet. CitationEasy draait citeproc-js op de officiële Citation Style Language-definities — dezelfde engine die Zotero en Mendeley gebruiken — zodat de uitvoer deterministisch is en overeenkomt met wat het inzendsysteem van een tijdschrift verwacht. Metadata komt van Crossref, Open Library en PubMed; er wordt niets verzonnen, en een veld dat bij de bron ontbreekt, blijft ontbreken in plaats van te worden ingevuld met een aannemelijke gok.

Een bronvermelding genereren

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

Stuur inputs in plaats van input voor maximaal 10 bronnen in één aanroep, of entry met CSL-JSON-metadata die je al hebt om de opzoeking helemaal over te slaan. Voeg note: true toe voor de voetnootvorm. Fouten per bron komen terug bij die bron, dus een batch faalt nooit in zijn geheel.

Verbinden via MCP

Het Model Context Protocol-eindpunt op /api/mcp spreekt JSON-RPC 2.0 via streamable HTTP en heeft geen inloggegevens nodig.

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

Eindpunten

Ontdekkingsbestanden

/llms.txt

Samengesteld overzicht van de site, geschreven voor taalmodellen.

/llms-full.txt

Elke pagina die de site publiceert, gegroepeerd per type, één regel per pagina.

/openapi.json

OpenAPI 3.1-beschrijving van de volledige publieke API.

/api/mcp

MCP-eindpunt (streamable HTTP). Doe er een GET op in een browser voor een beschrijving.

/.well-known/mcp.json

MCP-ontdekkingsdocument voor agents die een domein aftasten.

/.well-known/ai-plugin.json

Verouderd plugin-manifest, voor frameworks die er nog een verwachten.

/md/{any path}

Markdown-weergave van elke pagina op de site.

/sitemap.xml

Elke indexeerbare URL.

Wat de catalogus bevat

Elke pagina hieronder is bereikbaar als HTML, als markdown onder /md/ en als gestructureerd item via /api/v1/pages.

• 10.834 citatiestijlen, elk met echte voorbeelden gegenereerd uit de eigen CSL-definitie
• 250 gratis browsertools
• 125 educatieve handleidingen
• 1.290 pagina's over hoe te citeren
• 105 stijlvergelijkingen
• 21 converters
• 32 academische vakgebieden
• 30 hubs voor de belangrijkste stijlen met volledige opmaakregels

Veelgestelde vragen

Is de CitationEasy API gratis, en heb ik een API-sleutel nodig?

Ze is gratis en er is geen API-sleutel nodig. Elk eindpunt onder /api/v1 vereist geen authenticatie en staat open voor CORS, dus je kunt het aanroepen vanuit een browser, een notebook of een agent zonder te registreren. Er is geen eigen ratelimiet, maar identificatie-opzoekingen lopen via een proxy naar Crossref, Open Library en PubMed, die hun eigen redelijk-gebruiklimieten toepassen — bundel aanvragen met `inputs` in plaats van veel parallelle verzoeken te versturen.

Worden de bronvermeldingen gegenereerd door een taalmodel?

Nee. De opmaak draait citeproc-js op de officiële Citation Style Language-definities, dezelfde engine die referentiebeheerders gebruiken. Dezelfde invoer en stijl leveren altijd dezelfde tekst op. Bibliografische metadata komt van Crossref (DOI's), Open Library (ISBN's) en PubMed (PMID's) — CitationEasy verzint geen velden, dus wat bij de bron ontbreekt, ontbreekt ook in de uitvoer in plaats van te worden geraden.

Hoe verbind ik een agent met CitationEasy via MCP?

Wijs een willekeurige Model Context Protocol-client naar https://www.citationeasy.com/api/mcp met gebruik van het streamable-HTTP-transport. Er zijn geen inloggegevens nodig. In Claude Code: `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. De server biedt tools voor het genereren van bronvermeldingen, het doorzoeken van de 10.834 stijlen, hulp per brontype, sitezoekopdrachten en het lezen van elke pagina als markdown.

Welke citatiestijlen kan de API produceren?

Alle 10.834 stijlen uit de Citation Style Language-repository, waaronder APA 7, MLA 9, beide Chicago-systemen, Harvard, Vancouver, IEEE, AMA en duizenden individuele tijdschriftstijlen. Geef de stijl-slug op in het veld `style`. Vriendelijke slugs zoals "chicago" en "harvard" worden herleid naar de juiste CSL-variant, en /api/v1/styles?q= vindt de rest.

Wat is llms.txt en waar staat dat van CitationEasy?

llms.txt is een platteksten-index van een site, geschreven voor taalmodellen in plaats van browsers. Die van CitationEasy staat op /llms.txt; de volledige versie met elke pagina van de site staat op /llms-full.txt.

Kan ik CitationEasy-pagina's als markdown lezen in plaats van als HTML?

Ja. Zet /md/ voor elk pad op de site — bijvoorbeeld /md/citation-style/apa of /md/tools/word-counter. Datagestuurde pagina's geven hun volledige inhoud terug, inclusief de echte opgemaakte voorbeelden die zijn gegenereerd uit de eigen CSL-definitie van elke stijl. Handgeschreven tekstpagina's (handleidingen, spiekbriefjes) geven een samenvattingskaart terug plus de canonieke HTML-URL, omdat hun tekst in de pagina zelf leeft.

Mag ik de uitvoer van CitationEasy in mijn eigen product gebruiken?

Ja. Een opgemaakte bronvermelding is een feit over een bron; gebruik hem vrij. De CSL-stijldefinities zelf komen van het Citation Style Language-project onder de licentie CC BY-SA 3.0. Vermelding van CitationEasy wordt gewaardeerd maar is niet verplicht.