快速开始¶

本指南帮助你从一台新机器开始，完成 NBER 工作论文的搜索、查看和下载。

环境要求¶

最快的方式是使用 uvx，它会在隔离环境中运行包，不需要永久安装。

uvx nber-cli --version
uvx nber-cli search "Labor Economic"
uvx nber-cli info w25000
uvx nber-cli download w34567

如果希望 shell 中一直可用 nber-cli 命令，可以使用：

uv tool install nber-cli
nber-cli --version

也可以使用 pipx：

pipx install nber-cli
nber-cli --version

包还提供了模块入口。当 nber-cli console script 不在你的 PATH 上时（例如从 checkout 的工作区直接运行，或者在没生成 wrapper 脚本的虚拟环境里）这个入口会很有用：

python -m nber_cli --version
python -m nber_cli search "labor economics"
python -m nber_cli info w25000

python -m nber_cli 与 nber-cli 命令在功能上完全一致——同样的参数、同样的退出码、同样的 stdout/stderr 合同。在工作区中你也可以通过 uv 跑它：

uv run python -m nber_cli --version

nber-cli search "labor economics"

搜索可以接受标题、作者、摘要、关键词或论文编号。默认每页返回 20 条结果。

添加日期范围和结果数量：

nber-cli search "minimum wage" --start-date 2024-01-01 --end-date 2024-12-31 --per-page 50

为脚本返回 JSON：

nber-cli search "inflation" --format json

nber-cli info w25000

论文编号可以带 w 前缀，也可以不带：

nber-cli info 25000

使用 --all 可以包含 NBER 暴露的相关字段和 published version 信息：

nber-cli info w25000 --all

初始化本地数据库：

nber-cli db init

获取 NBER 最新工作论文 RSS feed：

nber-cli feed fetch

第一次获取会把当前 RSS 条目写入缓存，并显示为新条目。后续获取默认只显示缓存中还没有出现过的条目。

限制输出数量，同时显示最新获取到的条目：

nber-cli feed fetch --max-items 5

清理旧缓存记录：

nber-cli feed clean --days 30

feed clean 删除缓存记录前会要求确认。

下载到当前目录：

nber-cli download w34567

保存到指定目录：

nber-cli download w34567 --save-base ~/papers/nber

保存到指定文件路径：

nber-cli download w34567 --file ~/papers/nber/w34567.pdf

nber-cli download --batch w34567 w25000 w32000 --save-base ~/papers/nber

批量模式支持 --save-base，不支持 --file。