Skip to content

ricardodantas/skills / skills/podman-browser

podman-browser

Verified

Headless 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

  1. Runs Microsoft's official Playwright container via Podman
  2. Uses Chromium in headless mode
  3. Waits for JavaScript to render (networkidle + custom wait)
  4. 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=host for Chromium stability
  • Uses --init to handle zombie processes
  • Sandbox disabled when running as root (fine for trusted sites)
  • Each run starts a fresh container (clean but takes ~10-15s)
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall