CitationEasy per assistenti e agenti IA

Perché chiamare la API invece di scrivere tu stesso la citazione

Formattare una citazione sembra un problema di generazione di testo, ma non lo è. Ogni stile codifica centinaia di regole su inversione degli autori, iniziali, title case, punteggiatura dei contenitori, indicazioni di edizione e posizione della data, e queste regole differiscono in modi facili da sbagliare leggermente a memoria. CitationEasy esegue citeproc-js sulle definizioni ufficiali di Citation Style Language — lo stesso motore usato da Zotero e Mendeley — quindi l'output è deterministico e corrisponde a ciò che si aspetta il sistema di invio di una rivista. I metadati provengono da Crossref, Open Library e PubMed; niente viene inventato, e un campo mancante a monte resta mancante invece di essere riempito con una supposizione plausibile.

Genera una citazione

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

Invia inputs invece di input per un massimo di 10 fonti in un'unica chiamata, oppure entry con i metadati CSL-JSON che hai già per saltare del tutto la ricerca. Aggiungi note: true per la forma in nota a piè di pagina. Gli errori per singola fonte tornano su quella fonte, quindi un batch non fallisce mai nel suo complesso.

Connettersi tramite MCP

L'endpoint Model Context Protocol su /api/mcp parla JSON-RPC 2.0 su HTTP streamable e non richiede credenziali.

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

Endpoint

File di scoperta

/llms.txt

Indice curato del sito, scritto per i modelli linguistici.

/llms-full.txt

Ogni pagina pubblicata dal sito, raggruppata per tipo, una riga ciascuna.

/openapi.json

Descrizione OpenAPI 3.1 dell'intera API pubblica.

/api/mcp

Endpoint MCP (HTTP streamable). Effettua una GET dal browser per ottenerne una descrizione.

/.well-known/mcp.json

Documento di scoperta MCP per gli agenti che sondano un dominio.

/.well-known/ai-plugin.json

Manifest plugin legacy, per i framework che ne cercano ancora uno.

/md/{any path}

Vista in markdown di qualsiasi pagina del sito.

/sitemap.xml

Ogni URL indicizzabile.

Cosa contiene il catalogo

Ogni pagina elencata di seguito è raggiungibile come HTML, come markdown sotto /md/ e come voce strutturata da /api/v1/pages.

• 10.834 stili di citazione, ciascuno con esempi reali generati dalla propria definizione CSL
• 250 strumenti gratuiti da browser
• 125 guide didattiche
• 1290 pagine su come citare
• 105 confronti tra stili
• 21 convertitori
• 32 ambiti accademici
• 30 hub dei principali stili con le regole di formattazione complete

Domande frequenti

La API di CitationEasy è gratuita? Serve una chiave API?

È gratuita e non serve alcuna chiave API. Ogni endpoint sotto /api/v1 non richiede autenticazione ed è aperto al CORS, quindi puoi chiamarlo da un browser, un notebook o un agente senza registrarti. Non c'è alcun limite di frequenza imposto da noi, ma le ricerche per identificatore passano tramite proxy a Crossref, Open Library e PubMed, che applicano i propri limiti di uso corretto — raggruppa le richieste con `inputs` invece di lanciarne molte in parallelo.

Le citazioni sono generate da un modello linguistico?

No. La formattazione esegue citeproc-js sulle definizioni ufficiali di Citation Style Language, lo stesso motore usato dai gestori di riferimenti bibliografici. Lo stesso input e lo stesso stile producono sempre la stessa stringa. I metadati bibliografici provengono da Crossref (DOI), Open Library (ISBN) e PubMed (PMID) — CitationEasy non inventa alcun campo, quindi ciò che manca a monte manca anche nell'output, invece di essere indovinato.

Come collego un agente a CitationEasy tramite MCP?

Punta qualsiasi client Model Context Protocol verso https://www.citationeasy.com/api/mcp usando il trasporto HTTP streamable. Non servono credenziali. In Claude Code: `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. Il server espone strumenti per generare citazioni, cercare tra i 10.834 stili, ottenere indicazioni per tipo di fonte, cercare nel sito e leggere qualsiasi pagina come markdown.

Quali stili di citazione può produrre la API?

Tutti i 10.834 stili del repository Citation Style Language, inclusi APA 7, MLA 9, entrambi i sistemi Chicago, Harvard, Vancouver, IEEE, AMA e migliaia di stili di singole riviste. Passa lo slug dello stile nel campo `style`. Slug semplici come "chicago" e "harvard" vengono risolti nella variante CSL corretta, e /api/v1/styles?q= trova gli altri.

Cos'è llms.txt e dove si trova quello di CitationEasy?

llms.txt è un indice in testo semplice di un sito, scritto per i modelli linguistici anziché per i browser. Quello di CitationEasy si trova su /llms.txt; la versione esaustiva che elenca ogni pagina del sito è su /llms-full.txt.

Posso leggere le pagine di CitationEasy come markdown invece che come HTML?

Sì. Anteponi /md/ a qualsiasi percorso del sito — ad esempio /md/citation-style/apa o /md/tools/word-counter. Le pagine basate sui dati restituiscono il loro contenuto completo, inclusi i veri esempi formattati generati dalla definizione CSL propria di ciascuno stile. Le pagine di testo scritto a mano (guide, schede riassuntive) restituiscono una scheda riassuntiva più l'URL HTML canonico, poiché il loro testo vive nella pagina stessa.

Posso usare l'output di CitationEasy nel mio prodotto?

Sì. Una citazione formattata è un fatto relativo a una fonte; usala liberamente. Le definizioni degli stili CSL stesse provengono dal progetto Citation Style Language sotto licenza CC BY-SA 3.0. Un rimando a CitationEasy è apprezzato ma non obbligatorio.