К основному содержанию
скилл CX Codex

web-to-markdown · softaworks — скилл для Claude Code: что делает и как установить

Скилл web-to-markdown для Claude Code преобразует веб-страницы с JavaScript в чистый Markdown через локальный браузер. Сохраняет статьи и документацию без лишней разметки.

MIT 796 установок ★ 2 707 обновлён 2026-03-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add softaworks/agent-toolkit --skill web-to-markdown -a claude-code
Открыть на GitHub

Что делает web-to-markdown

Скилл парсит веб-страницы через локальную утилиту web2md. Внутри связка Puppeteer и puppeteer-core запускает установленный браузер семейства Chromium (Chrome, Chromium, Brave или Edge), библиотека Readability вычищает разметку и выделяет основной текст, а Turndown собирает итоговый Markdown с очищенными ссылками.

Главное ограничение — строгий триггер запуска. Агент проигнорирует задачу, если в запросе нет фразы use the skill web-to-markdown или use a skill web-to-markdown.

Для работы в системе должна стоять утилита web2md, иначе конвертация завершится ошибкой проверки command -v web2md. Есть интерактивный режим --interactive с профилем --user-data-dir, чтобы пройти авторизацию или проверку вручную перед чтением разметки.

Какие задачи решает

  • сохранить статью с динамическим рендерингом в чистый Markdown
  • обойти экран входа или капчу в интерактивном окне браузера
  • вычистить навигацию и баннеры со страницы с помощью Readability
  • собрать несколько страниц в файлы с автоматическими именами

Примеры запросов агенту

  • use the skill web-to-markdown: сохрани страницу в файл ./page.md
  • use the skill web-to-markdown: выведи содержимое страницы в stdout
  • use the skill web-to-markdown: открой интерактивный режим с сессией в ./tmp/web2md-profile и сохрани страницу в ./out/

Как установить web-to-markdown

1Через Skills CLI (Vercel)

npx skills add softaworks/agent-toolkit --skill web-to-markdown -a claude-code

2Вручную: положить файлы

~/.claude/skills/web-to-markdown/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/web-to-markdown/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о web-to-markdown

Как установить web-to-markdown в Claude Code?

Выполните команду npx skills add softaworks/agent-toolkit --skill web-to-markdown -a claude-code в терминале.

Что делает скилл web-to-markdown?

Он вызывает консольную утилиту web2md, открывает страницу в Chromium через Puppeteer, извлекает полезный контент через Readability и формирует Markdown.

Почему скилл не запускается обычной просьбой?

В инструкциях заложен жёсткий фильтр активации. Чтобы агент выполнил действие, сообщение обязано содержать точную фразу use the skill web-to-markdown.

Исходный текст

SKILL.md · MIT
---
name: web-to-markdown
description: "Use ONLY when the user explicitly says: 'use the skill web-to-markdown ...' (or 'use a skill web-to-markdown ...'). Converts webpage URLs to clean Markdown by calling the local web2md CLI (Puppeteer + Readability), suitable for JS-rendered pages."
metadata:
  version: 0.1.0
---

# web-to-markdown

Convert web pages to clean Markdown by driving a locally installed browser (via `web2md`).

## Hard trigger gate (must enforce)

This skill MUST NOT be used unless the user explicitly wrote **exactly** a phrase like:
- `use the skill web-to-markdown ...`
- `use a skill web-to-markdown ...`

If the user did not explicitly request this skill by name, stop and ask them to re-issue the request including: `use the skill web-to-markdown`.

## What this skill does

- Handles JS-rendered pages (Puppeteer → user Chrome).
- Works best with Chromium-family browsers (Chrome/Chromium/Brave/Edge) via `puppeteer-core`.
- Extracts main content (Readability).
- Converts to Markdown (Turndown) with cleaned links and optional YAML frontmatter.

## Non-goals

- Do not use Playwright or other browser automation stacks; the mechanism is `web2md`.

## Inputs you should collect (ask only if missing)

- `url` (or a list of URLs)
- Output preference:
  - Print to stdout (`--print`), OR
  - Save to a file (`--out ./file.md`), OR
  - Save to a directory (`--out ./some-dir/` to auto-name by page title)
- Optional rendering controls for tricky pages:
  - `--chrome-path <path>` (if Chrome auto-detection fails)
  - `--interactive` (show Chrome and pause so the user can complete human checks/login, then press Enter)
  - `--wait-until load|domcontentloaded|networkidle0|networkidle2`
  - `--wait-for '<css selector>'`
  - `--wait-ms <milliseconds>`
  - `--headful` (debug)
  - `--no-sandbox` (sometimes required in containers/CI)
  - `--user-data-dir <dir>` (login/session; use a dedicated profile directory)

## Workflow

1) Confirm the user explicitly invoked the skill (`use the skill web-to-markdown`).
2) Validate URL(s) start with `http://` or `https://`.
3) Ensure `web2md` is installed:
   - Run: `command -v web2md`
   - If missing, instruct the user to install it (assume the project exists at `~/workspace/softaworks/projects/web2md`):
     - `cd ~/workspace/softaworks/projects/web2md && npm install && npm run build && npm link`
     - Or: `cd ~/workspace/softaworks/projects/web2md && npm install && npm run build && npm install -g .`
