osaurus-browser

Category: Tools & Productivity | Uploader: osaurus-ai | Downloads: 0 | Version: v1.0（Latest）

Teaches the agent how to use the headless browser tools effectively — workflows, element refs, batching, and detail levels.

Changelog: Source: GitHub https://github.com/osaurus-ai/osaurus-tools

Directory Structure

Current level: tree/master/tools/browser/

📁 Sources/
- 📁 OsaurusBrowser/
  - 📄 Plugin.swift 88.9 KB
📁 Tests/
- 📁 OsaurusBrowserTests/
  - 📁 Fixtures/
    
    📄 interactive-elements.html 3.7 KB
    
    📄 login-form.html 3.2 KB
  - 📄 ActionSnapshotTests.swift 4.4 KB
  - 📄 BatchDoTests.swift 7.3 KB
  - 📄 BrowserTestCase.swift 2.9 KB
  - 📄 EndToEndTests.swift 5.4 KB
  - 📄 FormatSnapshotTests.swift 7.7 KB
  - 📄 ManifestTests.swift 3.5 KB
  - 📄 NavigateTests.swift 2.5 KB
  - 📄 WebKitSmokeTest.swift 553 B
📄 Package.swift 718 B
📄 SKILL.md 3.3 KB

SKILL.md

---
name: osaurus-browser
description: Teaches the agent how to use the headless browser tools effectively — workflows, element refs, batching, and detail levels.
metadata:
  author: Osaurus
  version: "1.2.0"
---

# Osaurus Browser

Headless browser automation via element refs. Every action returns a page snapshot automatically — you rarely need to call `browser_snapshot` separately.

## Typical Flow (2 calls)

```
1. browser_navigate(url)             → snapshot with refs [E1] [E2] [E3]
2. browser_do([type E1, type E2, click E3]) → snapshot of result page
```

## Key Concepts

**Element refs** — `browser_navigate` and all actions return refs like `[E1] input`, `[E2] button "Submit"`. Use these refs in subsequent calls.

**Detail levels** — Every tool accepts `detail` to control snapshot verbosity:

- `none` — action result only, no snapshot (~10 tokens)
- `compact` — single-line refs, default for actions (~200 tokens)
- `standard` — multi-line with attributes, default for `browser_snapshot` (~500 tokens)
- `full` — all attributes + IDs + aria-labels + page text excerpt (~1000+ tokens)

Use `compact` (default) for speed. Use `full` when you need to identify elements by ID or aria-label on complex pages.

## Tools

### browser_navigate

Navigate and get initial page snapshot.

```json
{ "url": "https://example.com", "detail": "compact" }
```

Use `wait_until: "networkidle"` for SPAs.

### browser_do

**Primary interaction tool.** Batch multiple actions in one call. All refs from the previous snapshot stay valid throughout the batch.

```json
{
  "actions": [
    { "action": "type", "ref": "E1", "text": "user@example.com" },
    { "action": "type", "ref": "E2", "text": "password123" },
    { "action": "click", "ref": "E3" }
  ],
  "detail": "compact"
}
```

Supported actions: `click`, `type`, `select`, `hover`, `scroll`, `press_key`, `wait_for`.

If an action fails, execution stops and the response includes: which action failed (index), the error, and a snapshot of current state for recovery.

Use `wait_after: "domstable"` or `"networkidle"` when the last action triggers async content.

### browser_click / browser_type / browser_select / browser_hover / browser_scroll

Individual action tools — each returns a snapshot automatically. Prefer `browser_do` when performing 2+ actions in sequence.

### browser_snapshot

Re-inspect the page without acting. Usually not needed since actions auto-return snapshots. Use when you need to re-check after `browser_wait_for` or `browser_execute_script`.

### browser_press_key

Press keyboard keys: `Enter`, `Escape`, `Tab`, arrow keys, or characters with modifiers.

### browser_wait_for

Wait for text to appear, disappear, or a specified time.

### browser_screenshot

Visual debugging — saves a PNG. Use `full_page: true` for the entire scrollable page.

### browser_execute_script

Escape hatch for arbitrary JavaScript.

## Tips

- Always start with `browser_navigate` — it gives you the refs you need.
- Batch with `browser_do` to minimize round-trips. A login flow is just navigate + browser_do.
- Use `detail: "none"` for intermediate actions where you already know the next step.
- If refs go stale (page changed unexpectedly), call `browser_snapshot` to get fresh ones.
- For SPAs, use `wait_until: "networkidle"` on navigate, or `wait_after: "domstable"` on browser_do.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

osaurus-browser

Directory Structure

SKILL.md

Report

Notice