mcpField
E
epub

epub

github.com/aliceisjustplayingドキュメント5232 回インストール45 週間前に更新
リポジトリ

epub について

EPUB を読み、内容を整った Markdown として抽出するスキルです。epub-reader CLI を使ったメタデータや目次の確認、章または全文の取得、テキスト検索を案内します。

主な機能

  1. 01書籍のメタデータを表示
  2. 02章と構成を一覧表示
  3. 03指定した章を抽出
  4. 04全編を Markdown に変換
  5. 05文脈付きでテキストを検索

活用シーン

  1. 01EPUB の出版情報を確認
  2. 02重点的に読む章を探す
  3. 03書籍全体を Markdown で確認
  4. 04章を横断してテーマを検索

インストール

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

$npx skills add https://github.com/aliceisjustplaying/claude-resources-monorepo --skill epub

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
AGENTS.md
README.md
scripts/epub-reader/
package-lock.json
package.json
tsconfig.json
scripts/epub-reader/src/
index.ts

詳細

EPUB Reader Skill

EPUB 電子書籍ファイルを読み込み、クリーンな Markdown としてコンテンツを抽出します。

手順

EPUB ファイルを操作するには、epub-reader CLI ツールを使用します。ツールの場所： ~/.claude/skills/epub/scripts/epub-reader/dist/index.js

使用可能なコマンド
1. メタデータを表示

書籍の情報（タイトル、著者、出版社、日付、説明）を取得します。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js metadata "<path-to-epub>"
2. 目次を一覧表示

すべての章とその構成を表示します。各項目には [ch: N] が表示され、chapter コマンドで使用する章番号を示します。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js toc "<path-to-epub>"
3. 特定の章を読む

章番号（1 から始まります）を指定して、1 つの章を読み込みます。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js chapter "<path-to-epub>" <chapter-number>
4. 書籍全体を読む

書籍全体を Markdown として抽出します。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js full "<path-to-epub>"
5. テキストを検索

前後の文脈とともに、テキストの出現箇所を検索します。

node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js search "<path-to-epub>" "<search-query>"

推奨ワークフロー

  1. まずメタデータを確認して、対象の書籍を把握します
  2. 目次を表示して、利用できる章と構成を確認します
  3. 特定の章を読むことで対象を絞って分析するか、完全に抽出するには full を使用します
  4. 検索を使用して、特定のトピック、引用、参照を探します

自由形式の検索

「この本の主なテーマは何ですか？」や「主人公の幼少期に関する言及をすべて探してください」のような幅広い質問や概念的な質問には、クエリの展開を使用します。

  1. クエリを展開し、専門知識を用いて具体的な検索語を複数作成します
    • 例：「主人公の幼少期」→ 登場人物の名前、「若い」「幼少期」「記憶」「父」「母」「育った」などを検索します
  2. 展開した各検索語について、並行して検索を実行します
  3. 検索結果を統合し、重複を除いて各検索結果の内容をまとめます

この方法では、Claude の専門知識を活用することで、単純なキーワード検索では見落としやすい類義語、関連する概念、用語のバリエーションを捉えられます。

例

ユーザーの質問：「著者の研究方法について、本には何と書かれていますか？」

検索語を展開します：

  • 「方法論」
  • 「研究」
  • 「調査」
  • 「分析」
  • 「データ」
  • 「調査結果」
  • 「証拠」

その後、検索結果をまとめて包括的な回答を作成します。

出力形式

すべての出力はクリーンな Markdown です：

  • 見出しは #、## などの形式で保持されます
  • リスト、リンク、強調は適切に変換されます
  • 過剰な空白は整理されます
  • 書籍全体を抽出する場合は章の区切りが含まれます

例

# What book is this?
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js metadata "/path/to/book.epub"

# Show me the chapters
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js toc "/path/to/book.epub"

# Read chapter 3
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js chapter "/path/to/book.epub" 3

# Find all mentions of "democracy"
node ~/.claude/skills/epub/scripts/epub-reader/dist/index.js search "/path/to/book.epub" "democracy"

注意事項

  • 章番号は 1 から始まります（最初の章は 0 ではなく 1 です）
  • TOC の出力にある [ch: N] を参照して、正しい章番号を確認してください
  • スペースを含むパスは引用符で囲む必要があります
  • full コマンドを使用すると、大きな書籍では出力が膨大になることがあります
  • 検索結果には、各章につき文脈とともに最大 5 件の一致箇所が表示されます

コメント

Markdown 対応