Communitygithub.com

lischoenemann/daily-econ-literature-radar

Habilidade do Codex para feeds diários de literatura econômica

O que é daily-econ-literature-radar?

O Daily Literature Radar é uma habilidade do Codex (e compatível com Claude Code) que rastreia artigos de periódicos-alvo de economia, fontes de working papers, feeds RSS e autores monitorados. Ele obtém metadados abertos, classifica os artigos com base em um perfil de pesquisa definido pelo usuário (campos, palavras-chave, códigos JEL, métodos, geografias) e gera um resumo diário em Markdown ou, na versão avançada, um e-mail HTML formatado com fallback em Markdown, enviado automaticamente em horário fixo. As bibliotecas de origem incluem Crossref (para periódicos-alvo), metadados oficiais do NBER e feeds RSS/Atom genéricos (CEPR, RePEc/NEP, Federal Reserve, alertas de periódicos). A habilidade é configurada com auxílio do Codex/Claude Code, que ajuda a traduzir interesses de pesquisa em um arquivo de configuração JSON, recomendar periódicos de topo de campo, verificar ISSNs, adicionar autores-alvo e configurar envio de e-mail via SMTP do Gmail com senha de aplicativo. A ferramenta desduplica artigos por DOI ou título/autor, respeita limites de artigos por execução (padrão 10) e não baixa PDFs ou textos completos restritos.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/lishn6/daily-econ-literature-radar/tree/main

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

Pré-visualização do e-mail HTML renderizado

Documentação

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, methods e geographies
  • 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_papers artigos por execução, padrão 10.
  • 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 amplos
  • jel_codes: códigos JEL ou famílias JEL parciais
  • keywords: palavras-chave do tópico
  • methods: métodos ou desenhos empíricos
  • geographies: 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:

  • name
  • tier
  • field
  • issn

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 NBER
  • rss_feeds: CEPR, RePEc/NEP, Fed, alertas de periódicos ou outros feeds RSS/Atom
  • target_journals: consultas ISSN no Crossref

Limites

  • max_papers: tamanho final do resumo
  • per_source_rows: número de linhas a serem solicitadas por consulta de fonte
  • source_caps: limites suaves que impedem que um tipo de fonte domine o resumo

E-mail

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.

Pré-visualização do e-mail HTML renderizado

Buscar JSON

Gerado por fetch:

daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json

Cada registro de artigo pode incluir:

  • title
  • authors
  • source
  • source_kind
  • date
  • date_type
  • doi
  • url
  • abstract
  • keywords
  • matched_terms
  • priority
  • score
  • notes

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
  • cron
  • launchd / 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 python ou py -3 em vez de python3.
  • 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 600 por permissões de arquivo do Windows ou armazene a senha do aplicativo em uma variável de ambiente.
  • Use .secrets\gmail_app_password em 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/
  • .env
  • daily-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_papers pequeno 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.

Habilidades Relacionadas