Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
ideacco avatar

Baoyu Url To Markdown

  • 16 installs
  • 12 repo stars
  • Updated March 4, 2026
  • ideacco/baoyu-skills-openclaw

baoyu-url-to-markdown is an agent skill that captures web pages as markdown via Chrome CDP for research and repurposing.

About

baoyu-url-to-markdown is an agent skill that turns live web pages into markdown files using Chrome and the DevTools Protocol. Solo builders use it when they need trustworthy text from JS-heavy sites—competitor landings, API docs, blog posts—without hand-copying or brittle curl scrapes. The implementation centers on a CDP WebSocket client, profile-aware browser launch, and fetch helpers with explicit timeouts so agents do not hang on network idle. It fits early journey work (research and audience discovery) and later reuse when you refresh docs or repurpose articles. Pair it with markdown-to-HTML or summarization skills when the goal is a publishable artifact rather than a raw capture. Expect filesystem and browser permissions because the skill drives a real browser profile on your machine.

  • Chrome DevTools Protocol client with timed fetch and session-aware CDP commands
  • Dedicated Chrome profile path resolution for repeatable crawls
  • Network-idle and CDP connect timeouts tuned for slow SPAs
  • Node child-process spawning for browser-driven extraction
  • Output suited for downstream markdown-to-HTML or agent summarization

Baoyu Url To Markdown by the numbers

  • 16 all-time installs (skills.sh)
  • Ranked #1,053 of 1,879 Documentation skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ideacco/baoyu-skills-openclaw --skill baoyu-url-to-markdown

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs16
repo stars12
Security audit2 / 3 scanners passed
Last updatedMarch 4, 2026
Repositoryideacco/baoyu-skills-openclaw

What it does

Fetch any public URL through a headless Chrome CDP session and save clean markdown for research, competitor briefs, or content pipelines.

Who is it for?

Best when you're archiving competitor pages, documentation, or long-form posts before analysis or content reuse.

Skip if: Sites that require authenticated sessions you have not configured in the Chrome profile, or workflows that only need API JSON without page rendering.

When should I use this skill?

You have one or more public URLs and need markdown files produced via Chrome CDP rather than manual copy or plain HTTP.

What you get

You get a saved markdown capture of the target URL that agents can summarize, diff, or pass into HTML or publishing workflows.

  • Markdown file(s) representing fetched page content
  • Optional local browser profile state for repeatable fetches

Files

SKILL.mdMarkdownGitHub ↗

URL to Markdown

Fetches any URL via Chrome CDP and converts HTML to clean markdown.

Script Directory

Important: All scripts are located in the scripts/ subdirectory of this skill.

Agent Execution Instructions: 1. Determine this SKILL.md file's directory path as SKILL_DIR 2. Script path = ${SKILL_DIR}/scripts/<script-name>.ts 3. Replace all ${SKILL_DIR} in this document with the actual path

Script Reference:

ScriptPurpose
scripts/main.tsCLI entry point for URL fetching

Preferences (EXTEND.md)

Use Bash to check EXTEND.md existence (priority order):

# Check project-level first
test -f .baoyu-skills/baoyu-url-to-markdown/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md" && echo "user"

┌────────────────────────────────────────────────────────┬───────────────────┐ │ Path │ Location │ ├────────────────────────────────────────────────────────┼───────────────────┤ │ .baoyu-skills/baoyu-url-to-markdown/EXTEND.md │ Project directory │ ├────────────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.baoyu-skills/baoyu-url-to-markdown/EXTEND.md │ User home │ └────────────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ Result │ Action │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Found │ Read, parse, apply settings │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ Not found │ Use defaults │ └───────────┴───────────────────────────────────────────────────────────────────────────┘

EXTEND.md Supports: Default output directory | Default capture mode | Timeout settings

Features

  • Chrome CDP for full JavaScript rendering
  • Two capture modes: auto or wait-for-user
  • Clean markdown output with metadata
  • Handles login-required pages via wait mode

Usage

# Auto mode (default) - capture when page loads
npx -y bun ${SKILL_DIR}/scripts/main.ts <url>

# Wait mode - wait for user signal before capture
npx -y bun ${SKILL_DIR}/scripts/main.ts <url> --wait

# Save to specific file
npx -y bun ${SKILL_DIR}/scripts/main.ts <url> -o output.md

Options

OptionDescription
<url>URL to fetch
-o <path>Output file path (default: auto-generated)
--waitWait for user signal before capturing
--timeout <ms>Page load timeout (default: 30000)

Capture Modes

ModeBehaviorUse When
Auto (default)Capture on network idlePublic pages, static content
Wait (--wait)User signals when readyLogin-required, lazy loading, paywalls

Wait mode workflow: 1. Run with --wait → script outputs "Press Enter when ready" 2. Ask user to confirm page is ready 3. Send newline to stdin to trigger capture

Output Format

YAML front matter with url, title, description, author, published, captured_at fields, followed by converted markdown content.

Output Directory

url-to-markdown/<domain>/<slug>.md
  • <slug>: From page title or URL path (kebab-case, 2-6 words)
  • Conflict resolution: Append timestamp <slug>-YYYYMMDD-HHMMSS.md

Environment Variables

VariableDescription
URL_CHROME_PATHCustom Chrome executable path
URL_DATA_DIRCustom data directory
URL_CHROME_PROFILE_DIRCustom Chrome profile directory

Troubleshooting: Chrome not found → set URL_CHROME_PATH. Timeout → increase --timeout. Complex pages → try --wait mode.

Extension Support

Custom configurations via EXTEND.md. See Preferences section for paths and supported options.

OpenClaw Migration Notes

  • Migration mode: OpenClaw native first
  • Preserved directories:
  • scripts: yes
  • references: no
  • prompts: no
  • External dependencies: bun, chrome
  • Risk level: medium
  • Environment variables (detected): HOME, URL_CHROME_PATH, URL_CHROME_PROFILE_DIR, URL_DATA_DIR
  • Config compatibility: keep original .baoyu-skills/<skill>/EXTEND.md behavior and add OpenClaw-compatible path in runtime wrappers when needed.

OpenClaw Preflight Checks

  • Confirm bun is available when script examples use npx -y bun ....
  • Confirm Chrome is installed and launchable for CDP/browser automation flows.

Detected env vars: HOME, URL_CHROME_PATH, URL_CHROME_PROFILE_DIR, URL_DATA_DIR

OpenClaw Failure Fallback

  • If runtime dependency is missing, stop execution and return exact install/setup command.
  • If browser automation fails, switch to manual/wait mode where available.

Related skills

How it compares

Browser-backed capture skill—not a static site generator or a generic curl scraper.

FAQ

Who is baoyu-url-to-markdown for?

Developers who research on the web and want agent-ready markdown from real browser renders, especially for JS-heavy marketing or docs sites.

When should I use baoyu-url-to-markdown?

During Idea research to snapshot competitors, in Build when ingesting external docs, or in Grow when refreshing source articles—whenever you need durable markdown from a URL.

Is baoyu-url-to-markdown safe to install?

Review the Security Audits panel on this Prism page and treat browser automation as high trust: it can load arbitrary URLs and write files locally.

Documentationworkflownotes

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.