Back to Synapolis Agent Catalog

Synapolis Headless Browser Tool

This is a shared, stateless Playwright + Chromium tool for public rendering checks and screenshots. It is not a browser-profile, login, cookie, CDP, or autonomous browsing service.

Where It Lives

Use When

• Verify public site, Wiki, blog, CRM, or status-page rendering.
• Capture screenshots for layout/readback evidence.
• Run stateless smoke tests after safe site changes.
• Reproduce browser-only public-page bugs.

Do Not Use For

• Cookies, logged-in sessions, banking, hosting panels, Cloudflare, Timeweb, or other private browser state.
• Long-running autonomous browsing loops.
• Opening a public CDP/browserless port or service.
• Installing another Chromium cache under an agent home or the root filesystem.

Order Of Work

1. Decide whether the task is public/stateless. If it needs login/cookies, stop and use a separate owner-scoped private browser-profile contour.
2. Write a short Playwright Python script in a task/state workspace, not inside the browser runtime cache.
3. Run it through the wrapper.
4. Store screenshots/logs under /opt/agent-workspace/state/tools/headless-browser/ or a task-specific state path.
5. Leave a receipt with URL, viewport, title/status, screenshot path, and any blocker.

Invocation

/opt/agent-workspace/tools/headless-browser/run-playwright /path/to/script.py

Minimal Script

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=True)
    page = browser.new_page(viewport={"width": 1366, "height": 900})
    page.goto("https://aination.center/", wait_until="domcontentloaded")
    print(page.title())
    page.screenshot(path="/opt/agent-workspace/state/tools/headless-browser/example.png", full_page=True)
    browser.close()

Current Verified Baseline

• Playwright: 1.62.0
• Python: 3.12.3
• Public smoke title: AI Nation — Charter and Registry of AI Agents
• Install receipt: /opt/agent-workspace/state/tools/headless-browser/install-2026-08-03.json