Citation Assistant 学术文献引用助手

面向 Claude Code / Cursor 的学术文献引用助手，适合论文写作、BibTeX 生成与文献质量筛选。

基于 Semantic Scholar API 的语义化文献检索，整合 CCF 分级、JCR 分区、中科院分区、影响因子、作者 H-index 等多维度质量评估，生成 BibTeX 并提供清晰的中文推荐说明。

这个仓库同时服务两类场景：

• GitHub 用户：阅读 README.md，了解功能、安装方式和使用示例
• Claude Skill 运行时：读取 SKILL.md，按既定脚本与流程执行任务

---

✨ 核心功能

---

🚀 安装

Claude Code

# 克隆仓库
git clone https://github.com/ZhangNy301/citation-assistant.git

# 复制到 Claude Code Skills 目录
mkdir -p ~/.claude/skills/citation-assistant
cp citation-assistant/SKILL.md ~/.claude/skills/citation-assistant/
cp -r citation-assistant/scripts ~/.claude/skills/citation-assistant/
cp -r citation-assistant/data ~/.claude/skills/citation-assistant/

# 配置 API Key（推荐）
echo 'S2_API_KEY="your_key_here"' > ~/.claude/skills/citation-assistant/.env

Cursor

# 创建目录并克隆
mkdir -p ~/.cursor/skills
cd ~/.cursor/skills
git clone https://github.com/ZhangNy301/citation-assistant.git

# 配置 API Key（推荐）
echo 'S2_API_KEY="your_key_here"' > ~/.cursor/skills/citation-assistant/.env

获取 API Key: https://www.semanticscholar.org/product/api

---

📦 可用脚本

说明：s2_search.sh 更适合少量高相关结果检索；s2_bulk_search.sh 更适合减少请求次数、先批量拉取候选文献再做筛选。

---

🆕 增强功能

arXiv 文章智能判断

搜索结果会自动标记 arXiv 文章的引用状态：

作者信息查询

搜索结果包含前 3 位作者的 ID，可用于查询 H-index：

bash scripts/author_info.sh "18119920"

返回示例：

{
  "name": "Daquan Zhou",
  "hIndex": 25,
  "citations": 8500,
  "papers": 42
}

---

📁 文件结构

citation-assistant/
├── SKILL.md               # Skill 主文件
├── README.md              # 本文件
├── CHANGELOG.md           # 版本历史
├── .env.example           # 配置模板
├── scripts/               # Shell 脚本
│   ├── s2_search.sh
│   ├── s2_bulk_search.sh
│   ├── author_info.sh
│   ├── venue_info.sh
│   ├── ccf_lookup.sh
│   ├── if_lookup.sh
│   ├── doi2bibtex.sh
│   └── crossref_search.sh
└── data/                  # 数据库
    ├── ccf_2026.sqlite
    ├── ccf_2026.jsonl
    └── impact_factor.sqlite3

---

🔧 配置

Semantic Scholar API Key

获取地址：https://www.semanticscholar.org/product/api

arXiv 引用阈值（可选）

# 默认 100，可在 .env 中配置
echo 'ARXIV_CITATION_THRESHOLD=100' >> ~/.claude/skills/citation-assistant/.env

---

📊 质量评估维度

---

📖 使用示例

下面这些示例是用户在 Claude Code / Cursor 中可以直接提出的请求，也是这个 skill 最常见的使用方式。

示例 1：为 LaTeX 段落找引用

我在写论文，这段话需要找引用：

  "Deep learning has achieved remarkable success in medical image analysis, particularly in radiology where chest X-rays are the most commonly performed imaging examination globally [CITE]. Recent advances in vision transformers have further improved performance on these tasks [CITE]."

帮我找合适的文献。

示例 2: 查询期刊质量

我想投 TMI (IEEE Transactions on Medical Imaging)，这个期刊质量怎么样？
CCF 分级是什么？影响因子多少?

示例 3: 查询作者学术影响力

这篇论文的第一作者 H-index 是多少?我想评估一下作者的学术影响力。

示例 4: 生成 BibTeX

帮我生成这篇论文的 BibTeX：
DOI: 10.1038/s41591-020-0792-9

示例 5：批量搜索 + 年份过滤

帮我找 2020 年以后关于 remote photoplethysmography (rPPG) 的论文，要高质量的，列出 10 篇推荐。

适合使用 s2_bulk_search.sh 对候选文献进行批量拉取，再结合年份、引用量、venue 质量等信息做筛选。

示例 6: 综合工作流（粘贴论文段落）

帮我检查这段论文的引用是否合适，如果有更好的推荐请告诉我：

Remote photoplethysmography (rPPG) enables non-contact heart rate estimation from facial videos [1]. Traditional methods like CHROM and POS have been widely used [2], while recent deep learning approaches have shown superior performance [3].

[1] Some arXiv paper with 5 citations
[2] A conference paper from 2015
[3] Another paper

---

🙏 致谢

• Semantic Scholar - Academic paper search API
• impact_factor - Journal impact factor database
• CrossRef - DOI metadata API

📖 相关链接

• 小红书教程：文献引用自动化

License

MIT