MCPcopy Create free account
hub / github.com/link2004/pdf2md

github.com/link2004/pdf2md @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
49 symbols 121 edges 21 files ⚖ MIT 4 documented · 8% 2 cross-repo links updated 5mo ago★ 107

Browse by type

Functions 47 Types & classes 2
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

PDF to Markdown

このアプリケーションは、PDF ファイルをアップロードし、Mistral AI の OCR 機能を使って内容を解析するためのツールです。

Mistral AI API キーの取得

  1. Mistral AIにアクセスしてアカウントを作成またはログインします
  2. ダッシュボードから API キーを生成します
  3. 生成された API キーを安全に保管してください

Vercel Blob の設定

アプリケーションをデプロイする前に、Vercel Blob ストレージを設定する必要があります:

  1. Vercel プロジェクトを作成する

  2. Vercel にアクセスしてサインアップ/ログイン

  3. 「New Project」をクリックして新しいプロジェクトを作成

  4. Vercel Blob ストアを作成する

  5. プロジェクトダッシュボードの「Storage」タブを選択

  6. 「Connect Database」ボタンをクリック
  7. 「Create New」タブで「Blob」を選択し、「Continue」ボタンをクリック
  8. 以下の設定を行います:
    • 名前:任意の名前(例:「PDF Storage」)
    • 「Create a new Blob store」を選択
    • 環境変数を追加したい環境を選択(通常は全ての環境)
    • 必要に応じて「Advanced Options」で環境変数のプレフィックスを変更可能
  9. 「Create」ボタンをクリックしてストアを作成

  10. 環境変数の設定

  11. Blob ストアが作成されると、自動的に以下の環境変数がプロジェクトに追加されます:

    • BLOB_READ_WRITE_TOKEN
  12. ローカル開発環境でこの環境変数を使用するには、Vercel CLI を使って環境変数をプルします: bash vercel env pull

これらの設定が完了したら、アプリケーションのデプロイに進むことができます。

Vercel へのデプロイ手順

このアプリケーションを Vercel にデプロイするには、以下の手順に従ってください:

  1. リポジトリをクローンする

bash git clone https://github.com/link2004/pdf2md.git cd pdf2md

  1. .env.example ファイルをコピーする

bash cp .env.example .env

  1. .env ファイルに必要な環境変数を設定する

  2. Vercel ダッシュボードからBLOB_READ_WRITE_TOKENを取得し設定

  3. Mistral AI のアカウントからMISTRAL_API_KEYを取得し設定

MISTRAL_API_KEY=your_mistral_api_key BLOB_READ_WRITE_TOKEN=your_blob_read_write_token

  1. Vercel にデプロイする

  2. Vercelにログインまたはアカウント作成

  3. 「New Project」をクリック
  4. GitHub からリポジトリをインポート
  5. 「Environment Variables」セクションで、.envファイルと同じ環境変数を追加
  6. 「Deploy」ボタンをクリック

  7. デプロイの確認

  8. デプロイが完了したら、表示される URL にアクセスしてアプリケーションが正常に動作していることを確認

注意: 環境変数は機密情報を含むため、.envファイルは GitHub などの公開リポジトリにコミットしないでください。代わりに、Vercel のダッシュボード上で直接環境変数を設定してください。

機能

  • PDF ファイルのアップロード
  • Vercel Blob ストレージへの PDF の保存
  • Mistral AI の OCR 機能を使用した PDF の解析
  • 解析結果の表示と編集
  • マークダウン形式でのエクスポート機能

環境設定

以下の環境変数を.env.localファイルに設定してください:

# Vercel Blob設定
BLOB_READ_WRITE_TOKEN=your_blob_read_write_token

# Mistral AI設定
MISTRAL_API_KEY=your_mistral_api_key

必要な環境

  • Node.js 18 以上
  • Vercel アカウント(Blob ストア設定済み)
  • Mistral AI のアカウントと API キー

インストール方法

# 依存関係のインストール
npm install

# 開発サーバーの起動
npm run dev

技術スタック

  • Next.js
  • TypeScript
  • Vercel Blob(ストレージ)
  • Mistral AI(OCR 処理)
  • TailwindCSS(スタイリング)
  • React Markdown(マークダウンレンダリング)

トラブルシューティング

  • PDF のアップロードができない場合

  • ファイルサイズが 20MB 以下であることを確認してください(サーバーアップロードの場合)

  • ブラウザのキャッシュをクリアしてみてください

  • 解析が失敗する場合

  • PDF が暗号化されていないか確認してください

  • スキャンされた PDF の場合、画像品質が十分かチェックしてください

  • API エラーが表示される場合

  • 環境変数が正しく設定されているか確認してください
  • Mistral API キーの有効期限や利用制限を確認してください
  • Vercel Blob トークンが有効であることを確認してください

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細はLICENSEファイルをご覧ください。

Extension points exported contracts — how you extend this code

browse all types & interfaces →

Core symbols most depended-on inside this repo

browse all functions →

Shape

Function 47
Interface 2

Languages

TypeScript100%

Modules by API surface

app/[lang]/page.tsx13 symbols
app/lib/i18n.ts6 symbols
app/action/s3.ts5 symbols
app/lib/metadata.ts4 symbols
app/components/OcrResultView.tsx3 symbols
app/action/mistral.ts3 symbols
app/[lang]/layout.tsx3 symbols
middleware.ts2 symbols
app/components/Header.tsx2 symbols
app/action/downloadHelper.ts2 symbols
app/sitemap.ts1 symbols
app/robots.ts1 symbols

Used by 2 indexed graphs manifest dependencies, hub-wide

For agents

$ claude mcp add pdf2md \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page