Communitygithub.com

lishn6/daily-econ-literature-radar

Una habilidad de Codex para recibir feeds diarios de literatura económica.

¿Qué es daily-econ-literature-radar?

Daily Literature Radar es una habilidad para Codex que permite a economistas e investigadores rastrear artículos de revistas objetivo, documentos de trabajo, fuentes RSS y autores vigilados, generando un resumen diario en Markdown o un correo HTML. Es útil porque automatiza la revisión de literatura, ahorrando tiempo al filtrar y clasificar papers según un perfil de investigación definido por el usuario (campos, palabras clave, códigos JEL, métodos y geografías). Soporta plataformas como Codex y Claude Code, y su configuración puede ser asistida por agentes de IA. Funciona mediante la consulta de metadatos abiertos de Crossref, NBER y fuentes RSS/Atom, desduplicando por DOI y clasificando la relevancia para producir un digesto de hasta 10 papers por ejecución. La versión avanzada incluye envío automatizado de correo HTML mediante Gmail SMTP y un programador diario.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

Vista previa del correo HTML renderizado

Documentación

Habilidad de Radar Diario de Literatura

El Radar Diario de Literatura es una habilidad de Codex para rastrear artículos de economía de revistas objetivo, fuentes de documentos de trabajo, fuentes RSS y autores vigilados. Obtiene metadatos abiertos, clasifica los artículos según un perfil de investigación definido por el usuario y genera un resumen diario.

La versión básica genera Markdown. La versión avanzada se ejecuta con una programación diaria y envía el resumen como un correo electrónico HTML formateado con un respaldo en Markdown.

Las bibliotecas de origen actuales incluyen Crossref para revistas objetivo, metadatos oficiales de documentos de trabajo del NBER y fuentes RSS/Atom genéricas como CEPR, RePEc/NEP, feeds de la Reserva Federal y alertas de revistas. Se pueden agregar repositorios adicionales de documentos de trabajo como fuentes RSS o adaptadores de origen.

Recomendado: Configurar con Codex

Esta habilidad está diseñada para configurarse con ayuda de Codex o Claude Code. Un agente de codificación puede ayudarte a convertir tus intereses de investigación en un daily-econ-literature-radar.config.json funcional mediante:

  • traduciendo tus temas de investigación en fields, keywords, jel_codes, methods y geographies
  • recomendando las mejores revistas de campo después de definir tu perfil de investigación, luego agregando solo las revistas que elijas
  • encontrando y verificando los ISSN de las revistas antes de agregarlas a target_journals
  • agregando autores objetivo y alias de nombres
  • agregando fuentes RSS o filtros de programa/grupo de trabajo del NBER
  • configurando Gmail SMTP y un programador para la versión avanzada de correo diario a hora fija

La configuración básica solo necesita salida Markdown. La configuración avanzada envía un resumen de correo HTML diario automáticamente después de configurar Gmail SMTP y un programador.

Qué Hace

  • Monitorea revistas objetivo mediante consultas de ISSN a Crossref.
  • Monitorea documentos de trabajo del NBER a través de archivos TSV oficiales de metadatos del NBER.
  • Monitorea fuentes RSS/Atom como CEPR, RePEc/NEP, feeds de la Reserva Federal o alertas de revistas.
  • Rastrea autores objetivo en todos los metadatos obtenidos.
  • Clasifica los artículos candidatos por fuente, estado de revista objetivo, coincidencia de autor objetivo, coincidencia temática, coincidencia de JEL/método/geografía y coincidencia de palabras clave en resumen/título.
  • Desduplica artículos por DOI o por respaldo de título/autor.
  • Produce como máximo max_papers artículos por ejecución, por defecto 10.
  • Genera un resumen en Markdown.
  • Opcionalmente envía un resumen por correo HTML a través de Gmail SMTP u otro proveedor SMTP con una programación diaria fija.
  • No descarga PDFs protegidos por muro de pago ni texto completo restringido.

