Yoyiyoniu/paper-search

O que paper-search faz?

Pesquise em APIs oficiais e leia o PDF legal. Uma afirmação científica só é permitida quando o resumo ou as páginas do PDF lidas nesta sessão a contêm. Não forneça a partir da memória, de um blog ou de qualquer outro texto secundário. Siga cada afirmação de volta ao artigo que a possui.

O ano, DOI e contagem de citações vêm da saída do script. Se citations=-, a fonte não forneceu uma contagem. Diga isso. Não estime.

Delegue a leitura

Para uma revisão de literatura, estado da arte ou qualquer relatório que precise de mais de um artigo, acione um agente em segundo plano para fazer a leitura enquanto esta conversa continua. Um único artigo ou um DOI conhecido fica aqui.

A função do agente em segundo plano:

1. Investigue a pergunta nos próprios artigos, não em um texto secundário sobre eles.
2. Escreva as descobertas em um único arquivo Markdown, citando a fonte de cada afirmação.
3. Salve-o onde o repositório já guarda essas anotações. Siga a convenção existente. Se não houver, escreva docs/notes/<topico>.md e diga onde.

Forneça a ele o caminho absoluto para scripts/papers.py, a pergunta, o domínio e o caminho de saída. Ele usa o script abaixo e não reimplementa as APIs.

Script

scripts/papers.py fica ao lado deste arquivo. Apenas stdlib. Execute pelo caminho absoluto.

python3 scripts/papers.py search "CONSULTA" [--domain auto|ml|phys|math|bio|psy|chem] [--limit N] [--year 2020|2020-2024|2020-] [--sort relevance|citations|date] [--abstract]
python3 scripts/papers.py read PDF_URL --pages 1-3 [--out notas.txt]
python3 scripts/papers.py oa 10.xxxx/yyyy

oa imprime is_oa= e pdf= do Unpaywall. Uma consulta, --limit no máximo 10. Se a lista de resultados estiver errada, mude a consulta. Não pagine.

Opcional: SEMANTIC_SCHOLAR_API_KEY (menos 429s) e PAPER_SEARCH_EMAIL (OpenAlex e Unpaywall).

Roteamento

Traduza a consulta para o inglês antes de pesquisar.

Tópico	--domain	Primeira fonte	Se falhar
IA / ML / PLN / visão / robótica / CC	ml	arXiv	Semantic Scholar, depois OpenAlex
Física / astronomia	phys	arXiv	Semantic Scholar, depois OpenAlex
Matemática	math	arXiv	Semantic Scholar, depois OpenAlex
Bio / medicina / genética / farmácia	bio	Europe PMC	Semantic Scholar, depois OpenAlex
Psicologia / ciência cognitiva	psy	Europe PMC	Semantic Scholar, depois OpenAlex
Química / materiais	chem	Semantic Scholar	OpenAlex
Misto ou incerto	auto	Semantic Scholar	OpenAlex

• Estado da arte, ou "mais citado": --sort citations. O arXiv não tem contagens de citações, então essa ordenação começa no Semantic Scholar.
• O que há de novo: --sort date ou --year 2023-.
• Um artigo nomeado pelo título: pesquise esse título em inglês. Com --sort relevance, um título idêntico é classificado em primeiro.

Triagem

Execute a pesquisa com --abstract. Mantenha apenas os artigos que usará.

• marcante: altamente citado e com mais de dois anos.
• recente: dos últimos dois anos e sobre a pergunta, mesmo com poucas citações.
• marginal: fora do assunto. Deixe-o de fora da nota.

Leitura

1. O resumo é suficiente, a menos que o usuário tenha solicitado um método, um número ou uma citação direta.
2. Abra o PDF apenas então: read URL --pages 1-3. Para o final, leia as últimas 2 a 4 páginas. Se você não souber o comprimento, fique em 1-3. Não adivinhe números de página.
3. ERROR: not a PDF ou pdf=(no open PDF…): execute oa <DOI> e leia o pdf= que ele imprime. Se pdf=-, não há PDF direto legal. Mantenha o resumo. Não trate a url= da página de destino como o artigo.
4. Estes hosts podem ser lidos diretamente: arxiv.org, europepmc.org, ncbi.nlm.nih.gov e um repositório universitário. Qualquer outro host passa por oa primeiro.
5. Não use Sci-Hub, Library Genesis ou outros espelhos de bibliotecas-sombra.

Leia no máximo três PDFs por execução. Se a pergunta precisar de mais, conclua a partir dos resumos e liste aqueles que não abriu.

Nota

# <pergunta>

## Descobertas
- Afirmação, apenas se o resumo ou as páginas nomeadas a disserem. (Vaswani et al. 2017, 10.48550/arXiv.1706.03762, resumo)

## Artigos
- **Attention Is All You Need** (2017) — 120404 citações, OpenAlex
  - doi: 10.48550/arXiv.1706.03762
  - pdf: https://arxiv.org/pdf/1706.03762
  - lido: apenas resumo
  - motivo: uma linha extraída desse texto

## Não lidos
- Artigos descartados por estarem fora do assunto, ou PDFs que não foram abertos.

No chat, aponte para o arquivo. Não cole-o de volta. A mesma regra de citação para uma resposta de um único artigo que nunca se torna um arquivo: autor, ano, DOI e se veio do resumo ou de quais páginas.