---
name: ads_literature_downloader
description: "用于根据 ADS Bibcode 批量下载天体物理学文献。当用户要求下载天文论文、获取文献的全文 PDF/HTML，或者让你根据 Bibcode 获取论文副本时，务必触发并使用本技能。注意：仅仅是查作者或者了解文献摘要等简单的元数据查询，绝对不要使用本技能。"
---

# ADS Literature Downloader (ADS 文献下载工具)

本技能利用 ADS Gateway 获取对应文献发表方 (Publisher) 或预印本 (arXiv) 的真实下载链接，并自动执行多线程并行下载。它通过读取 Bibcode 来工作。

## 运行方式

由于解析及下载逻辑较为复杂，我们将所有操作封装在了附带的 Python 脚本 `scripts/download.py` 中。在需要下载大量文献时，请调用它。

```bash
python .claude/skills/ads_literature_downloader/scripts/download.py \
    --bibcodes "2023ApJ...955...13H,2022MNRAS.510.4582S" \
    --output_dir "./ads_papers_output" \
    --threads 3
```

### 参数选项
- `--bibcodes`: 逗号分隔的 Bibcode 列表，例如 `2023ApJ...955...13H,2022MNRAS.510.4582S`
- `--bibcode_file`: 存放 Bibcode 列表的文本文件路径（每行一个 bibcode），如果 bibcode 极多，建议使用文件传参。
- `--output_dir`: 存放下载的 `PDF/` 和 `HTML/` 的根目录（若不存在将自动创建）。
- `--threads`: 解析与下载的最大并发数（默认为3，请不要设置过高防止触发风控）。

### 说明
脚本内部会优先尝试下载各个文献的 Publisher 来源 PDF，如果失败会尝试 Preprint PDF。状态和结果会实时输出。
如果是通过 `ads_metadata_search` 获取到的成果，可以从中单独把 `bibcode` 萃取传入当前脚本。