Community研究与数据分析github.com

herowzr2023/学术论文抓取技能

私有 Codex 技能,融合 GAO-pooh/paper-scraper 与 Flyme886/nature-downloader,并配备可配置的已验证本地 DOI API 回退机制(MIT 协议)。

学术论文抓取技能 是什么?

该技能是专为 Codex 代理设计的私有技能包,主要用于高效获取学术论文全文。它整合了 GAO-pooh/paper-scraper 和 Flyme886/nature-downloader 两个核心模块:前者提供通用论文抓取能力,后者专注于 Nature 系列期刊的下载。此外,技能内置了一个可配置的本地 DOI API 回退机制,该接口已经过验证,能在主抓取源不可用时自动切换,从而提升整体可用率。技能配置文件允许用户自定义 DOI 解析端点、超时参数及重试策略。所有代码均采用 MIT 开源协议分发。支持通过 Shell 命令或 HTTP 请求直接调用,适用于自动化文献综述、研究数据采集等场景。它兼容 Cursor、Claude Code 等代码编辑助手,但需注意其设计定位为私有技能,仅限授权开发者使用。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add herowzr2023/paper-scraper-skill

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

学术论文抓取技能 是做什么的?

私有 Codex 技能,融合 GAO-pooh/paper-scraper 与 Flyme886/nature-downloader,并配备可配置的已验证本地 DOI API 回退机制(MIT 协议)。

功能概述

  • 通用论文抓取:基于 GAO-pooh/paper-scraper 实现,支持通过 DOI 或文章元数据从多个开放获取源抓取 PDF。
  • Nature 系列下载:集成 Flyme886/nature-downloader,专门从 nature.com 下载全文。
  • 本地 DOI API 回退:当外部大源不可用时,自动切换到已验证的本地 DOI 解析端点,提高成功率。
  • 可配置选项:提供 YAML 配置文件(config.yml),可自定义 API 端点、超时时间、重试次数等。

使用前提

  • 系统已安装 Python 3.8+ 及 requests 库。
  • 若使用本地 DOI API 回退,需提前部署并运行配套的本地服务(参见 local-doi-service/ 目录)。
  • 对于 Nature 下载,可能需要合法的机构访问权限或订阅。

安装

pip install -r requirements.txt

配置

复制 config.example.yml 为 config.yml,并根据需要修改:

doi_api:
  primary: "https://api.dx.doi.org/"
  fallback: "http://localhost:8080/doi/"
  timeout: 10
  retries: 3

paper_scraper:
  sources:
    - "arxiv"
    - "core"
    - "unpaywall"
  max_pages: 5

nature_downloader:
  output_dir: "./downloads/nature"
  concurrent: 2

使用方法

通过命令行

单次抓取一篇论文(支持 DOI):

python scraping_script.py --doi 10.1038/s41586-023-05800-7

批量抓取列表:

python scraping_script.py --list paper_dois.txt

作为 Codex 技能调用

在 Codex 会话中发送:

/scrape-doi 10.1038/s41586-023-05800-7

依赖

  • Python 3.8+
  • requests
  • pyyaml
  • beautifulsoup4(用于解析返回的 HTML)
  • tqdm(进度条)

许可

MIT License

注意事项

  • 请尊重版权与访问限制,仅用于个人学习或研究。
  • 本地 DOI API 回退端点必须事先部署,否则会引发连接错误。
  • 该技能属于私有仓库,未向公众开放。

相关技能