日次経済学文献レーダースキル
Daily Literature Radar は、対象ジャーナル、ワーキングペーパーソース、RSSフィード、注目の著者から経済学論文を追跡する Codex スキルです。公開メタデータを取得し、ユーザー定義の研究プロファイルに基づいて論文をランク付けし、日次ダイジェストを生成します。
基本バージョンは Markdown を生成します。上級バージョンは日次スケジュールで実行され、書式設定された HTML メール(Markdown フォールバック付き)としてダイジェストを送信します。
現在のソースライブラリには、対象ジャーナル用の Crossref、公式 NBER ワーキングペーパーメタデータ、CEPR、RePEc/NEP、連邦準備制度フィード、ジャーナルアラートなどの汎用 RSS/Atom フィードが含まれています。追加のワーキングペーパーリポジトリは、RSSフィードまたはソースアダプターとして追加できます。
推奨:Codex で設定する
このスキルは、Codex または Claude Code の支援を受けて設定するように設計されています。コーディングエージェントは、以下の方法で研究関心を作業用の daily-econ-literature-radar.config.json に変換するのに役立ちます:
- 研究トピックを
fields、keywords、jel_codes、methods、geographiesに変換する - 研究プロファイルを定義した後、分野トップジャーナルを推薦し、選択したジャーナルのみを追加する
- ジャーナルの ISSN を見つけて検証し、
target_journalsに追加する前に確認する - 対象著者と名前の別名を追加する
- RSSフィードやNBERプログラム/ワーキンググループフィルターを追加する
- 上級の固定時間日次メール配信のために、Gmail SMTP とスケジューラーを設定する
基本設定では Markdown 出力のみが必要です。上級設定では、Gmail SMTP とスケジューラーを設定後、日次 HTML メールダイジェストを自動送信します。
機能
- 対象ジャーナルを Crossref ISSN クエリを通じて監視する。
- NBER ワーキングペーパーを公式 NBER メタデータ TSV ファイルを通じて監視する。
- CEPR、RePEc/NEP、連邦準備制度フィード、またはジャーナルアラートなどの RSS/Atom ソースを監視する。
- 取得したすべてのメタデータから対象著者を追跡する。
- 候補論文を、ソース、対象ジャーナルステータス、対象著者一致、トピック一致、JEL/手法/地理的一致、要約/タイトルキーワード一致によってランク付けする。
- DOI またはタイトル/著者のフォールバックによって論文を重複排除する。
- 実行ごとに最大
max_papers件の論文を出力する(デフォルトは 10)。 - Markdown ダイジェストを生成する。
- オプションで、Gmail SMTP または別の SMTP プロバイダーを通じて、固定の日次スケジュールで HTML メールダイジェストを送信する。
- ペイウォール付き PDF や制限付き全文はダウンロードしません。
プロジェクト構造
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
入力
daily-econ-literature-radar.config.json で入力を設定します。
研究プロファイル
関連性ランキングに使用:
fields: 広範な研究分野jel_codes: JELコードまたは部分的なJELファミリーkeywords: トピックキーワードmethods: 手法または実証計画geographies: 国、地域、データセット、または設定
対象ジャーナル
Crossref を通じた正確なジャーナル監視。経済学のトップ5ジャーナルはデフォルトで有効になっています。研究プロファイルを設定した後、スキルは分野トップジャーナルを推薦できます。ユーザーはどの推薦を追加するかを選択してください。各ジャーナルには以下を含める必要があります:
nametierfieldissn
例:
{
"name": "Journal Name",
"tier": "field_top",
"field": "labor",
"issn": ["0000-0000"]
}
追加する前に ISSN を検証してください。
対象著者
優先順位付けする著者名と別名:
{
"name": "Author Name",
"aliases": ["A. Name", "Author M. Name"],
"notes": "Optional note"
}
ソース
nber: 公式 NBER メタデータアダプターrss_feeds: CEPR、RePEc/NEP、連邦準備制度、ジャーナルアラート、またはその他の RSS/Atom フィードtarget_journals: Crossref ISSN クエリ
制限
max_papers: 最終ダイジェストのサイズper_source_rows: ソースクエリごとに要求する行数source_caps: 1つのソースタイプがダイジェストを占領するのを防ぐソフトキャップ
メール
メールはオプションです。SMTP 認証情報を設定した後にのみ email.enabled を true に設定してください。
出力
出力例は example-output/sample-digest.md、example-output/sample-email.html、および example-output/sample-email-preview.png に含まれています。これらは実際の実行と同じ構造とメールスタイルを維持しながら、合成論文メタデータを使用しています。

