Habilidade Radar de Literatura Diária
O Radar de Literatura Diária é uma habilidade do Codex para rastrear artigos de economia de periódicos-alvo, fontes de working papers, feeds RSS e autores monitorados. Ele obtém metadados abertos, classifica os artigos em relação a um perfil de pesquisa definido pelo usuário e gera um resumo diário.
A versão básica gera Markdown. A versão avançada é executada em um agendamento diário e envia o resumo como um e-mail HTML formatado com fallback em Markdown.
As bibliotecas de origem atuais incluem Crossref para periódicos-alvo, metadados oficiais de working papers do NBER e feeds RSS/Atom genéricos como CEPR, RePEc/NEP, feeds do Federal Reserve e alertas de periódicos. Repositórios adicionais de working papers podem ser adicionados como feeds RSS ou adaptadores de origem.
Recomendado: Configurar com o Codex
Esta habilidade foi projetada para ser configurada com a ajuda do Codex ou Claude Code. Um agente de codificação pode ajudar a transformar seus interesses de pesquisa em um daily-econ-literature-radar.config.json funcional:
- traduzindo seus tópicos de pesquisa em
fields,keywords,jel_codes,methodsegeographies - recomendando periódicos de topo de campo após a definição do seu perfil de pesquisa e, em seguida, adicionando apenas os periódicos que você escolher
- encontrando e verificando ISSNs de periódicos antes de adicioná-los a
target_journals - adicionando autores-alvo e aliases de nomes
- adicionando feeds RSS ou filtros de programa/grupo de trabalho do NBER
- configurando SMTP do Gmail e um agendador para a versão avançada de e-mail diário em horário fixo
A configuração básica precisa apenas da saída Markdown. A configuração avançada envia um resumo de e-mail HTML diário automaticamente após o SMTP do Gmail e um agendador serem configurados.
O que Faz
- Monitora periódicos-alvo por meio de consultas ISSN no Crossref.
- Monitora working papers do NBER por meio de arquivos TSV oficiais de metadados do NBER.
- Monitora fontes RSS/Atom como CEPR, RePEc/NEP, feeds do Federal Reserve ou alertas de periódicos.
- Rastreia autores-alvo em todos os metadados obtidos.
- Classifica artigos candidatos por fonte, status de periódico-alvo, correspondência de autor-alvo, correspondência de tópico, correspondência de JEL/método/geografia e correspondência de palavras-chave de resumo/título.
- Desduplica artigos por DOI ou fallback de título/autor.
- Gera no máximo
max_papersartigos por execução, padrão10. - Produz um resumo em Markdown.
- Opcionalmente, envia um resumo de e-mail HTML por meio do SMTP do Gmail ou outro provedor SMTP em um agendamento diário fixo.
- Não baixa PDFs ou textos completos restritos.
Estrutura do Projeto
daily-econ-literature-radar/
├── README.md
├── config.example.json
├── example-output/
│ ├── sample-digest.md
│ ├── sample-email.html
│ └── sample-email-preview.png
├── .gitignore
└── daily-econ-literature-radar/
├── SKILL.md
├── agents/openai.yaml
├── references/
│ ├── default-config.md
│ ├── journal-watchlist.md
│ └── source-notes.md
└── scripts/
├── economics_literature_radar.py
├── render_digest.py
├── send_digest.py
└── run_daily_radar.py
Entradas
Configure as entradas em daily-econ-literature-radar.config.json.
Perfil de Pesquisa
Usado para classificação de relevância:
fields: campos de pesquisa amplosjel_codes: códigos JEL ou famílias JEL parciaiskeywords: palavras-chave do tópicomethods: métodos ou desenhos empíricosgeographies: países, regiões, conjuntos de dados ou configurações
Periódicos-Alvo
Monitoramento exato de periódicos por meio do Crossref. Os 5 principais periódicos de economia estão ativados por padrão. Após a definição do perfil de pesquisa, a habilidade pode recomendar periódicos de topo de campo; o usuário deve escolher quais recomendações adicionar. Cada periódico deve incluir:
nametierfieldissn
Exemplo:
{
"name": "Journal Name",
"tier": "field_top",
"field": "labor",
"issn": ["0000-0000"]
}
Verifique os ISSNs antes de adicioná-los.
Autores-Alvo
Nomes de autores e aliases para priorizar:
{
"name": "Author Name",
"aliases": ["A. Name", "Author M. Name"],
"notes": "Optional note"
}
Fontes
nber: adaptador oficial de metadados do NBERrss_feeds: CEPR, RePEc/NEP, Fed, alertas de periódicos ou outros feeds RSS/Atomtarget_journals: consultas ISSN no Crossref
Limites
max_papers: tamanho final do resumoper_source_rows: número de linhas a serem solicitadas por consulta de fontesource_caps: limites suaves que impedem que um tipo de fonte domine o resumo
O e-mail é opcional. Defina email.enabled como true somente após configurar as credenciais SMTP.
Saídas
Exemplos de saída estão incluídos em example-output/sample-digest.md, example-output/sample-email.html e example-output/sample-email-preview.png. Eles usam metadados de artigos sintéticos, preservando a mesma estrutura e estilo de e-mail das execuções reais.

