ricardodantas/skills / skills/podman-browser
podman-browser
VerifiedHeadless browser automation using Podman and Playwright (Chromium) to fetch and scrape JavaScript-rendered web pages as text or HTML. Use when a plain HTTP fetch returns empty or pre-render markup, when scraping single-page apps or dynamic/JS-rendered content, when you need to wait for a CSS selector or extra render time before capturing, or when asked to render a page headlessly and extract its content or raw HTML.
Podman Browser Skill
Headless browser automation using Podman + Playwright for scraping JavaScript-rendered pages.
Requirements
- Podman 5.x+ installed and running
- Node.js 18+ (for running the CLI)
- Internet connection (first run pulls ~1.5GB container image)
Installation
Create a symlink for easy access:
chmod +x browse.js
ln -sf "$(pwd)/browse.js" ~/.local/bin/podman-browse
First run will pull the Playwright container image (~1.5GB).
Commands
podman-browse (or ./browse.js)
Fetch a JavaScript-rendered page and return its text content.
podman-browse "https://example.com"
Options:
--html- Return raw HTML instead of text--wait <ms>- Wait for additional time after load (default: 2000ms)--selector <css>- Wait for specific element before capturing-h, --help- Show help
Examples:
# Get rendered text content from Hacker News
podman-browse "https://news.ycombinator.com"
# Get raw HTML
podman-browse --html "https://news.ycombinator.com"
# Wait for specific element
podman-browse --selector ".itemlist" "https://news.ycombinator.com"
# Extra wait time for slow pages
podman-browse --wait 5000 "https://news.ycombinator.com/newest"
How It Works
- Runs Microsoft's official Playwright container via Podman
- Uses Chromium in headless mode
- Waits for JavaScript to render (networkidle + custom wait)
- Returns text or HTML content
Container Image
Uses mcr.microsoft.com/playwright:v1.61.0-noble with playwright@1.61.0 npm package (versions must match).
To upgrade, bump both to any matching Playwright release: the image tag vX.Y.Z-noble and playwright@X.Y.Z must be the same version (set IMAGE and PLAYWRIGHT_VERSION in browse.js).
Files
browse.js- Self-contained Node.js CLI (handles args + spawns podman)SKILL.md- This documentation
Notes
- First run will pull the container image (~1.5GB)
- Uses
--ipc=hostfor Chromium stability - Uses
--initto handle zombie processes - Sandbox disabled when running as root (fine for trusted sites)
- Each run starts a fresh container (clean but takes ~10-15s)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |