mcpField
A
acquire-research-papers

acquire-research-papers

github.com/enoselinsa生产力19 次安装1 周前更新
代码仓库

关于 acquire-research-papers

用于获取研究论文的命令行技能,将出版商 PDF 与原始 BibTeX 导出核验为一组。它支持论文发现和文献库工作流,并保留来源引文数据及出版商访问边界。

主要功能

  1. 01核验出版商 PDF 与 BibTeX
  2. 02按 DOI、URL 和标题获取
  3. 03语料库与作者发现
  4. 04文献库审计和整理
  5. 05显式导出 PDF 至 Markdown

适用场景

  1. 01通过 DOI 获取指定论文
  2. 02构建并审核会议或主题语料库
  3. 03审计和整理本地论文库

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/enoselinsa/acquire-research-papers --skill acquire-research-papers

安装后在 Claude Code 中输入/acquire-research-papers确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

runtime.json
agents/
openai.yaml
references/
author-mode.md
configuration.md
corpus-mode.md
credentials-and-cache.md
library-mode.md
research-mode.md
source-policies.md
workflows.md
schemas/
author-discovery.schema.json
author-spec.schema.json
corpus-spec.schema.json
institution-profile.schema.json
library-audit.schema.json
library-plan.schema.json
paper-record.schema.json
research-brief.schema.json
research-evidence-review.schema.json
research-review-decision.schema.json
scripts/
arp.py

详细介绍

获取研究论文

交付经验证的一对文件:出版商官方 PDF 和出版商原始 BibTeX 导出文件。发现元数据用于提名候选项并支持比较;它绝不会成为最终的引文材料。

运行已安装的技能

确定此技能实际安装目录,然后运行其便携式启动器:

python <skill-directory>/scripts/arp.py --help
python <skill-directory>/scripts/arp.py config status

需要 Python 3.11+ 和 uv。标准库启动器仅在验证 SHA-256 后,才会从 runtime.json 安装固定版本的 wheel;安装位置是技能目录之外的独立缓存。无需开发者检出版本或项目环境。尚未发布的版本 wheel 无法通过其发布 URL 引导启动;可通过 ARP_LOCAL_WHEEL 提供匹配的本地版本 wheel,以进行隔离验证。

先检查 arp config status。IEEE、MinerU、Elsevier、Semantic Scholar 和 OpenAlex 均为可选且相互独立;仅针对当前任务所需的功能进行配置。使用 IEEE 访问时,选择用户指定的机构配置文件。已存储的配置和历史检查结果不能证明当前的订阅状态或 API 权限。切勿在聊天中索要密钥。随附了公开的架构快照以供参考;arp schema <schema-name.json> 会返回当前运行版本中所含的权威架构。

路由任务

请求命令和参考
配置机构、切换配置文件、登录或验证访问权限arp config setup ieee、arp config ieee list/use/login/doctor;阅读配置
配置一个 API/解析器提供方arp config setup <provider>;阅读凭据和缓存
已知 DOI、出版商 URL、精确标题或明确列出的论文arp fetch;阅读获取工作流
由用户操作的 ScienceDirect 下载arp manual-fetch;阅读来源策略
检查现有文献库的一致性、出版物变更、缺失文件对或重复项arp library audit/update;阅读文献库模式
导入、重命名、整理或提取已明确指定的书籍章节arp library import/organize/apply;阅读文献库模式
某位作者的出版物,包括日期范围或与本地文献库比较arp discover author;阅读作者模式
按会议/期刊、主题/年份/数量筛选文献集arp discover corpus --progress → arp review corpus → arp acquire corpus;阅读文献集模式
查找最接近的研究、相关工作、论点引文或研究空白证据arp discover research → 审查 → 获取 → 证据;阅读研究模式
明确将 PDF 导出为 Markdownarp export-md;阅读凭据和缓存

附带的文档或角色分配是输入适配器:将其中的相关要求转换为通用的文献集/研究/作者规范。运行文献库或作者任务时,保持文献集和研究的冻结哈希不变。

审查与完成

  • 保留原始 BibTeX 字节、BOM、编码和换行符。仅解码用于解析的视图。绝不使用 LLM 或元数据 API 生成或修复引文。
  • 验证 DOI、标题、年份、作者范围和出版 venue。明确报告身份模糊和不完整证据。
  • 语料决策需检查 evidence-packets.jsonl 并记录标题与摘要证据。仅获取由 selection-manifest.json 绑定的冻结版 selected-papers.jsonl;关键词是可选项,判断语料相关性不要求全文。
  • --defer-host 会将所选论文保留在 manual-download.csv 中;绝不从冻结选择中移除难以获取的论文,也不降低相关性阈值来凑足配额。
  • 文献库审计需区分本地 PDF 版本、引文位置和当前元数据。当前引文不能证明 PDF 是最新版本。执行明确的 arp library apply --plan <path> 前,先审查 plan.json;update/import/organize 不会自动应用。保留备份以便回滚。
  • 作者检索需报告来源覆盖范围、身份模糊情况、正式发表/在线优先/预印本分组,以及分别列出的期号日期和在线日期。绝不声称书目绝对完整。
  • 普通获取、手动获取和语料工作流均不会生成 Markdown。研究使用内部 MinerU 缓存;仅在用户明确指定目标位置后才导出 Markdown。

访问边界

更改获取约定前,请阅读来源政策;进行机构适配前,请阅读配置。

绝不打印、记录、提交或发送凭据、令牌、Cookie、浏览器存储数据或解密后的值。状态数据和交付文件应保存在公开仓库之外。IEEE 会针对所选机构使用隔离且可见的配置文件;仅在其精确配置的主机名下才会提供凭据。成功登录身份提供商,不代表已返回 IEEE、已验证下载,或已证明享有机构访问权限。

绝不自动操作 ScienceDirect 文章页面或 ScienceDirect 机构登录流程,不连接到用户的常用 Chrome,不读取其配置文件,也不导出 Cookie/会话数据。授权用户自行下载 PDF 和原始 BibTeX;CLI 随后处理本地稳定文件。不得绕过出版商/机构的访问控制,也不得用镜像、发现阶段的 BibTeX 或生成的引文替代。

评论

支持 Markdown