本文へ移動
cccskills
無料GitHub で公開

html-to-markdown-using-the-mcp-server

Use when converting HTML to Markdown or extracting metadata and tables through the html-to-markdown MCP server's tools, rather than shelling out to the CLI. Covers the tool surface, the auto-installing launcher, and when MCP beats the CLI or SDK.

日本語の概要は準備中です。原文の説明を表示しています。

xberg-io/html-to-markdownスター 885(GitHub 885 + cccskills 0)

実行スコア 未検証

インストール方法を見る

含まれるファイル(8)

  • SKILL.md3.0 KB
  • index.md539 B
  • references/cli-reference.md18.5 KB
  • references/configuration.md18.8 KB
  • references/other-bindings.md12.3 KB
  • references/python-api.md8.0 KB
  • references/rust-api.md10.5 KB
  • references/typescript-api.md6.8 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

<!-- AI-RULEZ :: GENERATED FILE — DO NOT EDIT Content-Hash: blake3:3c429c4ad8d72a902e49ab130b4956fe0192d6f9ca57e586494fba0d84eb7fef Source-Hash: blake3:4237e14c4d547597faf915235dde5b5d71e8c9d84681d23919d03302b738a0b4 Schema-Version: v1 -->

Using the MCP Server

The html-to-markdown MCP server exposes the converter's conversion and metadata-extraction capabilities as MCP tools, so an MCP-compatible client (Claude Code, Claude Desktop) can convert HTML and pull structured metadata directly, with no CLI invocation or glue code.

Standalone skill installation

Installing this skill alone does not register an MCP server or include the plugin launcher. Install the CLI (for example, brew install xberg-io/tap/html-to-markdown), then configure your MCP client with html-to-markdown mcp as its stdio command. The full product plugin supplies registration where the runtime supports MCP.

How it runs in this plugin

The plugin auto-registers the server through its bundled MCP launcher, which execs html-to-markdown mcp. On first run the launcher resolves an html-to-markdown binary: it reuses one already on PATH or cached in the plugin's bin/, then tries npx/uvx, then Homebrew, then downloads a prebuilt from the tool's latest GitHub release. Override the channel with HTML_TO_MARKDOWN_LAUNCHER=auto|npx|uvx|brew|download.

The mcp subcommand ships in a recent release of the tool. If an older html-to-markdown is already on PATH, it may not expose mcp yet — upgrade the binary (brew upgrade, re-download, or rebuild) to pick it up.

To run it manually:

html-to-markdown mcp        # for Claude Code / Claude Desktop (stdio)

The tools

  • convert_html — convert an HTML string to Markdown, Djot, or plain text. Takes html (the HTML string), an optional config object mirroring ConversionOptions, and an optional json flag. With json: true it returns the full ConversionResult (content, tables, metadata, document structure, inline images, warnings) instead of the bare converted text.
  • extract_metadata — pull structured metadata (document info, Open Graph / Twitter / JSON-LD / Microdata, headers, links, images) from an HTML string. Takes only html.

Both tools accept an HTML string — the MCP server does not fetch URLs or read files (that is CLI-only). The exact argument schemas come from the running server; ask the client to list tools to see the live surface.

When to prefer MCP over the CLI or SDK

  • Prefer MCP inside an agent session: the agent calls the converter directly as a tool, with no shell-out and no process management.
  • Prefer the CLI for one-shot conversions and shell pipelines (… | jq).
  • Prefer the SDK when embedding conversion in application code.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

api

無料

Use html-to-markdown-rs api reference documentation.

日本語の概要は準備中です。原文の説明を表示しています。

xberg-io/html-to-markdown8852026年10月26日 更新

cli

無料

Use html-to-markdown-rs cli reference documentation.

日本語の概要は準備中です。原文の説明を表示しています。

xberg-io/html-to-markdown8852026年10月26日 更新

Convert HTML to Markdown, Djot, or plain text with structured extraction. Use when writing code that calls html-to-markdown APIs in Rust, Python, TypeScript, Go, Ruby, PHP, Java, C#, Elixir, R, C, or WASM. Covers installation, conversion, configuration, metadata extraction, tables, document structure, inline images, URL fetching, and CLI usage.

日本語の概要は準備中です。原文の説明を表示しています。

xberg-io/html-to-markdown8852026年10月26日 更新

Use when converting HTML to Markdown, Djot, or plain text. Covers output formats, heading and code-block styles, lists, escaping, wrapping, and HTML preprocessing.

日本語の概要は準備中です。原文の説明を表示しています。

xberg-io/html-to-markdown8852026年10月26日 更新

Use when extracting metadata from HTML — title, description, language, Open Graph, JSON-LD / Microdata / RDFa, headers, links, and images. Covers the --json output shape and the --extract-metadata flag.

日本語の概要は準備中です。原文の説明を表示しています。

xberg-io/html-to-markdown8852026年10月26日 更新

Use when extracting tabular data from HTML. Covers GFM Markdown tables, the structured tables array (grid cells plus pre-rendered markdown), and HTML line breaks in table cells.

日本語の概要は準備中です。原文の説明を表示しています。

xberg-io/html-to-markdown8852026年10月26日 更新

xberg-io のスキルをすべて見る

このスキルの問題を報告する