arxiv-research

arXiv リサーチスキル

知識を構築するループを形成する4つの機能を通じて、体系的な学術研究を行います。

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

セットアップ

依存関係をインストールします：uv sync

機能

Connect（ナレッジナビゲーション）

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"

Understand（意味の抽出）

構造化されたプロンプトを使って論文の内容を分析します。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	主張を裏付ける証拠として評価

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リクエスト/3秒	不要
Semantic Scholar	引用、類似論文	100リクエスト/5分	任意（上限を引き上げる場合）
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)