4) Convert:
   - Single URL → file:
     - `web2md '<url>' --out ./page.md`
   - Single URL → auto-named file in directory:
     - `mkdir -p ./out && web2md '<url>' --out ./out/`
   - Human verification / login walls (interactive):
     - `mkdir -p ./out && web2md '<url>' --interactive --user-data-dir ./tmp/web2md-profile --out ./out/`
     - Then: complete the check in the browser window and press Enter in the terminal to continue.
   - Print to stdout:
     - `web2md '<url>' --print`
   - Multiple URLs (batch):
     - Create output dir (e.g. `./out/`) then run one `web2md` command per URL using `--out ./out/`
5) Validate output:
   - If writing files, verify they exist and are non-empty (e.g. `ls -la <path>` and `wc -c <path>`).
6) Return:
   - The saved file path(s), or the Markdown (stdout mode).

## Defaults (recommended)

- For most pages: `--wait-until networkidle2`
- For heavy apps: start with `--wait-until domcontentloaded --wait-ms 2000`, then add `--wait-for 'main'` (or another stable selector) if needed.

© softaworks · MIT · softaworks/agent-toolkit

Похожие скиллы

Все скиллы по теме «Браузер и парсинг» →

Сначала — web-to-markdown от других авторов.

web-to-markdown rookie-ricardo Скилл web-to-markdown для Claude Code извлекает содержимое веб-страниц и возвращает его в Markdown. Читает статьи и транскрипты YouTube по ссылке. CX Codex +1 249установок baoyu-url-to-markdown JimLiu Скилл baoyu-url-to-markdown загружает веб-страницы через Chrome CDP и переводит контент в чистый Markdown. Включается при запросе на сохранение статей, веток обсуждений или расшифровок видео. CX Codex +1 31 000установок Web to Markdown jackwener Скилл Web to Markdown для Claude Code переводит веб-страницы в чистый Markdown через открытую вкладку. Запускается по запросу заархивировать, сохранить или прочитать страницу в виде текста. CX Codex +1 ★ 239звёзд репо Universal Screenshot MCP sethbang MCP-сервер Universal Screenshot MCP для захвата веб-страниц через Chromium и создания скриншотов рабочего стола на macOS, Linux и Windows. CX Codex +1 ★ 37звёзд репо anti-detect-browser antibrow Скилл anti-detect-browser для Claude Code запускает Chromium с подлинным отпечатком устройства через Playwright API. Профиль сохраняется между запусками для тестирования, скрейпинга и многоаккаунтной работы. CX Codex +1 168 800установок dev-browser SawyerHood Скилл dev-browser управляет настоящим Chrome с помощью коротких скриптов Puppeteer. Именованные страницы сохраняются между запусками, позволяя продолжить работу с того же места. CX Codex +1 2 600установок puppeteer-automation Mindrally Скилл puppeteer-automation для браузерной автоматизации на Puppeteer: навигация, клики, скриншоты, PDF и перехват сетевых запросов в headless Chrome. CX Codex +1 1 900установок

Из того же набора79

Весь набор →
feedback-mastery Скилл feedback-mastery структурирует подготовку к сложным разговорам и разбор рабочих конфликтов по моделям SBI и Preparation-Delivery-Follow-up. Помогает составить фактологический фидбек. CX Codex +1 4 000установок gemini Запускает Gemini CLI для ревью кода, анализа архитектуры и обработки контекста больше 200 тысяч токенов. CX Codex +1 4 000установок lesson-learned Скилл lesson-learned разбирает последние изменения в git-истории и формулирует инженерные уроки на основе реального кода. Пригодится, чтобы извлечь полезный опыт из недавних коммитов или рабочей ветки. CX Codex +1 3 000установок gepetto gepetto превращает Markdown-спецификацию в план реализации: изучает тему, уточняет требования у пользователя и отправляет план на внешнюю проверку. Запускайте его до начала сложной разработки. CX Codex +1 1 600установок communication-excellence-coach Субагент communication-excellence-coach разбирает черновики писем, калибрует тон общения и помогает отрепетировать сложные разговоры в режиме ролевой игры. CX Codex ★ 2 707звёзд репо sync-branch Синхронизирует фичу-ветку с последней версией main через rebase. Срабатывает по команде /sync-branch и обновляет PR через force-push. CX Codex +1 ★ 2 707звёзд репо compose-email Команда compose-email для составления профессиональных писем по методу What-Why-How. Задаёшь контекст — получаешь готовый черновик с правильной структурой, тоном и call-to-action. CX Codex +1 ★ 2 707звёзд репо viral-tweet Команда viral-tweet превращает черновую идею в пост для сети X с расчётом на метрики вовлечения алгоритма рекомендаций. CX Codex +1 ★ 2 707звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой