Communitygithub.com

lishn6/每日经济学文献雷达

一个针对Codex的技能,用于每日追踪经济学文献。

每日经济学文献雷达 是什么?

每日经济学文献雷达是一项针对Codex的技能,专为需要每日追踪经济学论文的经济学家和研究人员设计。它能够从目标期刊、NBER工作论文、RSS/Atom订阅源(如CEPR、RePEc/NEP、美联储)以及关注作者等多个来源抓取开放的元数据。该技能会依据用户自定义的研究概况(包括研究领域、关键词、JEL代码、方法和地理区域)对候选论文进行排名,并生成一个每日摘要。基础版本输出Markdown格式的摘要,而高级版本则支持在每日固定时间通过Gmail SMTP发送格式化的HTML邮件,并附带纯文本Markdown作为备选。该技能通过Crossref ISSN查询、官方NBER TSV文件解析以及通用RSS/Atom解析器来获取数据,并内置了去重(基于DOI或标题/作者)、来源软限制和优先级排序机制,以确保摘要的多样性和相关性。它不会下载付费墙后的PDF或受限全文,仅使用开放的元数据和摘要。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

预览

来自技能 README

渲染的HTML邮件预览

文档

每日文献雷达技能

每日文献雷达是一项Codex技能,用于追踪目标期刊、工作论文来源、RSS订阅源和关注作者的经济学论文。它抓取开放的元数据,根据用户定义的研究概况对论文进行排名,并生成每日摘要。

基础版本生成Markdown格式。高级版本按每日计划运行,并以格式化的HTML邮件发送摘要,同时附带Markdown备选。

当前来源库包括用于目标期刊的Crossref、官方NBER工作论文元数据,以及通用RSS/Atom订阅源(如CEPR、RePEc/NEP、美联储的订阅源和期刊提醒)。其他工作论文库可作为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元数据TSV文件监控NBER工作论文。
  • 监控RSS/Atom订阅源,如CEPR、RePEc/NEP、美联储订阅源或期刊提醒。
  • 在所有抓取的元数据中追踪目标作者。
  • 根据来源、目标期刊状态、目标作者匹配、主题匹配、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进行精确的期刊监控。经济学Top 5期刊默认启用。在研究概况设定后,技能可以推荐领域顶级期刊;用户应选择要添加的推荐项。每本期刊应包括:

  • name
  • tier
  • field
  • issn

示例:

{
  "name": "期刊名称",
  "tier": "领域顶级",
  "field": "劳动经济学",
  "issn": ["0000-0000"]
}

添加前请验证ISSN。

目标作者

要优先关注的作者姓名和别名:

{
  "name": "作者姓名",
  "aliases": ["A. 姓名", "作者 M. 姓名"],
  "notes": "可选备注"
}

来源

  • nber: 官方NBER元数据适配器
  • rss_feeds: CEPR、RePEc/NEP、Fed、期刊提醒或其他RSS/Atom订阅源
  • target_journals: Crossref ISSN查询

限制

  • max_papers: 最终摘要的大小
  • per_source_rows: 每个来源查询请求的行数
  • source_caps: 软限制,防止某类来源挤占摘要

邮件

邮件为可选。仅在配置SMTP凭据后将 email.enabled 设置为 true。

输出

示例输出包含在 example-output/sample-digest.md、example-output/sample-email.html 和 example-output/sample-email-preview.png 中。它们使用合成的论文元数据,同时保留了与实际运行相同的结构和邮件样式。

渲染的HTML邮件预览

Fetch 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帮助配置研究概况、领域顶级期刊选择、目标作者以及定时邮件发送。Gmail SMTP配合Google应用密码已经过测试并成功运行。

基础版本:仅Markdown

从项目根目录执行:

cp config.example.json daily-econ-literature-radar.config.json

编辑 daily-econ-literature-radar.config.json,填写您的研究概况、作者和来源。如果需要,保留默认的Top 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自动化、cron、macOS LaunchAgent或Windows任务计划程序)在每天所需时间调用 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": "每日文献雷达 <[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="您的应用密码"

忽略的本地文件:

mkdir -p .secrets
printf '%s' '您的应用密码' > .secrets/gmail_app_password
chmod 600 .secrets/gmail_app_password

.gitignore 文件会排除 .secrets/、.env、本地配置和输出。

发送一份摘要

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

这会运行:

抓取 -> 渲染Markdown -> 发送HTML邮件 -> 标记成功

它仅在邮件发送成功后才标记成功。

安排每日投递

将以下命令安排在每天所选时间运行一次:

python3 daily-econ-literature-radar/scripts/run_daily_radar.py --config daily-econ-literature-radar.config.json

该命令执行完整的每日邮件工作流:

抓取 -> 渲染Markdown -> 发送HTML邮件 -> 标记成功

调度选项

Codex自动化

创建一个每日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用户应注意调整:

  • 使用 python 或 py -3 代替 python3。
  • 使用PowerShell路径语法,并对包含空格的路径加引号。
  • 使用Windows任务计划程序代替cron/launchd。
  • 将 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 足够小,以便摘要保持可读性。
  • Top 5期刊默认启用;在从推荐中选择后,通过验证的ISSN添加领域顶级期刊。
  • 添加目标作者及其别名,以处理姓名缩写或变体。
  • 逐步添加RSS订阅源,并在安排每日投递前评估质量。
  • 使用来源软限制防止单一来源主导摘要。

相关技能