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

baoyu-url-to-markdown — скилл для Claude Code

Скилл baoyu-url-to-markdown загружает веб-страницы через Chrome CDP и переводит контент в чистый Markdown. Включается при запросе на сохранение статей, веток обсуждений или расшифровок видео.

MIT 31 000 установок ★ 27 783 обновлён 2026-11-06

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

Что делает baoyu-url-to-markdown

Скилл запускает CLI-утилиту baoyu-fetch, управляющую браузером через Chrome DevTools Protocol. Внутри встроены специализированные адаптеры под X, ветки Hacker News, расшифровки роликов с YouTube, а для остальных сайтов используется Defuddle. При сохранении агент формирует каталог вида {domain}/{slug}/, складывает туда документ и при флаге --download-media скачивает картинки и видео в отдельные папки с заменой ссылок.

Для работы скриптов в окружении обязательно требуется рантайм bun и установленный Chrome или Chromium. Интерактивные режимы ожидания выручают на закрытых страницах: флаг --wait-for interaction даёт пользователю до 10 минут на ручной ввод логина или прохождение капчи перед выгрузкой разметки.

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

  • сохранить статью с сайта в локальный Markdown-файл
  • выгрузить полную расшифровку видеоролика с YouTube
  • скопировать тред из X или ветку комментариев Hacker News
  • выкачать страницу вместе с иллюстрациями в локальную папку
  • обойти капчу или окно входа в интерактивном браузере

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

  • Сохрани эту статью в markdown вместе со всеми картинками
  • Выгрузи текстовую расшифровку из ролика на YouTube в отдельный файл
  • Скачай тред из X по ссылке и открой браузер, если появится капча

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

1Через Skills CLI (Vercel)

npx skills add JimLiu/baoyu-skills --skill baoyu-url-to-markdown -a claude-code

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

~/.claude/skills/baoyu-url-to-markdown/SKILL.md

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

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

Вопросы о baoyu-url-to-markdown

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

Выполните в терминале команду npx skills add JimLiu/baoyu-skills --skill baoyu-url-to-markdown -a claude-code. Скилл запишется в ~/.claude/skills/baoyu-url-to-markdown/SKILL.md.

Что делает этот скилл?

Он переводит содержимое веб-страниц в формат Markdown или JSON через браузерную автоматизацию Chrome CDP со специальной обработкой популярных площадок.

Что нужно подготовить перед запуском?

В системе должен быть установлен рантайм bun и браузер Chrome. Если Chrome лежит в нестандартном месте, путь к бинарнику передаётся через аргумент --browser-path.

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

SKILL.md · MIT
---
name: baoyu-url-to-markdown
description: Fetch any URL and convert to markdown using baoyu-fetch CLI (Chrome CDP with site-specific adapters). Built-in adapters for X/Twitter, YouTube transcripts, Hacker News threads, and generic pages via Defuddle. Handles login/CAPTCHA via interaction wait modes. Use when user wants to save a webpage as markdown.
version: 1.61.0
metadata:
  openclaw:
    homepage: https://github.com/JimLiu/baoyu-skills#baoyu-url-to-markdown
    requires:
      anyBins:
        - bun
---

# URL to Markdown

## User Input Tools

When this skill prompts the user, follow this tool-selection rule (priority order):

1. **Prefer built-in user-input tools** exposed by the current agent runtime — e.g., `AskUserQuestion`, `request_user_input`, `clarify`, `ask_user`, or any equivalent.
2. **Fallback**: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
3. **Batching**: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.

Concrete `AskUserQuestion` references below are examples — substitute the local equivalent in other runtimes.

## CLI Setup

The CLI source is vendored in `{baseDir}/scripts/lib`; `scripts/package.json` installs only third-party runtime dependencies.

1. `{baseDir}` = this SKILL.md's directory
2. `${BUN}` = `bun` if installed; otherwise suggest installing Bun
3. If `{baseDir}/scripts/node_modules` is missing: `${BUN} install --cwd {baseDir}/scripts`
4. `${READER}` = `{baseDir}/scripts/baoyu-fetch` (substitute everywhere below)

## Preferences (EXTEND.md)

First one found wins:

