パースパイプラインを自作せず、エージェントからドキュメントを変換。
JustMarkdown はエージェントワークフロー向けの非同期変換 API を公開しています。ドキュメントごとに1ジョブを送信し、完了までポーリングして Markdown をダウンロード——さらに同期型の Markdown → PDF エンドポイントも用意。独自の OCR や PDF 解析パイプラインを構築する必要はありません。
APIキーはリモートMCPエンドポイント /api/mcp でのみ使用されます。/api/jobs はセッションまたはゲストCookieを使用します。
# One request in, one job out curl -X POST https://justmarkdown.com/api/jobs \ -F "files=@paper.pdf" \ -F "formatSlug=pdf-to-markdown" \ -F "mode=single" # → 200 OK { "job": { "id": "job_a1b2c3d4", "status": "queued", "results": [], "zipDownloadUrl": null } }
1つのリクエストで1つのジョブを出力。
ドキュメントを送信、ステータスをポーリング、結果をダウンロード——それが全体のループです。
ドキュメントごとに1ジョブ
ファイルを /api/jobs に POST し formatSlug と mode を指定。ジョブIDとポーリングURLを取得。
完了までポーリング
GET /api/jobs/{jobId} でステータス確認。status が "completed" になると results のダウンロードURLが利用可能に。
完成後にダウンロード
/api/jobs/{jobId}/artifact からMarkdownを取得。完了後24時間ファイルが利用可能。
7つのエンドポイント、それだけです。
同期 Markdown → PDF
JSON(markdown + theme + pageSize)を送信、PDFバイナリを直接返します。認証不要、単発レンダリングに最適。
非同期ジョブを送信
Multipartアップロード(files + formatSlug + mode)。ジョブオブジェクトとポーリングURLを返します。セッションまたはゲストCookieとCloudflare認証が必要。スキャンOCRはログインが必要です。スキャンOCRは1ページ1クレジット(テキストPDFは無料)、音声は1分1クレジット。
ジョブステータスをポーリング
ジョブの status(queued / processing / completed / failed)と results ダウンロードリンクを返します。
成果物をダウンロード
fileId で個別Markdownをダウンロード、または type=zip でバッチZIP。完了後24時間利用可能。
SSEイベントストリーム
Server-Sent Events でステータス変更をリアルタイム推送 — ポーリング不要。completed または failed まで接続維持。
同期 Markdown → Word
Markdown(任意で template と images)を送信し、.docx ドキュメントを直接受け取ります。
リモート MCP エンドポイント
Streamable HTTP の MCP エンドポイント。convert_url、convert_base64 などのツールを Claude、Cursor などから直接利用できます。アカウントキーは1回の変換につき定額1クレジット。
MCPツールとして使用。
同じAPIをModel Context Protocolツールとして提供。Claude、Cursor、任意のMCP互換エージェントに直接接続。
// claude_desktop_config.json — remote, nothing to install, documents → Markdown { "mcpServers": { "justmarkdown": { "type": "http", "url": "https://justmarkdown.com/api/mcp", // Optional: omit for the anonymous free tier (a few conversions per day). "headers": { "Authorization": "Bearer jm_live_…" } } } }
// claude_desktop_config.json — local stdio bridge to the remote tools { "mcpServers": { "justmarkdown": { "command": "npx", "args": ["-y", "justmarkdown"] } } }
APIでできること。
非同期ジョブキュー
送信後は放置し、必要時にポーリングするかSSEストリームを購読。ほとんどの文書は数秒で完了し、スキャンOCRは数分かかる場合があります。
Markdown → PDF
現在のレンダーターゲットは PDF。ブラウザ印刷CSSの自作不要。
MCP互換
同じAPIをModel Context Protocolツールとして提供。Claude、Cursor等のMCP互換エージェントに直接接続。
SSE進捗ストリーム
/api/jobs/{jobId}/events を購読してポーリングなしでステータス変化をリアルタイム取得。
APIキー認証(MCP)
APIキー(Authorization: Bearer または x-api-key)はリモートMCPエンドポイント /api/mcp 用です。ジョブAPIはセッションまたはゲストCookieを使用します。
エージェントオーケストレーション向け
エージェントワークフロー用の非同期変換API。長時間レンダリングがワーカーループをブロックしません。
開発者APIのよくある質問。
APIキーは必要ですか?
いいえ。APIキー(アカウント設定で作成)はリモートMCPエンドポイント /api/mcp でのみ使用されます。/api/jobs と /api/v1/convert はセッションまたはゲストCookieを使用します。
「ドキュメント → Markdown」の非同期APIはありますか?
はい。ファイルを /api/jobs にPOSTし、/api/jobs/{jobId} をポーリングするかSSEを購読し、/api/jobs/{jobId}/artifact からMarkdownをダウンロードします。
ClaudeやCursorから同じエンジンを呼べますか?
はい。同じエンジンはMCPツールとして提供されます。クライアントを /api/mcp リモートエンドポイントに向けてください。設定はMCPガイドを参照。