mcpField
A
arxiv-reading

arxiv-reading

github.com/leo1oel生産性039 回インストール14 週間前に更新
リポジトリ

arxiv-reading について

arxiv-readingは、arXiv論文を数式、表、章立てを保ったMarkdownに変換して読むためのリサーチスキルです。必要な図の取得方法と、HTML変換できない場合の代替手順も説明します。

主な機能

  1. 01arxiv2mdによる論文のMarkdown変換
  2. 02LaTeX数式、表、章立ての保持
  3. 03必要な図アセットの取得と表示
  4. 04古い論文向けの代替手順

活用シーン

  1. 01PDFから始めずに論文本文を読む
  2. 02論文の重要な図を確認する
  3. 03arXiv HTMLがない論文を読む

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/leo1oel/leo-agent-skills --skill arxiv-reading

インストール後、Claude Code で/arxiv-readingを入力して読み込まれたか確認します。

詳細

arXiv 論文を読む

PDF ではなく、読みやすい Markdown で論文を読みます。 論文から何を抽出し、どう評価するかという判断には、research-taste スキルを使います。

読む前に変換する

arXiv の論文は、arXiv の構造化 HTML を解析し、数式を LaTeX のまま保持して、実際の表とセクションツリーも含めてくれる arxiv2md で Markdown に変換します。

uvx --from arxiv2markdown arxiv2md <id> -o paper.md

/abs/、/pdf/、/html/ の URL 形式では同じ ID が使われるため、PDF のリンクも使えます。ID だけを取り出してください。

図

arxiv2md はテキスト、数式、表を保持しますが、図はダウンロードしません。 各図は Markdown 内に Refer to caption: 2501.11120v1/x1.png のような機能しない行として表示されます。これは相対アセットパスであり、URL でも保存済みファイルでもありません。

図を実際に表示するには、そのパスを https://arxiv.org/html/ を基準に解決してアセットをダウンロードし、Read ツールで開きます(Read は画像を視覚的に表示します)。

curl -sL https://arxiv.org/html/2501.11120v1/x1.png -o fig1.png

次に Read で fig1.png を読み込みます。 論文の読み込みを arxiv2md 経由にする事前ツール使用フックでは、画像アセットのダウンロード(.png、.jpg、.svg など)は許可しつつ、HTML/PDF の論文を直接取得することは引き続きブロックします。そのため、HTML ページ全体ではなく、図を1ファイルずつ取得してください。 必要な図だけをダウンロードしてください。ほとんどの論文は、テキストと主要な図を数点読むだけで十分です。

フォールバック

arxiv2md で扱える HTML がない場合(arXiv がまだ HTML に変換していない古い論文)、次の順で試します。

  1. https://ar5iv.org/abs/<id> に対して、具体的な質問を指定して WebFetch を使います。ar5iv は、ほとんどの古い論文について LaTeX ソースから HTML を生成します。
  2. PDF は最後の手段としてのみ使用します。Read ツールで、全文を無差別に出力するのではなく、ページ範囲を指定して読みます。要旨だけで、それ以上読む価値がないと判断できる場合もよくあります。

コメント