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,methodsygeographies - 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_papersartículos por ejecución, por defecto10. - 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 ampliosjel_codes: códigos JEL o familias JEL parcialeskeywords: palabras clave temáticasmethods: métodos o diseños empíricosgeographies: 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:
nametierfieldissn
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 NBERrss_feeds: CEPR, RePEc/NEP, Fed, alertas de revistas u otras fuentes RSS/Atomtarget_journals: consultas de ISSN a Crossref
Límites
max_papers: tamaño final del resumenper_source_rows: número de filas a solicitar por consulta de fuentesource_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.

Obtener JSON
Generado por fetch:
daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json
Cada registro de artículo puede incluir:
titleauthorssourcesource_kinddatedate_typedoiurlabstractkeywordsmatched_termspriorityscorenotes
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
cronlaunchd/ 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
pythonopy -3en lugar depython3. - 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 600con permisos de archivos de Windows o almacenar la contraseña de la aplicación en una variable de entorno. - Usar
.secrets\gmail_app_passworden 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/.envdaily-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_paperslo 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.