| Priority | Path | Scope |
|----------|------|-------|
| 1 | `.baoyu-skills/baoyu-url-to-markdown/EXTEND.md` | Project |
| 2 | `${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-url-to-markdown/EXTEND.md` | XDG |
| 3 | `$HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md` | User home |

Found → read and apply. Not found → **BLOCKING** first-time setup: ask the questions in [references/config/first-time-setup.md](references/config/first-time-setup.md) (Media, Output, Save — all in one call) before any conversion, write EXTEND.md, confirm "Preferences saved to [path]", then continue. Never create EXTEND.md with silent defaults.

| Key | Default | Values | CLI mapping |
|-----|---------|--------|-------------|
| `download_media` | `ask` | `ask` (prompt each time) / `1` (always) / `0` (never) | `1` → `--download-media` (requires `--output`) |
| `default_output_dir` | empty (= `./url-to-markdown/`) | path or empty | Agent builds `--output <dir>/{domain}/{slug}.md`; not a direct flag |

Value priority: CLI arguments → EXTEND.md → skill defaults.

## Usage

```bash
${READER} <url>                                          # headless, markdown to stdout
${READER} <url> --output article.md --download-media     # save with local media
${READER} <url> --wait-for interaction --output a.md     # login/CAPTCHA: auto-detect and continue
${READER} <url> --wait-for force --output a.md           # manual: Enter to continue
${READER} <url> --format json --output a.json
${READER} <url> --adapter youtube --output transcript.md
```

## Options

| Option | Description |
|--------|-------------|
| `<url>` | URL to fetch |
| `--output <path>` | Output file path (default: stdout) |
| `--format <type>` | `markdown` (default) or `json` |
| `--json` | Shorthand for `--format json` |
| `--adapter <name>` | Force adapter: `x`, `youtube`, `hn`, or `generic` (default: auto-detect) |
| `--headless` | Force headless Chrome |
| `--wait-for <mode>` | `none` (default), `interaction`, or `force` |
| `--wait-for-interaction` | Alias for `--wait-for interaction` |
| `--wait-for-login` | Alias for `--wait-for interaction` |
| `--timeout <ms>` | Page load timeout (default: 30000) |
| `--interaction-timeout <ms>` | Login/CAPTCHA wait timeout (default: 600000 = 10 min) |
| `--interaction-poll-interval <ms>` | Interaction poll interval (default: 1500) |
| `--download-media` | Download images/videos to local `imgs/` and `videos/`, rewrite links. Requires `--output` |
| `--media-dir <dir>` | Base directory for downloaded media (default: `--output` directory) |
| `--cdp-url <url>` | Reuse existing Chrome DevTools Protocol endpoint |
| `--browser-path <path>` | Custom Chrome/Chromium binary path |
| `--chrome-profile-dir <path>` | Chrome user data directory (default: `BAOYU_CHROME_PROFILE_DIR` env or `./baoyu-skills/chrome-profile`) |
| `--debug-dir <dir>` | Write debug artifacts (document.json, markdown.md, page.html, network.json) |

## Quality Gate

Headless capture is provisional: some sites silently return low-quality content with exit code `0`. Inspect the saved markdown after every headless run, using [references/quality-gate.md](references/quality-gate.md) for the checklist, recovery steps, and capture modes.

## Output Path

`baoyu-fetch` does not generate paths; the agent builds one and passes it to `--output`:

1. Base dir: EXTEND.md `default_output_dir` or `./url-to-markdown/`
2. Domain from URL (e.g., `example.com`)
3. Slug from URL path or page title (kebab-case, 2-6 words)
4. Path: `{base_dir}/{domain}/{slug}/{slug}.md` — one directory per URL so media stays isolated
5. On conflict: `{slug}-YYYYMMDD-HHMMSS/{slug}-YYYYMMDD-HHMMSS.md`

Downloaded media goes into subdirectories next to the markdown file.

## Adapters & Media

[references/adapters.md](references/adapters.md): adapter catalog (X, YouTube, Hacker News, generic), media download flow (`ask` / always / never), JSON output schema. Read it for adapter-specific questions or media prompts.

## Environment Variables

