# HTML to Markdown MCP Server

Превращает веб-страницы в чистый Markdown, убирая скрипты, стили и навигацию. Пригодится, когда нужно скормить агенту статью или документацию без лишнего мусора.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: sunshad0w
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/sunshad0w/html2md-mcp
- Обновлён: 2025-11-01
- HTML: https://affpapa.org/nevibecode/mcp/html-to-markdown-mcp-server

## Что делает

Сервер забирает HTML по ссылке и отдаёт Markdown, в котором остаются таблицы, картинки и ссылки. Скрипты, стили, шапки и подвалы вырезаются, поэтому объём текста падает примерно на 90-95% — агенту проще уложиться в контекст. Внутри работают `trafilatura` и `BeautifulSoup4`, есть потоковая обработка и лимит на размер загрузки.

Для сайтов на React, Vue и Angular есть режим браузера через Playwright: он выполняет JavaScript и умеет ждать нужного состояния страницы. Там же можно подключить ваш профиль браузера с cookies, чтобы открыть страницы под логином. Для этого Chrome должен быть закрыт, иначе профиль не отдастся.

Ставится через Docker — образ уже содержит Chromium, отдельно ничего доустанавливать не нужно. Кэш по умолчанию выключен, его включают параметром `use_cache`, если одну и ту же ссылку приходится тянуть повторно.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add html-to-markdown-mcp-server -- docker run -i --rm docker.io/sunshad0w/html2md-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add html-to-markdown-mcp-server -- docker run -i --rm docker.io/sunshad0w/html2md-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "html-to-markdown-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/sunshad0w/html2md-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "html-to-markdown-mcp-server": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/sunshad0w/html2md-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add html-to-markdown-mcp-server docker run -i --rm docker.io/sunshad0w/html2md-mcp
```

## Когда брать
- вытащить текст статьи из HTML без скриптов и рекламы
- сохранить таблицы и картинки при конвертации в Markdown
- прочитать страницу одностраничного приложения на React или Vue
- открыть закрытую страницу под своей сессией браузера
- ужать большой HTML до размера, который влезет в контекст

## Примеры запросов агенту
- Сконвертируй страницу `https://example.com/article` в Markdown через `html_to_markdown`
- Возьми `html_to_markdown`, поставь `include_images`: false и `include_tables`: true для `https://example.com/docs`
- Открой дашборд через `html_to_markdown` в режиме playwright с `use_user_profile`: true и `browser_type`: chromium

## Похожие
- [markdown-to-html](https://affpapa.org/nevibecode/skills/markdown-to-html.md) — скилл · 9899 установок
- [qiaomu-markdown-proxy](https://affpapa.org/nevibecode/skills/qiaomu-markdown-proxy.md) — скилл · 659 установок
- [baoyu-markdown-to-html](https://affpapa.org/nevibecode/skills/baoyu-markdown-to-html.md) — скилл · 32200 установок
- [canghe-markdown-to-html](https://affpapa.org/nevibecode/skills/canghe-markdown-to-html.md) — скилл · 532 установки
- [markdown-html-orchestrator](https://affpapa.org/nevibecode/skills/markdown-html-orchestrator.md) — скилл · 46 установок
- [markdown-html-skills](https://affpapa.org/nevibecode/plugins/markdown-html-skills.md) — плагин · ★ 28786

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md