Article/skills/ads_literature_downloader/SKILL.md
Asfmq dfd0a980a5 feat: 重写 ADS 搜索脚本为 REST API,新增 Obsidian 转换 skill,修复路径
- ads_metadata_search: 移除 ads 库依赖,改用 requests 直连 ADS REST API;
  移除硬编码 API Key,改为 .env 文件/环境变量加载
- 新增 ads_html_to_obsidian skill:将下载的 HTML 文献批量转换为
  Obsidian Markdown 笔记(BS4 提取正文 + Pandoc 转换 + 清洗后处理)
- 两个 SKILL.md 中的 Windows 绝对路径改为相对路径
2026-05-26 17:30:36 +08:00

30 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
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` 萃取传入当前脚本。