research-stack

Ciclo completo de pesquisa com embasamento pro Claude, em português.

O Claude responde de memória por padrão, e memória tem data de validade. Esse plugin troca isso por um método: fonte primária primeiro, documento convertido antes de ser lido, divergência entre fontes reportada em vez de resolvida em silêncio, e todo número saindo com URL e data de acesso do lado.

Tempos reais, medidos em Ubuntu 22.04 com Python 3.10 e cache de pip limpo.

[!IMPORTANT] O setup instala pacote e roda comando na máquina onde o Bash do agente executa. Em ambiente com sandbox, como o Cowork, esse Bash é outro computador e a instalação não vale pra você — nesse caso rode o scripts/setup.sh no seu próprio terminal.

Instalação

No Claude Code

/plugin marketplace add nett0eth/research-stack
/plugin install research-stack

Depois, dentro do Claude:

roda o setup do research-stack

A skill de setup instala as ferramentas, cronometra cada etapa e te diz o que ficou faltando configurar na mão.

No Codex

O Codex lê o mesmo SKILL.md, mas não entende marketplace de plugin — lá a instalação é manual.

git clone https://github.com/nett0eth/research-stack.git
mkdir -p ~/.agents/skills
cp -r research-stack/skills/* ~/.agents/skills/

Use .agents/skills na raiz do projeto em vez de ~/.agents/skills se quiser as skills só num repositório.

Os dois MCPs precisam ser registrados à parte, porque o .mcp.json daqui é formato do Claude Code e o Codex usa TOML:

codex mcp add paper-search -- paper-search-mcp
codex mcp add zotero --env ZOTERO_LOCAL=true -- zotero-mcp

Depois rode o setup direto, já que a skill de setup depende do agente:

bash research-stack/scripts/setup.sh

Confira com /skills e /mcp. As skills disparam sozinhas pela description, ou você chama na mão com $ciclo-de-pesquisa.

[!NOTE] As cinco skills de terceiros do bootstrap são instaladas via npx skills add, que grava no diretório do Claude Code. No Codex você instala essas cinco na mão, a partir dos repositórios em CREDITS.md.

O que vem dentro

MCPs declarados: paper-search (arXiv, PubMed, Semantic Scholar, Crossref, OpenAlex, Unpaywall e mais) e zotero (biblioteca local).

As 4 regras

1. Fonte primária na frente. Blog agregador é pista, nunca destino
2. Divergência entre fontes é reportada com as duas versões e as duas datas
3. Padrão com menos de 5 casos é marcado como amostra fraca, não como conclusão
4. Todo número sai com URL e data de acesso

Tempo real de instalação

Medido em Ubuntu 22.04, Python 3.10, cache de pip limpo:

Ou seja: instalar é rápido. O tempo do setup completo vai quase todo pra configuração que depende de você, principalmente autenticar o Zotero e pegar chave de API. Se o seu número for muito diferente, abre uma issue com máquina e sistema operacional que eu atualizo a tabela.

Os conversores pesados (docling e mineru) ficam fora do padrão porque baixam modelo. Rode setup.sh --with-heavy se quiser eles.

Ferramentas de terceiros

Esse plugin não redistribui skill de ninguém. O setup instala da fonte original, com npx skills add, então o crédito fica com quem escreveu e você sempre pega a versão mais recente. Veja CREDITS.md.

O caminho padrão não pede chave de API nem cartão. As cinco skills instaladas usam as ferramentas nativas do agente e as bases públicas do paper-search, que segue estratégia de fonte aberta primeiro. As duas do Firecrawl ficam como opcional declarado, e o setup só oferece elas se você disser que já tem credencial.

Requisitos

• Claude Code, ou Codex com suporte a SKILL.md
• Python 3.10+ e pip
• Node, pra rodar npx skills add
• Terminal na sua própria máquina. Em ambiente com sandbox, como o Cowork, o Bash é outro computador e a instalação precisa ser feita por você
• Zotero 7+ com a API local ativada, se for usar a estação de referências

Licença

MIT. As ferramentas de terceiros seguem cada uma a sua, listadas em CREDITS.md.