Buscar JSON
Gerado por fetch:
daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json
Cada registro de artigo pode incluir:
titleauthorssourcesource_kinddatedate_typedoiurlabstractkeywordsmatched_termspriorityscorenotes
Resumo Markdown
Gerado por render_digest.py:
daily-econ-literature-radar-output/YYYY-MM-DD.md
Cada artigo inclui título, autores, fonte, data de publicação/atualização, DOI/URL, termos correspondentes, prioridade, resumo e notas.
Resumo de E-mail
Gerado por send_digest.py ou run_daily_radar.py quando o e-mail está ativado. O e-mail inclui:
- corpo HTML para exibição legível no Gmail/Outlook
- fallback em Markdown de texto simples
Como Usar
Dica: peça ao Codex ou Claude Code para ajudar a configurar o perfil de pesquisa, as escolhas de periódicos de topo de campo, os autores-alvo e o envio agendado de e-mail. O SMTP do Gmail com uma senha de aplicativo do Google foi testado e funciona.
Versão Básica: Apenas Markdown
A partir da raiz do projeto:
cp config.example.json daily-econ-literature-radar.config.json
Edite daily-econ-literature-radar.config.json com seu perfil de pesquisa, autores e fontes. Mantenha os 5 principais periódicos padrão, se desejado, e adicione periódicos de topo de campo após escolher entre as recomendações.
Buscar artigos:
python3 daily-econ-literature-radar/scripts/economics_literature_radar.py fetch --config daily-econ-literature-radar.config.json
Renderizar Markdown:
python3 daily-econ-literature-radar/scripts/render_digest.py \
daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json \
--output daily-econ-literature-radar-output/YYYY-MM-DD.md
Após revisar o resumo, marque o processamento bem-sucedido:
python3 daily-econ-literature-radar/scripts/economics_literature_radar.py mark-success \
--config daily-econ-literature-radar.config.json \
--data daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json
mark-success atualiza state.json para que execuções futuras não repitam os mesmos artigos.
Versão Avançada: E-mail Diário em Horário Fixo
A versão avançada é um fluxo de trabalho agendado. Os scripts não são executados como um daemon em segundo plano por si só; um agendador como automação do Codex, cron, macOS LaunchAgent ou Agendador de Tarefas do Windows deve chamar run_daily_radar.py no horário desejado a cada dia.
Configure o horário de entrega desejado em seu agendador. Você também pode registrá-lo no config:
"push_time": "09:00",
"timezone": "America/Toronto"
SMTP do Gmail
A implementação atual foi testada com SMTP do Gmail e uma senha de aplicativo do Google.
Defina em daily-econ-literature-radar.config.json:
"email": {
"enabled": true,
"provider": "gmail_smtp",
"from": "Daily Literature Radar <[email protected]>",
"to": "[email protected]",
"smtp_host": "smtp.gmail.com",
"smtp_port": 587,
"smtp_username": "[email protected]",
"smtp_password_env": "DAILY_RADAR_GMAIL_APP_PASSWORD",
"smtp_password_file": ".secrets/gmail_app_password",
"use_starttls": true
}
O Gmail geralmente exige uma senha de aplicativo do Google, em vez de sua senha normal do Google. Crie uma a partir das configurações de segurança da sua Conta do Google e armazene-a de uma das seguintes maneiras.
Variável de ambiente:
export DAILY_RADAR_GMAIL_APP_PASSWORD="your-app-password"
Arquivo local ignorado:
mkdir -p .secrets
printf '%s' 'your-app-password' > .secrets/gmail_app_password
chmod 600 .secrets/gmail_app_password
O arquivo .gitignore exclui .secrets/, .env, configs locais e saídas.
Enviar Um Resumo
python3 daily-econ-literature-radar/scripts/send_digest.py \
daily-econ-literature-radar-output/YYYY-MM-DD.md \
--config daily-econ-literature-radar.config.json
Executar o Pipeline Completo de E-mail
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
Isso executa:
fetch -> render Markdown -> send HTML email -> mark-success
Ele marca sucesso somente após o envio do e-mail ser bem-sucedido.
Agendar Entrega Diária
Agende este comando exato para ser executado uma vez por dia no horário escolhido:
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
Esse comando realiza o fluxo de trabalho diário completo de e-mail:
fetch -> render Markdown -> send HTML email -> mark-success
Opções de Agendamento
Automação do Codex
Crie uma automação cron diária que execute a partir deste diretório do projeto:
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
Use o fuso horário local e horário preferidos do usuário, por exemplo, 09:00 diariamente.
Cron do macOS ou LaunchAgent
Este projeto foi desenvolvido e testado em um ambiente MacBook/macOS com Python 3. As opções de agendamento mais simples do macOS são:
- Automação do Codex
cronlaunchd/ LaunchAgent
Para cron, certifique-se de que o job inicie no diretório do projeto e use o mesmo executável Python que funcionou nos testes.
Compatibilidade com Windows
A versão atual foi testada no MacBook/macOS. Os scripts Python usam apenas a biblioteca padrão e devem ser portáveis, mas os usuários do Windows devem ajustar:
- Use
pythonoupy -3em vez depython3. - Use a sintaxe de caminho do PowerShell e coloque entre aspas caminhos com espaços.
- Use o Agendador de Tarefas do Windows em vez de cron/launchd.
- Substitua
chmod 600por permissões de arquivo do Windows ou armazene a senha do aplicativo em uma variável de ambiente. - Use
.secrets\gmail_app_passwordem caminhos do Windows se usar um arquivo de segredo. - Confirme se as conexões TLS SMTP são permitidas pelo firewall local ou ferramentas antivírus.
Exemplo de comando PowerShell:
cd "C:\path\to\daily-econ-literature-radar"
py -3 daily-econ-literature-radar\scripts\run_daily_radar.py --config daily-econ-literature-radar.config.json
Privacidade e Segurança
Não commite:
daily-econ-literature-radar.config.json.secrets/.envdaily-econ-literature-radar-output/
A habilidade usa apenas metadados e resumos fornecidos pelas fontes. Ela não baixa PDFs ou textos completos restritos. Se uma fonte não tiver resumo, o resumo marca o artigo como sem resumo/apenas título, em vez de inferir conclusões.
Notas para Personalização
- Mantenha
max_paperspequeno o suficiente para que o resumo permaneça legível. - Os 5 principais periódicos estão ativados por padrão; adicione periódicos de topo de campo por ISSN verificado após escolher entre as recomendações.
- Adicione autores-alvo com aliases para iniciais ou variantes de nome.
- Adicione feeds RSS gradualmente e revise a qualidade antes de agendar a entrega diária.
- Use source caps para evitar que uma fonte domine o resumo.