Estructura del Proyecto

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

Configura las entradas en daily-econ-literature-radar.config.json.

Perfil de Investigación

Se utiliza para la clasificación de relevancia:

  • fields: campos de investigación amplios
  • jel_codes: códigos JEL o familias JEL parciales
  • keywords: palabras clave temáticas
  • methods: métodos o diseños empíricos
  • geographies: países, regiones, conjuntos de datos o entornos

Revistas Objetivo

Monitoreo exacto de revistas a través de Crossref. Las 5 mejores revistas de economía están habilitadas por defecto. Después de establecer el perfil de investigación, la habilidad puede recomendar las mejores revistas de campo; el usuario debe elegir qué recomendaciones agregar. Cada revista debe incluir:

  • name
  • tier
  • field
  • issn

Ejemplo:

{
  "name": "Journal Name",
  "tier": "field_top",
  "field": "labor",
  "issn": ["0000-0000"]
}

Verifica los ISSN antes de agregarlos.

Autores Objetivo

Nombres de autores y alias para priorizar:

{
  "name": "Author Name",
  "aliases": ["A. Name", "Author M. Name"],
  "notes": "Optional note"
}

Fuentes

  • nber: adaptador oficial de metadatos del NBER
  • rss_feeds: CEPR, RePEc/NEP, Fed, alertas de revistas u otras fuentes RSS/Atom
  • target_journals: consultas de ISSN a Crossref

Límites

  • max_papers: tamaño final del resumen
  • per_source_rows: número de filas a solicitar por consulta de fuente
  • source_caps: límites suaves que evitan que un tipo de fuente domine el resumen

Correo Electrónico

El correo electrónico es opcional. Establece email.enabled en true solo después de configurar las credenciales SMTP.

Salidas

Se incluyen ejemplos de salida en example-output/sample-digest.md, example-output/sample-email.html y example-output/sample-email-preview.png. Utilizan metadatos de artículos sintéticos pero conservan la misma estructura y estilo de correo que las ejecuciones reales.

Vista previa del correo HTML renderizado

Obtener JSON

Generado por fetch:

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

Cada registro de artículo puede incluir:

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

Resumen en Markdown

Generado por render_digest.py:

daily-econ-literature-radar-output/YYYY-MM-DD.md

Cada artículo incluye título, autores, fuente, fecha de publicación/actualización, DOI/URL, términos coincidentes, prioridad, resumen y notas.

Resumen por Correo

Generado por send_digest.py o run_daily_radar.py cuando el correo está habilitado. El correo incluye:

  • cuerpo HTML para una visualización legible en Gmail/Outlook
  • respaldo en Markdown de texto plano

Cómo Usar

Consejo: pide a Codex o Claude Code que te ayuden a configurar el perfil de investigación, las mejores revistas de campo, los autores objetivo y el envío programado de correos. Gmail SMTP con una Contraseña de Aplicación de Google ha sido probado y funciona.

Versión Básica: Solo Markdown

Desde la raíz del proyecto:

cp config.example.json daily-econ-literature-radar.config.json

Edita daily-econ-literature-radar.config.json con tu perfil de investigación, autores y fuentes. Mantén las 5 mejores revistas por defecto si lo deseas, luego agrega las mejores revistas de campo después de elegir entre las recomendaciones.

Obtener artículos:

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

Después de revisar el resumen, marca el procesamiento exitoso:

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 actualiza state.json para que las ejecuciones futuras no repitan los mismos artículos.

Versión Avanzada: Correo Diario a Hora Fija

La versión avanzada es un flujo de trabajo programado. Los scripts no se ejecutan como un demonio en segundo plano por sí mismos; un programador como la automatización de Codex, cron, macOS LaunchAgent o el Programador de Tareas de Windows debe llamar a run_daily_radar.py a la hora deseada cada día.

Configura la hora de entrega deseada en tu programador. También puedes registrarla en la configuración:

"push_time": "09:00",
"timezone": "America/Toronto"

Gmail SMTP

La implementación actual ha sido probada con Gmail SMTP y una Contraseña de Aplicación de Google.

Establece en 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
}

Gmail generalmente requiere una Contraseña de Aplicación de Google en lugar de tu contraseña normal de Google. Crea una desde la configuración de seguridad de tu cuenta de Google, luego guárdala de una de estas formas.

Variable de entorno:

export DAILY_RADAR_GMAIL_APP_PASSWORD="your-app-password"

Archivo local ignorado:

mkdir -p .secrets
printf '%s' 'your-app-password' > .secrets/gmail_app_password
chmod 600 .secrets/gmail_app_password

El archivo .gitignore excluye .secrets/, .env, configuraciones locales y salidas.

Enviar un Resumen

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

Ejecutar el Flujo Completo de Correo

python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json

Esto ejecuta:

fetch -> render Markdown -> send HTML email -> mark-success

Marca éxito solo después de que el envío del correo tenga éxito.

Programar la Entrega Diaria

Programa este comando exacto para que se ejecute una vez al día a la hora elegida:

python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json

Ese comando realiza el flujo de trabajo diario completo de correo:

fetch -> render Markdown -> send HTML email -> mark-success

Opciones de Programación

Automatización de Codex

Crea una automatización cron diaria que se ejecute desde este directorio del proyecto:

python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json

Usa la zona horaria y hora local preferida del usuario, por ejemplo, 09:00 diario.

macOS Cron o LaunchAgent

Este proyecto fue desarrollado y probado en un entorno MacBook/macOS con Python 3. Las opciones de programación más simples de macOS son:

  • Automatización de Codex
  • cron
  • launchd / LaunchAgent

Para cron, asegúrate de que el trabajo comience en el directorio del proyecto y use el mismo ejecutable de Python que funcionó en las pruebas.

Compatibilidad con Windows

La versión actual ha sido probada en MacBook/macOS. Los scripts de Python son solo de biblioteca estándar y deberían ser portátiles, pero los usuarios de Windows deben ajustar:

  • Usar python o py -3 en lugar de python3.
  • Usar sintaxis de ruta de PowerShell y poner entre comillas las rutas que contengan espacios.
  • Usar el Programador de Tareas de Windows en lugar de cron/launchd.
  • Reemplazar chmod 600 con permisos de archivos de Windows o almacenar la contraseña de la aplicación en una variable de entorno.
  • Usar .secrets\gmail_app_password en rutas de Windows si se usa un archivo secreto.
  • Confirmar que las conexiones TLS SMTP estén permitidas por el firewall local o las herramientas antivirus.

Ejemplo de comando de PowerShell:

cd "C:\ruta\a\daily-econ-literature-radar"
py -3 daily-econ-literature-radar\scripts\run_daily_radar.py --config daily-econ-literature-radar.config.json

Privacidad y Seguridad

No confirmes:

  • daily-econ-literature-radar.config.json
  • .secrets/
  • .env
  • daily-econ-literature-radar-output/

La habilidad solo utiliza metadatos y resúmenes proporcionados por las fuentes. No descarga PDFs protegidos por muro de pago ni texto completo restringido. Si una fuente no tiene resumen, el resumen marca el artículo como sin resumen/solo título en lugar de inferir hallazgos.

Notas para Personalización

  • Mantén max_papers lo suficientemente pequeño como para que el resumen siga siendo legible.
  • Las 5 mejores revistas están habilitadas por defecto; agrega las mejores revistas de campo mediante ISSN verificado después de elegir entre las recomendaciones.
  • Agrega autores objetivo con alias para iniciales o variantes de nombre.
  • Agrega fuentes RSS gradualmente y revisa la calidad antes de programar la entrega diaria.
  • Usa límites por fuente para evitar que una fuente domine el resumen.

Skills relacionados