JSON の取得
fetch によって生成:
daily-econ-literature-radar-output/data/YYYY-MM-DDTHHMMSSZ.json
各論文レコードには以下を含めることができます:
titleauthorssourcesource_kinddatedate_typedoiurlabstractkeywordsmatched_termspriorityscorenotes
Markdown ダイジェスト
render_digest.py によって生成:
daily-econ-literature-radar-output/YYYY-MM-DD.md
各論文には、タイトル、著者、ソース、公開/更新日、DOI/URL、一致した用語、優先度、要約、メモが含まれます。
メールダイジェスト
メールが有効な場合、send_digest.py または run_daily_radar.py によって生成されます。メールには以下が含まれます:
- 読みやすい Gmail/Outlook 表示のための HTML 本文
- プレーンテキストの Markdown フォールバック
使用方法
ヒント:Codex または Claude Code に、研究プロファイル、分野トップジャーナルの選択、対象著者、スケジュールされたメール送信の設定を依頼してください。Google アプリパスワードを使用した Gmail SMTP はテスト済みで動作します。
基本バージョン:Markdown のみ
プロジェクトルートから:
cp config.example.json daily-econ-literature-radar.config.json
研究プロファイル、著者、ソースを指定して daily-econ-literature-radar.config.json を編集します。必要に応じてデフォルトのトップ5ジャーナルを維持し、推薦から選択した後、分野トップジャーナルを追加します。
論文を取得:
python3 daily-econ-literature-radar/scripts/economics_literature_radar.py fetch --config daily-econ-literature-radar.config.json
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
ダイジェストを確認後、成功処理をマーク:
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 は state.json を更新し、将来の実行で同じ論文が繰り返されないようにします。
上級バージョン:固定時間の日次メール
上級バージョンはスケジュールされたワークフローです。スクリプトはそれ自体ではバックグラウンドデーモンとして実行されません。Codex Automation、cron、macOS LaunchAgent、または Windows Task Scheduler などのスケジューラーが、希望の時間に毎日 run_daily_radar.py を呼び出す必要があります。
スケジューラーで希望の配信時間を設定します。設定ファイルに記録することもできます:
"push_time": "09:00",
"timezone": "America/Toronto"
Gmail SMTP
現在の実装は、Gmail SMTP と Google アプリパスワードでテストされています。
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 は通常、通常の Google パスワードではなく Google アプリパスワードを必要とします。Google アカウントのセキュリティ設定から作成し、以下のいずれかの方法で保存してください。
環境変数:
export DAILY_RADAR_GMAIL_APP_PASSWORD="your-app-password"
無視されるローカルファイル:
mkdir -p .secrets
printf '%s' 'your-app-password' > .secrets/gmail_app_password
chmod 600 .secrets/gmail_app_password
.gitignore ファイルは .secrets/、.env、ローカル設定、および出力を除外します。
1つのダイジェストを送信
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
完全なメールパイプラインを実行
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
これにより以下が実行されます:
fetch -> render Markdown -> send HTML email -> mark-success
メール送信が成功した後にのみ、成功がマークされます。
日次配信をスケジュール
この正確なコマンドを、選択した時間に1日1回実行するようにスケジュールします:
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
このコマンドは完全な日次メールワークフローを実行します:
fetch -> render Markdown -> send HTML email -> mark-success
スケジューリングオプション
Codex Automation
このプロジェクトディレクトリから実行される日次 cron 自動化を作成します:
python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json
ユーザーの希望するローカルタイムゾーンと時間(例:毎日 09:00)を使用します。
macOS Cron または LaunchAgent
このプロジェクトは MacBook/macOS 環境で Python 3 を使用して開発およびテストされました。最も簡単な macOS スケジューリングオプションは次のとおりです:
- Codex 自動化
cronlaunchd/ LaunchAgent
cron の場合、ジョブがプロジェクトディレクトリで開始され、テストで動作したのと同じ Python 実行可能ファイルを使用することを確認してください。
Windows 互換性
現在のバージョンは MacBook/macOS でテストされています。Python スクリプトは標準ライブラリのみを使用しているため、移植可能であるはずですが、Windows ユーザーは以下を調整してください:
python3の代わりにpythonまたはpy -3を使用する。- PowerShell のパス構文を使用し、スペースを含むパスを引用符で囲む。
- cron/launchd の代わりに Windows Task Scheduler を使用する。
chmod 600を Windows ファイルアクセス許可に置き換えるか、アプリパスワードを環境変数に保存する。- ファイルシークレットを使用する場合は、Windows パスで
.secrets\gmail_app_passwordを使用する。 - TLS SMTP 接続がローカルファイアウォールまたはアンチウイルスツールによって許可されていることを確認する。
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
プライバシーと安全性
以下をコミットしないでください:
daily-econ-literature-radar.config.json.secrets/.envdaily-econ-literature-radar-output/
このスキルは、ソースから提供されたメタデータと要約のみを使用します。ペイウォール付き PDF や制限付き全文はダウンロードしません。ソースに要約がない場合、ダイジェストは論文を「要約なし/タイトルのみ」とマークし、内容を推測しません。
カスタマイズに関する注意事項
max_papersを、ダイジェストが読みやすい程度に小さく保ちます。- トップ5ジャーナルはデフォルトで有効です。推薦から選択した後、検証済みの ISSN で分野トップジャーナルを追加します。
- イニシャルや名前のバリアントの別名を持つ対象著者を追加します。
- RSSフィードは徐々に追加し、毎日の配信をスケジュールする前に品質を確認します。
- ソースキャップを使用して、1つのソースがダイジェストを独占しないようにします。
