kayquer/citacoes-abnt
v1.3.0MIT
Biblioteca de citações, checador de referências (detecta referência inventada, quimérica e DOI divergente) e aplicação da ABNT vigente (NBR 6023:2025, 10520:2023, 14724:2024) com perfis de 50 universidades e institutos brasileiros.
Changelog
1.3.0 (2026-11-16)
Compatibilidade com mais agentes e ajustes apontados pelo SkillEvaluator da NVIDIA.
- Hermes:
plugin.jsonna raiz, no formato Agent Plugins v1.hermes plugins install kayquer/citacoes-abnt-skille depoishermes plugins enable citacoes-abnt. - OpenClaw, OpenCode e Copilot CLI: instruções de instalação no README e na página. O
.claude-plugin/plugin.jsonjá servia Codex, Copilot CLI e OpenClaw como plugin; o OpenCode instala as skills dedist/citacoes-abnt-skills.zip. - A
descriptionde cada skill abre com o gatilho (Use quando…). O Hermes mostra só os primeiros ~60 caracteres na lista de skills. metadatano frontmatter (autor, versão e tags, todos como texto, que é o que o Hermes aceita).- Seções Requisitos, Limites e Problemas comuns nas três skills.
tests/test_versao.pyexige a mesma versão em.claude-plugin/plugin.json,plugin.json,gemini-extension.json,CITATION.cffe nometadatadas skills.
1.2.0 (2026-11-01)
Correções e campos novos a partir do relatório de uso num livro de humanidades: 92 obras, 122 notas de rodapé, conversão de Chicago para ABNT.
Correções
- A lista exportada em ABNT leva o mesmo
2010a/2010bda chamada. Antes, só a chamada recebia o sufixo. - Título que termina em
?ou!não ganha ponto depois (...X/Twitter?.vira...X/Twitter?). - Capítulo na obra do próprio autor: com
in_mesmo_autor: true, o autor se repete depois deIn:sem(org.). - Entrada pelo título com artigo ou monossílabo inicial:
A SOCIEDADE do espetáculo,(A sociedade [...], 1997). - Entidade com
siglasaiNOME (SIGLA)na referência, para casar com a chamada(SIGLA, ano). problemas_textoaceita ano com sufixo (2010a) e anos de 1000 a 1499.- A leitura de URL confere também o destino dos redirecionamentos (SSRF).
Campos novos no formatador
eloc(e-localização):v. 118, n. 9, e2023301118, 2021., semp.. O Crossref preenche peloarticle-number. Identificador gravado empaginastambém sai semp..- Tipo
jornal, comdata(AAAA-MM-DD) ecaderno:**Jornal**, Local, ano 131, n. 42656, 1 ago. 2010. Caderno, p. B1.Site e artigo também aceitamdata. volume_obra:2010. v. 12, p. 170-194.Livro comvolumetambém sai comv..- Responsabilidades:
organizacao,revisao,prefacio,introducao,notas_de,ilustracaoou a listaresponsabilidades, no lugar da tradução. O Crossref preenchetradutor. titulo_atribuido: título entre colchetes.faltantesavisa sobre local com homônimo (Cambridge, Birmingham) e sobre identificador gravado como página.- BibTeX (
date,eid,section,entrysubtype = newspaper,foreword,introduction,annotator), RIS (NEWS,DA) e CSL-JSON (article-newspaper, data completa,section) levam os campos novos.
Notas de rodapé
biblioteca.py notas "id:pág, id:pág": a primeira citação de cada obra sai completa, com o localizador no lugar das páginas; as seguintes, abreviadas (FREUD, 2010a, p. 180.).--expressoes-latinasusa Ibid. e Id., e--minusculasproduz a forma abreviada em caixa baixa.biblioteca.py nota id --forma completa|curta|ibid|idem|opcit|loccit.- O conferidor lê as notas do .docx (rodapé e fim) e do Markdown (
[^n]:). A obra citada só em nota conta como citada. Ele também avisa quando a primeira citação vem abreviada, quando a nota cita autor fora da lista e quando há Ibid. sem nota anterior.
Checador de existência
- Progresso no stderr (
[12/92] verificada: ...),--saida checagem.jsonlgravado a cada obra e--retomar, que refaz só o que caiu ou esbarrou no limite de taxa. - Cache em disco de 30 dias (
~/.cache/citacoes-abnt,--sem-cache). - Bases consultadas em paralelo, cada uma com uma chamada por vez.
- Cota esgotada: com
Retry-Afterlongo ou 429 seguidos, a base sai da rodada em vez de atrasar cada obra. OPENALEX_API_KEY: sem chave, o OpenAlex agora usa uma cota diária dividida por IP.homonimo: mesmo título com outro autor em outro ano (mais de 5) ou tipo (livro × artigo) não vira maisquimera.- A comparação de título aceita a base com só o título principal ("Get the message").
- Um sobrenome comum numa lista longa não confirma autoria sozinho: precisa ser o do primeiro autor de um dos lados.
sugestao_doisó sai com ano compatível e mesmo periódico. DOI de preprint (SSRN, arXiv, bioRxiv...) e de reedição é recusado com alerta.- Notícia, site e lei não vão para as bases acadêmicas: o checador confere o link (
url_verificada,url_divergente,url_inacessivel,nao_verificavel). Sem resultado nas bases, o link também conta como evidência. - Título atribuído
[entre colchetes]sainao_verificavel, e obra anterior a 1800 sem resultado saifora_de_cobertura.
Documentação
- README: aviso para reiniciar o Claude Code depois de instalar, exemplos de humanidades e as variáveis de ambiente. O fixture
tests/fixtures/biblioteca-humanidades.jsoncobre esses casos.
1.1.1 (2026-11-01)
- Obra traduzida. O formatador ganhou os campos
tradutor(texto ou lista),titulo_originaleano_original. Pela NBR 6023,Tradução: Nome.vem depois do título e antes da edição; o título original e a publicação original entram no fim. Os três campos passam por BibTeX (biblatex:translator,origtitle,origdate) e por CSL-JSON nos dois sentidos. biblioteca.py citar --ano-originalgera(Kant, 2015 [1781], p. 75). É costume, não está na NBR 10520:2023, e o script avisa isso.p.só entra quando o localizador é número ou intervalo. Localizador próprio fica como está:B 75,local. 264,cap. V.- Fontes em LF, com
.gitattributes, para os pacotes dedist/saírem iguais em qualquer sistema.
1.1.0 (2026-11-01)
- Funciona fora do Claude Code.
tools/portatil.pygera os pacotes dedist/:- skills autocontidas, com scripts, dados e referências dentro de cada pasta: uma por zip, para o Claude.ai, e as três juntas, para
.agents/skills(Codex, Gemini CLI, Cursor, Copilot); - pacote de chat para ChatGPT, Gemini, Copilot e Perplexity: instruções com no máximo 8.000 caracteres, dois arquivos de conhecimento e os scripts para quem tem análise de código;
citacoes-abnt-agents.md, para salvar comoAGENTS.mdouGEMINI.md.
- skills autocontidas, com scripts, dados e referências dentro de cada pasta: uma por zip, para o Claude.ai, e as três juntas, para
gemini-extension.json: extensão do Gemini CLI, que carrega as skills da pastaskills/.- Sem acesso à internet, as instruções mandam declarar a referência como não verificada.
1.0.0 (2026-11-01)
- Três skills:
biblioteca-citacoes,checador-citacoeseabnt-formatacao. - Scripts em Python, só com a biblioteca padrão:
abnt_libformata pela NBR 6023 (2025 e 2018) e cita pela NBR 10520 (2023 e 2002);bibliotecagerencia o biblioteca.json e exporta em ABNT, BibTeX, RIS e CSL-JSON;metadadosbusca em Crossref, OpenAlex, Semantic Scholar, Open Library, Google Books e meta tags citation_*;checar_referenciasconfere a existência das obras em duas ou mais bases e detecta quimera e DOI divergente;conferir_citacoescompara citação e referência;gerar_modelo_docxgera o modelo Word da instituição.
- Perfis de 50 instituições: 40 universidades e 10 técnicas. Cada um traz a URL do manual consultado e a data da conferência.
- Página no GitHub Pages: uma página por instituição, quadro das normas vigentes, JSON-LD, sitemap e llms.txt.