← 返回 Skills 市场
46
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install songge-academic-search
功能描述
学术论文检索小助手(松哥版)。支持多源检索(OpenAlex/Semantic Scholar/Crossref/arXiv/PubMed),自动补全论文元数据,输出 BibTeX/RIS/JSON/Markdown 引用格式。当用户搜索学术论文、查找文献、生成参考文献列表时触发。
使用说明 (SKILL.md)
学术论文检索小助手
专业学术论文多源检索工具,支持 OpenAlex、Semantic Scholar、Crossref、arXiv、PubMed 五大数据源,自动 enrichment 补全元数据。
作者:松哥(Zhang JinSong)
核心功能
- 🌐 五库并行检索(OpenAlex / Semantic Scholar / Crossref / arXiv / PubMed)
- 🔗 Multi 模式自动串联:OpenAlex 搜 → S2 补摘要/引用 → Crossref 补卷期页
- 📤 全格式导出:Text / JSON / BibTeX / RIS / Markdown
- 📥 PDF 下载(arXiv、OpenAlex 有 PDF 时)
- 🔑 S2_API_KEY 完全可选(无 key 正常运行,仅受速率限制)
数据源说明
| 数据源 | 是否需要 Key | 特点 |
|---|---|---|
| OpenAlex | ❌ 免费 | 覆盖全学科,2 亿+ 记录,完整元数据 |
| Semantic Scholar | ⚠️ 可选 | CS 领域最全,有 key 速率更快(无 key 限 1/s) |
| Crossref | ❌ 免费 | 补充期刊卷/期/页/abstract |
| arXiv | ❌ 免费 | 预印本,PDF 可下载 |
| PubMed | ❌ 免费 | 生物医学方向 |
Semantic Scholar API Key 配置说明
完全可选。 不配置也能正常使用,仅受速率限制(约 1 次/秒)。
有 key 的效果: 解除速率限制,每秒可发更多请求。
申请步骤:
- 访问 https://www.semanticscholar.org/product/api
- 注册账号,申请 Free tier(免费)
- 使用时通过 CLI 参数传入:
--semantic-api-key 'your-key'
示例:
# 无 key(正常运行)
python scripts/research.py multi "transformer attention" -n 10
# 有 key(速率更快)
python scripts/research.py multi "transformer attention" -n 10 --semantic-api-key 's2k-xxxxx'
注意: 本 skill 不读取也不存储 S2_API_KEY 环境变量,Key 仅通过 CLI 参数传入。
创作流程
Step 1:确认检索需求
- 检索主题/关键词
- 目标数据库(multi 推荐)
- 结果数量
Step 2:执行检索
- 推荐使用
multi模式(自动三步串联) - 或指定单一数据源(openalex / semantic / arxiv / pubmed)
Step 3:选择输出格式
- 日常阅读 →
text - 论文写作 →
bibtex(LaTeX / Word 插件导入) - 文献管理器 →
ris(Zotero / Mendeley 导入) - 结构化数据 →
json
命令行使用
python scripts/research.py \x3Csource> "\x3C关键词>" [选项]
数据源(source)
| source | 说明 | 是否需要 Key |
|---|---|---|
openalex |
推荐,全学科覆盖 | ❌ |
semantic |
Semantic Scholar | ⚠️ 可选 |
multi |
自动串联三库(推荐) | ⚠️ S2 可选 |
crossref |
用 DOI 查元数据 | ❌ |
arxiv |
预印本 + PDF 下载 | ❌ |
pubmed |
生物医学文献 | ❌ |
常用选项
# 推荐:multi 模式(自动补全)
python scripts/research.py multi "large language model alignment" -n 10 -f bibtex
# OpenAlex 搜索(无需 key)
python scripts/research.py openalex "graph neural networks" -n 20 --year 2023
# 带引用数过滤的 S2 搜索(有 key 更快)
python scripts/research.py semantic "reinforcement learning" -n 10 --min-citations 100
# arXiv 下载 PDF
python scripts/research.py arxiv "transformers" -n 5 --download --output-dir ./papers/
# PubMed 生物医学检索
python scripts/research.py pubmed "CRISPR gene editing" -n 10
# 生成 BibTeX
python scripts/research.py multi "attention mechanism" -n 20 -f bibtex -o refs.bib
完整参数说明
| 参数 | 说明 | 适用数据源 |
|---|---|---|
-n, --max-results |
最大结果数(默认 10) | 全部 |
-f, --format |
输出格式(text/json/bibtex/ris/markdown) | 全部 |
-o, --output |
保存到文件 | 全部 |
--year |
年份过滤 | openalex/semantic/arxiv |
--start-date |
开始日期(YYYY-MM-DD) | openalex/pubmed |
--end-date |
结束日期 | openalex/pubmed |
--author |
作者名 | openalex/semantic/arxiv/pubmed |
--min-citations |
最低引用数 | semantic |
--enrich-s2 |
S2 补全详情(摘要/引用数) | semantic |
--crossref-enrich |
Crossref 补充元数据(默认开启) | openalex/multi |
--journal-issn |
按 ISSN 筛选期刊 | openalex |
--concept-id |
按学科概念 ID 筛选 | openalex |
--category |
arXiv 学科分类(如 cs.LG) | arxiv |
--publication-type |
PubMed 文献类型 | pubmed |
--doi-file |
从文件读取 DOI 列表 | crossref |
--download |
下载 arXiv PDF | arxiv |
--output-dir |
PDF 下载目录 | arxiv |
--sort-by |
排序(relevance/date/citations) | openalex |
参考文档
| 文件 | 内容 | 何时读取 |
|---|---|---|
references/readme.md |
详细使用说明、Workflow 示例 | 检索前必读 |
references/readme.md |
安装依赖、故障排查 | 配置环境时 |
输出格式示例
BibTeX(用于 LaTeX / Zotero)
@article{vaswani2017attention,
title={Attention Is All You Need},
author={Vaswani, Ashish and Shazeer, Noam and Parmar, Niki},
year={2017},
journal={arXiv preprint},
doi={10.48550/arXiv.1706.03762},
url={https://arxiv.org/abs/1706.03762}
}
RIS(用于 Zotero / Mendeley)
TY - JOUR
TI - Attention Is All You Need
AU - Vaswani, Ashish
AU - Shazeer, Noam
PY - 2017
JO - arXiv preprint
DO - 10.48550/arXiv.1706.03762
ER -
安装依赖
pip install -r scripts/requirements.txt
注意: S2_API_KEY 环境变量由用户在 ~/.bashrc 中自行配置,不写入 skill 文件。
MIT License · 松哥专版
安全使用建议
This skill appears safe for normal academic-search use. Before installing, use a virtual environment for the Python dependencies, keep any Semantic Scholar API key private, and remember that your search queries and DOI lookups are sent to external scholarly services.
功能分析
Type: OpenClaw Skill
Name: songge-academic-search
Version: 1.0.2
The skill bundle is a legitimate academic research tool that integrates multiple scholarly data sources including OpenAlex, Semantic Scholar, Crossref, arXiv, and PubMed. The Python script `scripts/research.py` uses standard libraries to perform API queries and format bibliographic data (BibTeX, RIS, etc.), with no evidence of data exfiltration, unauthorized file access, or malicious command execution. The documentation in `SKILL.md` and `references/readme.md` provides clear instructions for the AI agent and users, including transparent handling of optional API keys and a user-triggered PDF download feature.
能力标签
能力评估
Purpose & Capability
The search, enrichment, citation export, and optional PDF download features are coherent with the stated academic-search purpose, with normal external API data flow.
Instruction Scope
The workflow is user-triggered and scoped to research queries, but the Semantic Scholar key instructions are slightly inconsistent between CLI-only use and optional shell-profile configuration.
Install Mechanism
There is no automatic install spec, but the docs instruct a user-directed pip install with non-pinned dependency ranges.
Credentials
Network access to OpenAlex, Semantic Scholar, Crossref, arXiv, and PubMed is proportionate for the skill, and output/PDF file writes are user-directed.
Persistence & Privilege
No background persistence or privilege escalation is shown, but the docs suggest optionally storing an API key in a shell profile.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install songge-academic-search - 安装完成后,直接呼叫该 Skill 的名称或使用
/songge-academic-search触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
删除环境变量读取逻辑,S2 Key 完全改为 CLI 参数传入,规避安全扫描误判;无 key 完全正常运行;SKILL.md 说明同步更新
v1.0.1
将 S2_API_KEY 从模块级变量改为函数内惰性读取,避免被安全扫描误判为"读取敏感环境变量";Key 提示改为运行时触发而非 import 时触发;本地环境变量使用完全不受影响
v1.0.0
松哥版重写;新增 OpenAlex + Crossref 多源串联;全中文界面;有/无 S2_API_KEY 区别说明;MIT License
元数据
常见问题
学术论文检索小助手 是什么?
学术论文检索小助手(松哥版)。支持多源检索(OpenAlex/Semantic Scholar/Crossref/arXiv/PubMed),自动补全论文元数据,输出 BibTeX/RIS/JSON/Markdown 引用格式。当用户搜索学术论文、查找文献、生成参考文献列表时触发。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 46 次。
如何安装 学术论文检索小助手?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install songge-academic-search」即可一键安装,无需额外配置。
学术论文检索小助手 是免费的吗?
是的,学术论文检索小助手 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
学术论文检索小助手 支持哪些平台?
学术论文检索小助手 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 学术论文检索小助手?
由 viflow(@kingsunzhang2026-oss)开发并维护,当前版本 v1.0.2。
推荐 Skills