mcpField
A
arxiv-research

arxiv-research

github.com/ray0907生产力644 次安装5 周前更新
代码仓库

关于 arxiv-research

arxiv-research 是面向学术研究者的研究技能，涵盖 arXiv 论文发现、内容分析、引文生成和 TikZ 图形提取。它将检索、理解与来源归属串联为研究流程。

主要功能

  1. 01检索 arXiv 并探索引文关系
  2. 02使用结构化提示词分析论文
  3. 03生成多种格式的引文
  4. 04从 LaTeX 源码提取 TikZ 图形

适用场景

  1. 01查找特定主题的论文
  2. 02比较论文或评估证据
  3. 03为文献综述整理参考文献
  4. 04从论文源码提取图表

安装

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

$npx skills add https://github.com/ray0907/arxiv-research-skill --skill arxiv-research

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

包含的文件

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

LICENSE
README.md
.gitignore
pyproject.toml
references/
workflows.md
scripts/
cache.py
understand.py
evidence.py
tikz.py
utils.py
connect.py

详细介绍

arXiv 研究技能

通过四项能力构建系统化学术研究流程，形成知识构建闭环：

connect -> understand -> evidence
  Find  ->  Comprehend ->  Cite
             tikz (extract figures from LaTeX sources)

设置

安装依赖：uv sync

能力

连接（知识导航）

在 arXiv 中查找相关论文、探索引用网络并发现相关研究。

# Search with optional filters
uv run python scripts/connect.py search "transformer attention mechanism" --category cs.LG --limit 20
uv run python scripts/connect.py search "LLM agents" --since 2023-01 --until 2024-06
uv run python scripts/connect.py search "topic" --with-citations --sort citations

# Discover related work
uv run python scripts/connect.py similar "2301.00001" --limit 10
uv run python scripts/connect.py recent cs.AI --days 7
uv run python scripts/connect.py by-author "Yann LeCun"

# Citation network
uv run python scripts/connect.py cited-by "2301.00001" --limit 20
uv run python scripts/connect.py coauthors "Yann LeCun" --limit 20

# Get full paper content (single or batch)
uv run python scripts/connect.py content "2301.00001"
uv run python scripts/connect.py content "2301.00001,2302.00002,2303.00003"
理解（意义提取）

使用结构化提示词分析论文内容。将 connect.py content 输出的论文内容传入分析流程。

uv run python scripts/connect.py content "2301.00001" | uv run python scripts/understand.py analyze quick

可用提示词（uv run python scripts/understand.py list）：

提示词用途
quick快速结构化摘要
methodology详细提取方法论
contribution识别并排列贡献
critical分析优点与不足
compare多篇论文对比表
literature为文献综述整理内容
implementation提取复现细节
evidence评估其作为某项主张证据的作用
证据（来源归属）

生成多种格式的引用，并导出到文献管理器。

uv run python scripts/evidence.py bibtex "2301.00001"
uv run python scripts/evidence.py apa "2301.00001"
uv run python scripts/evidence.py ris "2301.00001"           # For Zotero/Mendeley/EndNote
uv run python scripts/evidence.py batch "id1,id2,id3" --format bibtex > refs.bib
uv run python scripts/evidence.py batch "id1,id2" --format ris > refs.ris

格式：bibtex、apa、ieee、acm、chicago、ris

TikZ（图表提取）

从 arXiv 论文的 LaTeX 源文件中提取 TikZ 源代码。支持 tikzpicture、tikzcd、circuitikz 和 pgfplots 环境。可捕获标题、标签和库依赖项。

uv run python scripts/tikz.py extract "2301.00001"                          # Pure TikZ code
uv run python scripts/tikz.py extract "2301.00001" --format latex > fig.tex  # Compilable LaTeX
uv run python scripts/tikz.py extract "2301.00001,2302.00002" --format json  # Batch as JSON
uv run python scripts/tikz.py list "2301.00001"                              # Summary only

输出格式：tikz（默认）、latex、json、brief

工作流模式

多步骤操作指南（文献综述、为某项主张寻找证据）：参见 references/workflows.md。

API 依赖项

服务用途速率限制API 密钥
arXiv论文搜索、内容1 req/3s否
Semantic Scholar引用、相似论文100 req/5min可选（更高限额）
Jina Reader全文提取宽松否

脚本会强制在每项服务的请求之间固定延迟。失败时不会自动重试——遇到 429 或网络错误时，将返回空结果，而不是重试。

错误处理

  • 速率受限：请求会失败并返回空结果，不会重试；请稍后重新运行
  • 未找到论文：请确认 arXiv ID 格式（YYMM.NNNNN）
  • 没有引用：论文可能太新，Semantic Scholar 尚未收录

文件结构

arxiv-research-skill/
├── SKILL.md              # Agent instructions
├── README.md             # Installation and overview
├── references/
│   └── workflows.md      # Multi-step workflow recipes
└── scripts/
    ├── connect.py        # Knowledge navigation
    ├── understand.py     # Analysis prompts
    ├── evidence.py       # Citation generation
    ├── tikz.py           # TikZ figure extraction
    ├── cache.py          # SQLite caching (~/.cache/arxiv-research/papers.db)
    └── utils.py          # Shared utilities (extractPaperId, cleanText)

评论

支持 Markdown