Communitygithub.com

lishn6/radar-quotidien-litterature-economique

Une compétence Codex pour des flux quotidiens de littérature économique

Qu'est-ce que radar-quotidien-litterature-economique ?

Cette compétence pour Codex permet de suivre quotidiennement les articles économiques provenant de revues cibles, de documents de travail, de flux RSS et d'auteurs surveillés. Elle récupère les métadonnées ouvertes, classe les articles en fonction d'un profil de recherche défini par l'utilisateur et génère un digest quotidien au format Markdown ou HTML. Le système s'appuie sur Crossref pour les revues, sur les métadonnées officielles du NBER pour les documents de travail, et sur des flux RSS/Atom (CEPR, RePEc/NEP, Federal Reserve). La version avancée envoie le digest par email via Gmail SMTP selon un planning quotidien fixe. L'outil déduplique les articles par DOI ou titre/auteur, limite le nombre de publications par exécution (10 par défaut), et ne télécharge jamais de PDF sous paywall. Il est conçu pour être configuré avec l'aide de Codex ou Claude Code, qui traduisent les intérêts de recherche en mots-clés, codes JEL, méthodes et géographies, recommandent des revues de premier plan dans le domaine, et aident à paramétrer l'envoi email automatique.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Aperçu

Depuis le README du skill

Aperçu de l'email HTML rendu

Documentation

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, methods et geographies
  • 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_papers articles par exécution, par défaut 10.
  • 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éraux
  • jel_codes : codes JEL ou familles JEL partielles
  • keywords : mots-clés thématiques
  • methods : méthodes ou designs empiriques
  • geographies : 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 :

  • name
  • tier
  • field
  • issn

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 NBER
  • rss_feeds : flux CEPR, RePEc/NEP, Fed, alertes de revues ou autres flux RSS/Atom
  • target_journals : requêtes Crossref ISSN

Limites

  • max_papers : taille finale du digest
  • per_source_rows : nombre de lignes à demander par requête source
  • source_caps : limites souples qui empêchent un type de source de saturer le digest

Email

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.

Aperçu de l'email HTML rendu

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 :

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

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
  • cron
  • launchd / 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 python ou py -3 au lieu de python3.
  • 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 600 par les permissions de fichiers Windows ou stockez le mot de passe de l'application dans une variable d'environnement.
  • Utilisez .secrets\gmail_app_password dans 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/
  • .env
  • daily-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_papers suffisamment 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.

Skills associés