km-browser-abstraction

Browser Abstraction Layer

Unified interface for web content extraction across browser providers

---

Provider Selection

function get_browser_provider() {
  // 1. Check environment first
  if (is_antigravity_environment()) {
    return "antigravity"  // Use native browser agent
  }

  // 2. Fall back to config
  config = Read("km-config.json")
  return config?.browser?.provider || "playwright"
}

function is_antigravity_environment() {
  // Antigravity provides built-in browser capabilities
  // Check if running inside Antigravity IDE
  return typeof antigravity !== 'undefined' ||
         process.env.ANTIGRAVITY_SESSION ||
         file_exists("~/.gemini/antigravity/")
}

---

Provider Comparison

Feature	Antigravity Native	Playwright	Hyperbrowser
Setup required	None (built-in)	MCP server	MCP + API key
Simple scraping	Natural language	navigate → snapshot	scrape_webpage
Stealth mode	Built-in	Not supported	useStealth: true
Social media	Excellent	May be blocked	Good
Cost	Free (with Antigravity)	Free	API key required
Authentication	Session-aware	Limited	Profile support

---

Unified Scraping Function

function scrape_url(url, options = {}) {
  provider = get_browser_provider()

  switch (provider) {
    case "antigravity":
      // Antigravity has built-in browser agent
      // Simply ask it to fetch and analyze the page
      return antigravity_browser_fetch(url, options)

    case "hyperbrowser":
      return mcp__hyperbrowser__scrape_webpage({
        url: url,
        outputFormat: ["markdown"],
        sessionOptions: {
          useStealth: options.stealth || false
        }
      })

    case "playwright":
    default:
      mcp__playwright__browser_navigate({ url: url })
      mcp__playwright__browser_wait_for({ time: 3 })
      return mcp__playwright__browser_snapshot()
  }
}