Compétence Radar Quotidien de Littérature Économique
Le Radar Quotidien de Littérature Économique est une compétence Codex pour suivre les articles économiques provenant de revues cibles, de sources de documents de travail, de flux RSS et d'auteurs surveillés. Elle récupère les métadonnées ouvertes, classe les articles par rapport à un profil de recherche défini par l'utilisateur et génère un digest quotidien.
La version de base génère du Markdown. La version avancée s'exécute selon un planning quotidien et envoie le digest sous forme d'un email HTML formaté avec une alternative Markdown.
Les bibliothèques sources actuelles incluent Crossref pour les revues cibles, les métadonnées officielles du NBER, et des flux RSS/Atom génériques tels que CEPR, RePEc/NEP, les flux de la Réserve fédérale et les alertes de revues. D'autres dépôts de documents de travail peuvent être ajoutés sous forme de flux RSS ou d'adaptateurs sources.
Recommandé : Configuration avec Codex
Cette compétence est conçue pour être configurée avec l'aide de Codex ou Claude Code. Un agent de codage peut vous aider à transformer vos intérêts de recherche en un daily-econ-literature-radar.config.json fonctionnel en :
- traduisant vos sujets de recherche en
fields,keywords,jel_codes,methodsetgeographies - recommandant des revues de premier plan dans votre domaine une fois votre profil de recherche défini, puis en ajoutant uniquement les revues que vous choisissez
- trouvant et vérifiant les ISSN des revues avant de les ajouter à
target_journals - ajoutant des auteurs cibles et des alias de noms
- ajoutant des flux RSS ou des filtres de programme/groupe de travail du NBER
- configurant Gmail SMTP et un planificateur pour la version avancée d'email quotidien à heure fixe
La configuration de base ne nécessite qu'une sortie Markdown. La configuration avancée envoie un digest email HTML quotidien automatiquement après avoir configuré Gmail SMTP et un planificateur.
Ce qu'elle fait
- Surveille les revues cibles via des requêtes Crossref ISSN.
- Surveille les documents de travail du NBER via les fichiers TSV de métadonnées officiels du NBER.
- Surveille les sources RSS/Atom telles que CEPR, RePEc/NEP, les flux de la Réserve fédérale ou les alertes de revues.
- Suit les auteurs cibles dans toutes les métadonnées récupérées.
- Classe les articles candidats par source, statut de revue cible, correspondance avec l'auteur cible, correspondance thématique, correspondance JEL/méthode/géographie, et correspondance de mots-clés dans le résumé/titre.
- Déduplique les articles par DOI ou par titre/auteur comme solution de repli.
- Produit au plus
max_papersarticles par exécution, par défaut10. - Génère un digest Markdown.
- Envoie éventuellement un digest email HTML via Gmail SMTP ou un autre fournisseur SMTP selon un planning quotidien fixe.
- Ne télécharge pas de PDF sous paywall ni de texte intégral restreint.
Structure du Projet
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
Entrées
Configurez les entrées dans daily-econ-literature-radar.config.json.
Profil de Recherche
Utilisé pour le classement par pertinence :
fields: domaines de recherche générauxjel_codes: codes JEL ou familles JEL partielleskeywords: mots-clés thématiquesmethods: méthodes ou designs empiriquesgeographies: pays, régions, ensembles de données ou contextes
Revues Cibles
Surveillance exacte des revues via Crossref. Les 5 meilleures revues d'économie sont activées par défaut. Après avoir défini le profil de recherche, la compétence peut recommander des revues de premier plan dans le domaine ; l'utilisateur doit choisir les recommandations à ajouter. Chaque revue doit inclure :
nametierfieldissn
Exemple :
{
"name": "Nom de la Revue",
"tier": "field_top",
"field": "labor",
"issn": ["0000-0000"]
}
Vérifiez les ISSN avant de les ajouter.
Auteurs Cibles
Noms d'auteurs et alias à prioriser :
{
"name": "Nom de l'Auteur",
"aliases": ["A. Nom", "Auteur M. Nom"],
"notes": "Note optionnelle"
}
Sources
nber: adaptateur de métadonnées officiel du NBERrss_feeds: flux CEPR, RePEc/NEP, Fed, alertes de revues ou autres flux RSS/Atomtarget_journals: requêtes Crossref ISSN
Limites
max_papers: taille finale du digestper_source_rows: nombre de lignes à demander par requête sourcesource_caps: limites souples qui empêchent un type de source de saturer le digest
L'email est optionnel. Définissez email.enabled à true uniquement après avoir configuré les identifiants SMTP.
Sorties
Des exemples de sorties sont inclus dans example-output/sample-digest.md, example-output/sample-email.html et example-output/sample-email-preview.png. Ils utilisent des métadonnées d'articles synthétiques tout en conservant la même structure et le même style d'email que les exécutions réelles.