| Variable | Description |
|----------|-------------|
| `BAOYU_CHROME_PROFILE_DIR` | Chrome user data directory (or `--chrome-profile-dir`) |

**Troubleshooting**: Chrome not found → `--browser-path`. Timeout → raise `--timeout`. Login/CAPTCHA → `--wait-for interaction`. Debug → `--debug-dir` to inspect captured HTML and network logs.

## Extension Support

Custom configurations via EXTEND.md — see **Preferences** above.

© JimLiu · MIT · JimLiu/baoyu-skills

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

Все скиллы по теме «Браузер и парсинг» →
web-to-markdown softaworks Скилл web-to-markdown для Claude Code преобразует веб-страницы с JavaScript в чистый Markdown через локальный браузер. Сохраняет статьи и документацию без лишней разметки. CX Codex +1 796установок ru-marketplace-mcp Vladimir-Human MCP-сервер ru-marketplace-mcp для Claude Code и Codex. Читает цены, наличие, рейтинги, отзывы и реквизиты продавцов с российских и китайских маркетплейсов. Сравнивает товары по площадкам одним запросом. CX Codex +1 ★ 203звёзд репо qiaomu-markdown-proxy joeseesun Скилл qiaomu-markdown-proxy преобразует веб-страницы, статьи WeChat, документы Feishu и файлы PDF в чистый Markdown перед передачей текста другим агентам. CX Codex +1 663установок Web to Markdown jackwener Скилл Web to Markdown для Claude Code переводит веб-страницы в чистый Markdown через открытую вкладку. Запускается по запросу заархивировать, сохранить или прочитать страницу в виде текста. CX Codex +1 ★ 239звёзд репо gdoc-to-markdown iurykrieger Скилл gdoc-to-markdown преобразует Google Docs и Google Sheets в локальный Markdown-файл. Получает содержимое через MCP, Google API или извлечение из браузера, выбирая способ по доступности. CX Codex +1 ★ 111звёзд репо confluence-to-markdown iurykrieger Скилл confluence-to-markdown для Claude Code получает страницу Confluence и отдаёт её содержимое в Markdown. Работает в связке с командами /bedrock:learn и /bedrock:sync. CX Codex +1 ★ 111звёзд репо

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

Весь набор →
baoyu-markdown-to-html Скилл baoyu-markdown-to-html для Claude Code переводит Markdown в HTML с инлайн-CSS и темами под WeChat для публикации в мессенджере или на площадке со своим оформлением. CX Codex +1 32 900установок baoyu-article-illustrator Скилл baoyu-article-illustrator разбирает структуру статьи, находит смысловые блоки под визуализацию и генерирует серию иллюстраций. Запускается при запросе на иллюстрирование текста. CX Codex +1 32 700установок baoyu-slide-deck Скилл baoyu-slide-deck для Claude Code создаёт презентации как изображения: набрасывает структуру, затем рендерит слайды. Запускается по запросам «сделай слайды», «нарисуй презентацию» или slide deck. CX Codex +1 32 100установок baoyu-xhs-images Скилл baoyu-xhs-images превращает текст в серию карточек-инфографик с 12 стилями, 8 раскладками и 3 палитрами. Разбивает контент на 1–10 картинок для постов в соцсетях. CX Codex +1 32 100установок baoyu-comic Скилл baoyu-comic для Claude Code, Codex, Cursor и других агентов: создаёт многостраничные учебные комиксы по биографиям, инструкциям и темам из учебников. CX Codex +1 30 600установок baoyu-post-to-x Скилл baoyu-post-to-x публикует текст, картинки, видео и длинные статьи в X через браузер Chrome. Работает через плагин Codex, Computer Use или CDP-скрипты. CX Codex +1 29 500установок baoyu-format-markdown Скилл baoyu-format-markdown форматирует plain text и Markdown: добавляет структуру, frontmatter, заголовки, списки и код. Результат сохраняется в {filename}-formatted.md. CX Codex +1 28 800установок baoyu-compress-image Скилл baoyu-compress-image сжимает изображения в WebP или PNG через локальные утилиты. Вызывается по запросу сжать картинку или конвертировать графику в каталоге. CX Codex +1 28 800установок

Ещё в каталоге

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

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