Citation Assistant — Productivity skill for Claude Code

Citation Assistant 学术文献引用助手

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

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

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

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

---

✨ 核心功能

功能	说明
🔍 语义化搜索	基于 Semantic Scholar API（覆盖 2 亿 + 文献），理解上下文语义，无需手动构造关键词
🛡️ 真实性保障	DOI→BibTeX 强制校验机制，确保文献真实存在，杜绝 AI 幻觉生成虚假引用
📊 多维度质量评估	期刊层面（CCF 分级、JCR 分区、中科院分区、影响因子）+ 作者层面（H-index、引用量）
📝 BibTeX 生成	一键生成标准 BibTeX 格式，可直接用于 LaTeX 文档
📋 推荐报告	结构化输出搜索结果，附推荐理由，便于快速决策

---

🚀 安装

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	少量高相关结果检索（含 arXiv 判断）	bash scripts/s2_search.sh "query" [limit]
s2_bulk_search.sh	使用 Semantic Scholar bulk endpoint 批量拉取候选结果，并按本地 limit 输出前 N 条	bash scripts/s2_bulk_search.sh "query" "year_range" limit
author_info.sh	作者 H-index 查询	bash scripts/author_info.sh "author_id"
venue_info.sh	期刊综合查询	bash scripts/venue_info.sh "venue_name"
ccf_lookup.sh	CCF 分级查询	bash scripts/ccf_lookup.sh "venue_name"
if_lookup.sh	影响因子查询	`bas