JSON de Récupération
Généré par fetch :
daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json
Chaque enregistrement d'article peut inclure :
titleauthorssourcesource_kinddatedate_typedoiurlabstractkeywordsmatched_termspriorityscorenotes
Digest Markdown
Généré par render_digest.py :
daily-econ-literature-radar-output/YYYY-MM-DD.md
Chaque article inclut le titre, les auteurs, la source, la date de publication/mise à jour, le DOI/URL, les termes correspondants, la priorité, le résumé et les notes.
Digest Email
Généré par send_digest.py ou run_daily_radar.py lorsque l'email est activé. L'email inclut :
- Corps HTML pour un affichage lisible dans Gmail/Outlook
- Alternative Markdown en texte brut
Comment Utiliser
Conseil : demandez à Codex ou Claude Code d'aider à configurer le profil de recherche, les choix de revues de premier plan dans le domaine, les auteurs cibles et l'envoi d'email programmé. Gmail SMTP avec un mot de passe d'application Google a été testé et fonctionne.
Version de Base : Markdown Uniquement
Depuis la racine du projet :
cp config.example.json daily-econ-literature-radar.config.json
Modifiez daily-econ-literature-radar.config.json avec votre profil de recherche, vos auteurs et vos sources. Conservez les 5 meilleures revues par défaut si vous le souhaitez, puis ajoutez des revues de premier plan dans le domaine après avoir choisi parmi les recommandations.
Récupérer les articles :
python3 daily-econ-literature-radar/scripts/economics_literature_radar.py fetch --config daily-econ-literature-radar.config.json
Générer le 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
Après avoir examiné le digest, marquez le traitement comme réussi :
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 met à jour state.json afin que les exécutions futures ne répètent pas les mêmes articles.
Version Avancée : Email Quotidien à Heure Fixe
La version avancée est un flux de travail planifié. Les scripts ne s'exécutent pas en tant que démon en arrière-plan par eux-mêmes ; un planificateur tel que l'automatisation Codex, cron, un LaunchAgent macOS ou le Planificateur de tâches Windows doit appeler run_daily_radar.py à l'heure souhaitée chaque jour.
Configurez l'heure de livraison souhaitée dans votre planificateur. Vous pouvez également l'enregistrer dans la configuration :
"push_time": "09:00",
"timezone": "America/Toronto"
Gmail SMTP
L'implémentation actuelle a été testée avec Gmail SMTP et un mot de passe d'application Google.
Définissez dans 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 nécessite généralement un mot de passe d'application Google plutôt que votre mot de passe Google normal. Créez-en un depuis les paramètres de sécurité de votre compte Google, puis stockez-le de l'une de ces manières.
Variable d'environnement :
export DAILY_RADAR_GMAIL_APP_PASSWORD="votre-mot-de-passe-d-application"
Fichier local ignoré :
mkdir -p .secrets
printf '%s' 'votre-mot-de-passe-d-application' > .secrets/gmail_app_password
chmod 600 .secrets/gmail_app_password
Le fichier .gitignore exclut .secrets/, .env, les configurations locales et les sorties.
Envoyer un Digest
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
Exécuter le Pipeline Complet d'Email
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
Ceci exécute :
fetch -> render Markdown -> send HTML email -> mark-success
Il marque le succès uniquement après la réussite de l'envoi de l'email.
Planifier la Livraison Quotidienne
Planifiez cette commande exacte pour qu'elle s'exécute une fois par jour à l'heure choisie :
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
Cette commande effectue le flux de travail complet de l'email quotidien :
fetch -> render Markdown -> send HTML email -> mark-success
Options de Planification
Automatisation Codex
Créez une automatisation cron quotidienne qui s'exécute depuis ce répertoire de projet :
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
Utilisez le fuseau horaire et l'heure locale préférés de l'utilisateur, par exemple 09h00 quotidiennement.
macOS Cron ou LaunchAgent
Ce projet a été développé et testé sur un environnement MacBook/macOS avec Python 3. Les options de planification macOS les plus simples sont :
- Automatisation Codex
cronlaunchd/ LaunchAgent
Pour cron, assurez-vous que la tâche démarre dans le répertoire du projet et utilise le même exécutable Python qui a fonctionné lors des tests.
Compatibilité Windows
La version actuelle est testée sur MacBook/macOS. Les scripts Python n'utilisent que la bibliothèque standard et devraient être portables, mais les utilisateurs Windows doivent adapter :
- Utilisez
pythonoupy -3au lieu depython3. - Utilisez la syntaxe de chemin PowerShell et mettez entre guillemets les chemins contenant des espaces.
- Utilisez le Planificateur de tâches Windows au lieu de cron/launchd.
- Remplacez
chmod 600par les permissions de fichiers Windows ou stockez le mot de passe de l'application dans une variable d'environnement. - Utilisez
.secrets\gmail_app_passworddans les chemins Windows si vous utilisez un secret de fichier. - Confirmez que les connexions SMTP TLS sont autorisées par le pare-feu local ou les outils antivirus.
Exemple de commande PowerShell :
cd "C:\chemin\vers\daily-econ-literature-radar"
py -3 daily-econ-literature-radar\scripts\run_daily_radar.py --config daily-econ-literature-radar.config.json
Confidentialité et Sécurité
Ne commettez pas :
daily-econ-literature-radar.config.json.secrets/.envdaily-econ-literature-radar-output/
La compétence utilise uniquement les métadonnées et les résumés fournis par les sources. Elle ne télécharge pas de PDF sous paywall ni de texte intégral restreint. Si une source n'a pas de résumé, le digest marque l'article comme sans résumé/titre uniquement au lieu d'inférer des résultats.
Notes pour la Personnalisation
- Gardez
max_paperssuffisamment petit pour que le digest reste lisible. - Les 5 meilleures revues sont activées par défaut ; ajoutez des revues de premier plan dans le domaine par ISSN vérifié après avoir choisi parmi les recommandations.
- Ajoutez des auteurs cibles avec des alias pour les initiales ou les variantes de nom.
- Ajoutez des flux RSS progressivement et examinez la qualité avant de planifier la livraison quotidienne.
- Utilisez des limites de source pour empêcher une source de dominer le digest.
