CitationEasy pour les assistants et agents IA

Pourquoi appeler l'API plutôt qu'écrire la citation vous-même

La mise en forme des citations ressemble à un problème de génération de texte, mais n'en est pas un. Chaque style encode des centaines de règles sur l'inversion des noms d'auteurs, les initiales, la casse des titres, la ponctuation des conteneurs, les mentions d'édition et le placement des dates, et ces règles diffèrent de façons faciles à mal reproduire de mémoire. CitationEasy exécute citeproc-js sur les définitions officielles de Citation Style Language — le même moteur qu'utilisent Zotero et Mendeley — de sorte que le résultat est déterministe et correspond à ce qu'attend le système de soumission d'une revue. Les métadonnées proviennent de Crossref, Open Library et PubMed ; rien n'est inventé, et un champ manquant en amont reste manquant plutôt que d'être rempli par une supposition plausible.

Générer une citation

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

Envoyez inputs au lieu de input pour traiter jusqu'à 10 sources en un seul appel, ou entry avec des métadonnées CSL-JSON déjà en votre possession pour éviter complètement la recherche. Ajoutez note: true pour obtenir la forme en note de bas de page. Les échecs propres à une source sont renvoyés sur cette source, si bien qu'un lot n'échoue jamais dans son ensemble.

Se connecter via MCP

Le point de terminaison Model Context Protocol à /api/mcp parle JSON-RPC 2.0 sur HTTP en flux continu (streamable HTTP) et ne nécessite aucune identification.

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

Points de terminaison

Fichiers de découverte

/llms.txt

Index sélectionné du site, rédigé pour les modèles de langage.

/llms-full.txt

Toutes les pages publiées par le site, regroupées par type, une ligne chacune.

/openapi.json

Description OpenAPI 3.1 de l'ensemble de l'API publique.

/api/mcp

Point de terminaison MCP (HTTP en flux continu). Faites un GET dans un navigateur pour obtenir une description.

/.well-known/mcp.json

Document de découverte MCP pour les agents qui sondent un domaine.

/.well-known/ai-plugin.json

Manifeste de plugin hérité, pour les frameworks qui en recherchent encore un.

/md/{any path}

Vue markdown de n'importe quelle page du site.

/sitemap.xml

Toutes les URL indexables.

Ce que contient le catalogue

Chaque page ci-dessous est accessible en HTML, en markdown sous /md/, et sous forme d'entrée structurée depuis /api/v1/pages.

• 10 834 styles de citation, chacun avec de vrais exemples générés à partir de sa propre définition CSL
• 250 outils gratuits dans le navigateur
• 125 guides pédagogiques
• 1 290 pages pour citer une source
• 105 comparaisons de styles
• 21 convertisseurs
• 32 disciplines académiques
• 30 hubs des principaux styles avec les règles de mise en forme complètes

Questions fréquentes

L'API CitationEasy est-elle gratuite, et ai-je besoin d'une clé API ?

Elle est gratuite et ne nécessite aucune clé API. Chaque point de terminaison sous /api/v1 est sans authentification et ouvert au CORS, vous pouvez donc l'appeler depuis un navigateur, un notebook ou un agent sans vous inscrire. Il n'y a aucune limite de débit de notre part, mais les recherches par identifiant sont relayées vers Crossref, Open Library et PubMed, qui appliquent leurs propres limites d'usage raisonnable — regroupez vos requêtes avec `inputs` plutôt que d'en envoyer plusieurs en parallèle.

Les citations sont-elles générées par un modèle de langage ?

Non. La mise en forme exécute citeproc-js sur les définitions officielles de Citation Style Language, le même moteur qu'utilisent les gestionnaires de références. La même entrée et le même style produisent toujours la même chaîne. Les métadonnées bibliographiques proviennent de Crossref (DOI), Open Library (ISBN) et PubMed (PMID) — CitationEasy n'invente aucun champ, donc tout ce qui manque en amont manque dans le résultat plutôt que d'être deviné.

Comment connecter un agent à CitationEasy via MCP ?

Pointez n'importe quel client Model Context Protocol vers https://www.citationeasy.com/api/mcp en utilisant le transport HTTP en flux continu. Aucune identification n'est nécessaire. Dans Claude Code : `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. Le serveur expose des outils pour générer des citations, rechercher parmi les 10 834 styles, obtenir des conseils par type de source, effectuer une recherche sur le site, et lire n'importe quelle page en markdown.

Quels styles de citation l'API peut-elle produire ?

Les 10 834 styles du dépôt Citation Style Language, dont APA 7, MLA 9, les deux systèmes Chicago, Harvard, Vancouver, IEEE, AMA, et des milliers de styles de revues individuelles. Transmettez le slug du style dans le champ `style`. Des slugs simples comme "chicago" et "harvard" se résolvent vers la bonne variante CSL, et /api/v1/styles?q= permet de trouver les autres.

Qu'est-ce que llms.txt, et où trouver celui de CitationEasy ?

llms.txt est un index en texte brut d'un site, rédigé pour les modèles de langage plutôt que pour les navigateurs. Celui de CitationEasy se trouve à /llms.txt ; la version exhaustive listant chacune des pages du site se trouve à /llms-full.txt.

Puis-je lire les pages de CitationEasy en markdown plutôt qu'en HTML ?

Oui. Préfixez n'importe quel chemin du site par /md/ — par exemple /md/citation-style/apa ou /md/tools/word-counter. Les pages pilotées par les données renvoient leur contenu complet, y compris les vrais exemples mis en forme générés à partir de la propre définition CSL de chaque style. Les pages de prose rédigées à la main (guides, fiches de style) renvoient une carte résumé ainsi que l'URL HTML canonique, car leur texte réside dans la page elle-même.

Puis-je utiliser le résultat de CitationEasy dans mon propre produit ?

Oui. Une citation mise en forme est un fait concernant une source ; utilisez-la librement. Les définitions de styles CSL elles-mêmes proviennent du projet Citation Style Language sous licence CC BY-SA 3.0. Une attribution vers CitationEasy est appréciée mais non requise.