Rastreador de Artigos arXiv

arxiv-paper-tracker

Esta é uma habilidade voltada para agentes de IA para rastreamento configurável de artigos do arXiv. Quando este repositório for clonado em um sistema de agente que suporte SKILL.md, o agente deve usar esta habilidade sempre que o usuário desejar pesquisar, rastrear, deduplicar, resumir ou monitorar periodicamente artigos do arXiv sob restrições definidas pelo usuário.

Os casos de uso adequados incluem:

• Pesquisa única no arXiv usando uma configuração temporária gerada pelo agente.
• Rastreamento periódico de artigos com um arquivo de estado persistente.
• Monitoramento de qualquer combinação configurável de restrições de consulta, incluindo autores, instituições, palavras-chave, categorias do arXiv, janelas de data e limites de resultados.
• Geração de um resumo em Markdown que pode ser enviado por um sistema de notificação externo, pipeline de e-mail, agendador ou chatbot.

Os exemplos neste arquivo são apenas exemplos. Tópicos, autores, instituições, categorias, janelas de tempo e limites de resultados são todos configuráveis em config.yaml.

O que esta habilidade faz

Esta habilidade pode:

1. Consultar o arXiv.
2. Filtrar artigos por autores, instituições, palavras-chave e categorias.
3. Deduplicar artigos por ID do arXiv.
4. Manter um arquivo de estado local para evitar notificações repetidas.
5. Gerar um resumo em Markdown.
6. Opcionalmente, enviar notificações por e-mail quando ativado em um arquivo de configuração local.

Esta habilidade não:

• Traduz artigos completos automaticamente.
• Baixa e lê PDFs profundamente.
• Substitui o julgamento do usuário sobre a qualidade ou relevância do artigo.
• Armazena ou gerencia senhas de e-mail do usuário, senhas de aplicativos, chaves de API ou outros segredos.

Instalação

Se o pacote não estiver instalado no ambiente de execução atual do agente, execute a partir da raiz do repositório:

python -m pip install -e .

Isso instala o comando de console:

arxiv-paper-tracker

Se o comando de console não estiver disponível, o ponto de entrada do módulo equivalente é:

python -m arxiv_paper_tracker.cli

Uso recomendado

Crie um arquivo de configuração local:

arxiv-paper-tracker init-config config.yaml

Comando equivalente:

python -m arxiv_paper_tracker.cli init-config config.yaml

Após editar o config.yaml, execute uma verificação:

arxiv-paper-tracker scan \
  --config config.yaml \
  --state outputs/arxiv_tracker/state.json \
  --output outputs/arxiv_tracker/latest.md

Comando equivalente:

python -m arxiv_paper_tracker.cli scan \
  --config config.yaml \
  --state outputs/arxiv_tracker/state.json \
  --output outputs/arxiv_tracker/latest.md

Orientações de uso do agente

Se o usuário não forneceu um arquivo de configuração completo, o agente pode criar um arquivo de configuração local temporário com base na solicitação do usuário. Os campos abaixo são ilustrativos e devem ser alterados para corresponder ao tópico, autor, instituição, categoria, janela de tempo e limite de resultados solicitados:

queries:
  authors: []
  categories: []
  keywords: []
  institutions: []

limits:
  max_results_per_query: 20
  days_back: 7

state:
  path: outputs/arxiv_tracker/state.json

email:
  enabled: false

Em seguida, execute:

arxiv-paper-tracker scan \
  --config config.yaml \
  --state outputs/arxiv_tracker/state.json \
  --output outputs/arxiv_tracker/latest.md

Se o usuário quiser apenas uma pesquisa única em vez de rastreamento de longo prazo, o agente pode usar caminhos temporários:

arxiv-paper-tracker scan \
  --config /tmp/arxiv_tracker_config.yaml \
  --state /tmp/arxiv_tracker_state.json \
  --output /tmp/arxiv_tracker_digest.md

Manipulação da saída

O comando scan:

1. Imprime o resumo na saída padrão.
2. Grava o resumo em um arquivo Markdown quando --output é fornecido.

O agente deve ler a saída padrão ou o arquivo --output e adaptar o Markdown para a superfície de destino, como terminal, interface web, e-mail, Feishu, DingTalk, Slack, Discord ou outra interface de chat.

Agendamento

Este repositório não depende de um framework de agente específico. Para execuções periódicas, acione o comando scan a partir de qualquer agendador ou ambiente de automação, como:

• OpenClaw ou outro ambiente de execução de agente com reconhecimento de habilidades.
• Claude Code ou outro agente de codificação local.
• Outro agendador de agente.
• cron.
• GitHub Actions.
• Um agendador personalizado.

O agendador só precisa executar o comando scan e entregar o resumo Markdown gerado por meio de seu próprio canal de notificação.

Regras de segurança

• O repositório público fornece apenas config.example.yaml.
• Não faça commit de arquivos config.yaml pessoais.
• A notificação por e-mail está desabilitada por padrão.
• Se o e-mail estiver habilitado, o nome de usuário SMTP e a senha do aplicativo devem residir apenas em um arquivo de configuração local.
• Arquivos de configuração local devem ser ignorados pelo git.
• Não exponha senhas de aplicativos de e-mail, chaves de API, cookies ou tokens em prompts, logs, issues do GitHub ou saídas públicas.