CitationEasy para assistentes e agentes de IA

Por que chamar a API em vez de escrever a citação você mesmo

Formatar uma citação parece um problema de geração de texto, mas não é. Cada estilo codifica centenas de regras sobre inversão de autores, iniciais, capitalização de títulos, pontuação de contêineres, indicações de edição e posicionamento de datas, e elas diferem de formas fáceis de errar sutilmente de memória. O CitationEasy executa o citeproc-js sobre as definições oficiais da Citation Style Language — o mesmo mecanismo usado por Zotero e Mendeley —, então o resultado é determinístico e corresponde ao que o sistema de submissão de um periódico espera. Os metadados vêm do Crossref, Open Library e PubMed; nada é inventado, e um campo ausente na origem permanece ausente em vez de ser preenchido com um palpite plausível.

Gerar uma citação

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

Envie inputs em vez de input para até 10 fontes em uma única chamada, ou entry com metadados CSL-JSON que você já tenha para pular a busca por completo. Adicione note: true para obter a forma de nota de rodapé. As falhas por fonte retornam associadas a essa fonte, então um lote nunca falha por completo.

Conecte-se via MCP

O endpoint do Model Context Protocol em /api/mcp fala JSON-RPC 2.0 sobre HTTP em streaming e não precisa de credenciais.

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

Endpoints

Arquivos de descoberta

/llms.txt

Índice selecionado do site escrito para modelos de linguagem.

/llms-full.txt

Todas as páginas que o site publica, agrupadas por tipo, uma linha cada.

/openapi.json

Descrição OpenAPI 3.1 de toda a API pública.

/api/mcp

Endpoint do MCP (HTTP em streaming). Faça um GET em um navegador para ver uma descrição.

/.well-known/mcp.json

Documento de descoberta do MCP para agentes que sondam um domínio.

/.well-known/ai-plugin.json

Manifesto de plugin legado, para frameworks que ainda procuram um.

/md/{any path}

Visualização em markdown de qualquer página do site.

/sitemap.xml

Todas as URLs indexáveis.

O que há no catálogo

Cada página abaixo pode ser acessada como HTML, como markdown em /md/ e como entrada estruturada em /api/v1/pages.

• 10.834 estilos de citação, cada um com exemplos reais gerados a partir de sua própria definição CSL
• 250 ferramentas gratuitas de navegador
• 125 guias educativos
• 1.290 páginas de como citar
• 105 comparações de estilos
• 21 conversores
• 32 áreas acadêmicas
• 30 centrais de estilos principais com regras de formatação completas

Perguntas frequentes

A API do CitationEasy é gratuita, e preciso de uma chave de API?

Ela é gratuita e não há chave de API. Todo endpoint em /api/v1 não exige autenticação e tem CORS aberto, então você pode chamá-lo de um navegador, um notebook ou um agente sem se cadastrar. Não há limite de requisições próprio, mas as buscas de identificadores passam pelo Crossref, Open Library e PubMed, que aplicam seus próprios limites de uso justo — agrupe requisições com `inputs` em vez de disparar muitas requisições em paralelo.

As citações são geradas por um modelo de linguagem?

Não. A formatação executa o citeproc-js sobre as definições oficiais da Citation Style Language, o mesmo mecanismo usado por gerenciadores de referências. A mesma entrada e o mesmo estilo sempre produzem a mesma string. Os metadados bibliográficos vêm do Crossref (DOIs), Open Library (ISBNs) e PubMed (PMIDs) — o CitationEasy não inventa campos, então qualquer coisa ausente na origem fica ausente na saída em vez de ser adivinhada.

Como conecto um agente ao CitationEasy via MCP?

Aponte qualquer cliente do Model Context Protocol para https://www.citationeasy.com/api/mcp usando o transporte HTTP em streaming. Nenhuma credencial é necessária. No Claude Code: `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. O servidor expõe ferramentas para gerar citações, buscar entre os 10.834 estilos, orientação por tipo de fonte, busca no site e leitura de qualquer página como markdown.

Quais estilos de citação a API pode gerar?

Todos os 10.834 estilos do repositório da Citation Style Language, incluindo APA 7, MLA 9, os dois sistemas Chicago, Harvard, Vancouver, IEEE, AMA e milhares de estilos individuais de periódicos. Passe o slug do estilo no campo `style`. Slugs amigáveis como "chicago" e "harvard" resolvem para a variante CSL correta, e /api/v1/styles?q= encontra o restante.

O que é o llms.txt e onde está o do CitationEasy?

llms.txt é um índice em texto simples de um site, escrito para modelos de linguagem em vez de navegadores. O do CitationEasy está em /llms.txt; a versão exaustiva que lista todas as páginas do site está em /llms-full.txt.

Posso ler as páginas do CitationEasy como markdown em vez de HTML?

Sim. Coloque /md/ antes de qualquer caminho do site — por exemplo, /md/citation-style/apa ou /md/tools/word-counter. As páginas baseadas em dados retornam seu conteúdo completo, incluindo os exemplos reais gerados a partir da própria definição CSL de cada estilo. Páginas de texto escritas à mão (guias, guias rápidos) retornam um cartão-resumo e a URL HTML canônica, já que o texto delas vive na própria página.

Posso usar a saída do CitationEasy no meu próprio produto?

Sim. Uma citação formatada é um fato sobre uma fonte; use-a livremente. As próprias definições de estilo CSL vêm do projeto Citation Style Language sob a licença CC BY-SA 3.0. A atribuição ao CitationEasy é bem-vinda, mas não é obrigatória.