Communitygithub.com

lishn6/daily-econ-literature-radar

毎日の経済学文献フィードを提供するCodexスキル

daily-econ-literature-radar とは?

Daily Literature Radar は、経済学論文を対象ジャーナル、ワーキングペーパーソース、RSSフィード、注目の著者から追跡する Codex スキルです。Crossref のメタデータ、NBER 公式 TSV ファイル、RSS/Atom フィード(CEPR、RePEc/NEP、連邦準備制度など)を取得し、ユーザーの研究プロファイル(分野、キーワード、JELコード、手法、地域)に基づいて論文をランク付けし、日次ダイジェストを生成します。基本バージョンは Markdown 形式、上級バージョンは Gmail SMTP 経由で HTML メールを自動送信し、Markdown フォールバックも提供します。このスキルは Codex や Claude Code と連携して設定を支援するよう設計されており、研究関心から設定ファイルを生成し、ジャーナルの ISSN を検証し、スケジューラーによる定期実行をサポートします。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

プレビュー

スキル README より

レンダリングされたHTMLメールプレビュー

ドキュメント

日次経済学文献レーダースキル

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ジャーナルはデフォルトで有効になっています。研究プロファイルを設定した後、スキルは分野トップジャーナルを推薦できます。ユーザーはどの推薦を追加するかを選択してください。各ジャーナルには以下を含める必要があります:

  • name
  • tier
  • field
  • issn

例:

{
  "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 に含まれています。これらは実際の実行と同じ構造とメールスタイルを維持しながら、合成論文メタデータを使用しています。

レンダリングされたHTMLメールプレビュー

JSON の取得

fetch によって生成:

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

各論文レコードには以下を含めることができます:

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

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 自動化
  • cron
  • launchd / 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/
  • .env
  • daily-econ-literature-radar-output/

このスキルは、ソースから提供されたメタデータと要約のみを使用します。ペイウォール付き PDF や制限付き全文はダウンロードしません。ソースに要約がない場合、ダイジェストは論文を「要約なし/タイトルのみ」とマークし、内容を推測しません。

カスタマイズに関する注意事項

  • max_papers を、ダイジェストが読みやすい程度に小さく保ちます。
  • トップ5ジャーナルはデフォルトで有効です。推薦から選択した後、検証済みの ISSN で分野トップジャーナルを追加します。
  • イニシャルや名前のバリアントの別名を持つ対象著者を追加します。
  • RSSフィードは徐々に追加し、毎日の配信をスケジュールする前に品質を確認します。
  • ソースキャップを使用して、1つのソースがダイジェストを独占しないようにします。

関連スキル