docmark

docmark

docmark は、ホスト型のドキュメントから Markdown への変換サービス向けの、ローカルの stdio フロントエンドです。公開 URL、ファイルの base64 コンテンツ、またはいずれかを少数まとめたバッチを渡すと、ホスト型サービスに変換を依頼し、Markdown を返します。

docmark 自体は何も変換しません。各ツール呼び出しは JSON POST としてホスト型の file2markdown API に転送され、上流のペイロードがそのまま返されます。出力が 200,000 文字の上限に達したときの、サービスの truncated フラグも含まれます。変換品質、対応フォーマットの範囲、可用性、プランごとの制限は、ホスト型サービスに依存します。

ドキュメントに記載されている入力形式には、PDF、DOCX、PPTX、XLSX、CSV、JSON、XML、HTML、EPUB、画像（OCR 対応）、音声、ZIP アーカイブがあります。最新の一覧、プランごとの制限、Pro が必要な機能については、list_supported_formats を呼び出してください。

FILE2MARKDOWN_API_KEY は任意です。無料プランはキーなしで利用できます。キーが設定されている場合は Authorization: Bearer <key> として送信され、設定されていない場合は Authorization ヘッダーは送信されません。DOCMARK_API_URL を指定すると API ベース URL を上書きできます（デフォルトは https://api.file2markdown.ai。ワイヤー形式を再現したものです）。

バッチ変換では、1 回の呼び出しにつき 2〜10 件を指定します。送信前にローカルで検証されます。各項目は {url} または {content_base64, filename} のいずれかです。

インストール

npx @reneturcios/docmark convert_url --url https://example.com/report.pdf
docker run -i ghcr.io/cloudcorprecords/docmark

CLI

docmark convert_url --url https://example.com/report.pdf
docmark convert_base64 --content-base64 aGVsbG8= --filename note.txt
docmark convert_base64 --file ./report.pdf
docmark convert_batch --items-json '[{"url":"https://example.com/a.pdf"},{"content_base64":"eA==","filename":"x.txt"}]'
docmark list_supported_formats
docmark usage_status
docmark --version

終了コード：0 成功、1 上流または検証エラー、2 使用方法のエラー。

MCP サーバー

npx -y @reneturcios/docmark mcp

{
  "mcpServers": {
    "docmark": {
      "command": "npx",
      "args": ["-y", "@reneturcios/docmark", "mcp"],
      "env": { "FILE2MARKDOWN_API_KEY": "your-key-if-you-have-one" }
    }
  }
}

env ブロックは任意です。キーなしで利用できる無料プランでは省略してください。

ツール

ツール	入力	返される内容
convert_url	url（文字列、必須）	指定された URL のページまたはドキュメントを変換した上流の結果。
convert_base64	content_base64（文字列、必須）、filename（文字列、任意）	指定されたファイルコンテンツを変換した上流の結果。
convert_batch	items（配列、必須、2〜10 項目。各項目は {url} または {content_base64, filename}）	項目ごとの上流の結果。
list_supported_formats	—	サービスによるフォーマット、プランごとの制限、Pro が必要な機能。
usage_status	—	呼び出し元のプランと、今日利用できる残りの変換回数。

上流での失敗（HTTP エラーやホストに到達できない場合）は、元のメッセージを含むツールエラーとして報告されます。

開発

npm install
npm run build
npm test
npm run dev

テストはすべて fake-fetch フィクスチャを使用して実行されます。ネットワークは使用せず、ホスト型サービスへの実際の呼び出しも行いません。

ライセンス

MIT — LICENSE を参照してください。