---
name: ads_metadata_search
description: "用于在 ADS 中搜索天体物理文献，提取元数据信息。当用户要求搜索天文论文、查找作者、查看论文引用情况、查询 Bibcode，或者想了解某篇特定天体物理文献的信息时，务必触发并使用本技能（哪怕用户没有明确提到 ADS）。注意：如果用户明确要求下载全文 PDF 或 HTML，请不要使用本技能（应转用 downloader 技能）。"
---

# ADS Metadata Search (ADS 文献元数据搜索)

本技能利用 ADS API 搜索关于天文学、天体物理学、物理学的文献，提取特定的字段信息（如作者、标题、年份、Bibcode、摘要、被引数等）。**注意：它不会下载文献的 PDF 或 HTML，只提取元数据。如果你需要下载文献全文包，请使用 `ads_literature_downloader`。**

## 运行方式

由于查询通过命令行参数直接获取较困难（尤其是复杂的 query 字符串），我们通过内部包含的 Python 脚本 `scripts/search.py` 完成。

你可以通过执行该脚本来工作：

```bash
python .claude/skills/ads_metadata_search/scripts/search.py \
    --query "author:\"Hawking, S.\"" \
    --output "results.json" \
    --rows 10
```

### 参数选项
- `--query`: ADS查询语法字符串 (例如: `author:"Smith, J." year:2020` 或 `orcid:0000-0001-xxxx-xxxx`)
- `--output`: 结果保存到的 JSON 文件路径
- `--rows`: 返回的条目数量（默认 10）。如果你需要大量数据，可以增加到 50, 100 等。如果您只需要一条精准记录，可以设置为 1。
- `--year_range`: 年份区间，例如 `2018-2023` 或 `2020`。

### 脚本输出
脚本不仅会将详细元数据如 `bibcode`, `title`, `author`, `year`, `abstract`, `citation_count`, `reference_count` 写入 `output` 的 JSON 文件，还会在终端输出摘要预览，方便你进行查看。

拿到信息以后，如有必要，可以调用下载能力技能或者向用户继续询问后续需要分析什么。