Paperclip CLI

Paperclip by GXL expõe documentos científicos através de um sistema de arquivos virtual e busca no lado do servidor e leitores. Este é o GXL Paperclip em paperclip.gxl.ai, não o aplicativo não relacionado da empresa de agentes Paperclip. Use a fonte solicitada pelo usuário; outros provedores têm suas próprias habilidades.

Esta revisão verifica a documentação oficial, o esquema da API pública e o CLI/SDK 0.7.92 instalado. Ajuda local, construção de requisições SDK e metadados públicos foram verificados. Recuperação autenticada, leitores LLM, uploads e mutações de repositório não foram executados durante esta revisão; seus exemplos são ilustrativos. O comportamento do servidor pode mudar independentemente da versão do CLI.

Preparação e autenticação

command -v paperclip
paperclip --version
paperclip --help

Se instalado, use a conta existente ou uma chave configurada privadamente em https://paperclip.gxl.ai/keys. Não peça uma chave no chat nem imprima arquivos de credenciais. O Paperclip não carrega um projeto .env automaticamente. Se o usuário forneceu um .env confiável e compatível com shell, exporte-o na mesma invocação do shell do comando:

if [ -f .env ]; then
  set -a
  . ./.env
  set +a
fi
paperclip config 2>&1 | grep -E 'Auth:|Health:'

Sourcing .env executa código de shell: use apenas um arquivo confiável e mantenha-o fora do Git. Repita o export quando uma ferramenta iniciar um novo shell; um ambiente já exportado não precisa de prefixo. Um token bearer pode ter precedência sobre uma chave de API, e credenciais de ambiente ausentes podem recorrer a uma identidade OAuth armazenada. Verifique a conta pretendida em vez de assumir que qualquer login OAuth está errado. Auth relata a presença de credenciais; Health sonda a alcançabilidade pública. Nenhum dos dois prova que a credencial é válida. Verifique a autenticação na próxima requisição autorizada pela tarefa.

Use o navegador paperclip login quando o usuário estiver disponível para concluir o login. A instalação e paperclip install também contêm prompts; veja installation.md. Não execute atualizações, desinstalações, alterações de conta ou uploads meramente para testar a documentação.

Escolha a operação de recuperação

Sempre passe uma fonte ou diretório virtual para search. Fontes separadas por vírgula funcionam, mas consultas direcionadas separadas são mais fáceis de interpretar ao misturar artigos, ensaios e evidências regulatórias. Use paperclip skill proteins antes de consultas de proteínas e paperclip skill patents antes de patentes.

Encontrar, ler e citar

paperclip search -s pmc "CRISPR base editing delivery" -n 5
paperclip cat /papers/PMC10945750/meta.json
paperclip head -40 /papers/PMC10945750/content.lines
paperclip ls /papers/PMC10945750/sections/
paperclip grep -n "lipid nanoparticle" /papers/PMC10945750/content.lines
paperclip scan /papers/PMC10945750/content.lines "IC50" "off-target" "efficiency"

Capture o ID do resultado retornado; não reutilize os IDs ilustrativos nesta habilidade. IDs s_ identificam cohortes de busca/grep/filtro salvas, m_ mapeiam execuções e r_ reduzem artefatos. Recupere IDs recentes com paperclip results --list. A saída do terminal pode ser uma prévia truncada, então use resultados salvos ou o SDK result.papers para hits estruturados, não um regex sobre títulos de artigos renderizados. Veja search-and-retrieval.md e python-sdk.md.

Use caminhos virtuais absolutos. Prefira head, seções, grep e scan em vez de despejar um artigo inteiro. Uma leitura falha ou um resultado de grep limitado e vazio não estabelece ausência científica.

Extração de múltiplos artigos

paperclip search -s pmc "lipid nanoparticle mRNA delivery" -n 5
# Substitua o ID de busca real abaixo.
paperclip filter --from s_ID "in vivo delivery with quantified efficiency"
paperclip map --from s_ID "Report delivery vector, target cell type, efficiency, and supporting lines. State 'not reported' when absent."
paperclip results m_ID --save map.txt

…