# Oculo

Automate complex web browsing tasks like navigation, form filling, and deep research across multiple tabs. Extract structured data and visual insights from any webpage instantly. Streamline digital w…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add xidik12/oculo

# Browse available tools
npx -y smithery tool list xidik12/oculo

# Get full schema for a tool
npx -y smithery tool get xidik12/oculo page

# Call a tool
npx -y smithery tool call xidik12/oculo page '{}'
```

## Direct MCP Connection

Endpoint: `https://oculo--xidik12.run.tools`

## Tools (12)

- `page` — Describe the current page in Oculo browser. Default: compact (~30-80 tokens). Use detail="a11y" for ref-tagged accessib…
- `act` — Perform an action in Oculo browser: click, navigate, scroll, press key, hover, type, login. Elements found by ref (from…
- `fill` — Fill form fields in Oculo browser by label, placeholder, or data-placeholder text. Handles text, select, checkbox, text…
- `read` — Extract structured data from the page in Oculo browser (search results, tables, lists, articles).
- `run` — Execute a multi-step pipeline in Oculo browser. PREFERRED for any task with 2+ actions. Each step is an object with exa…
- `media` — Generate images (Nano Banana / DALL-E 3) or videos (Veo 3.1) via Oculo browser.
- `shell` — Execute shell commands non-interactively via Oculo.
- `tabs` — List all open browser tabs in Oculo.
- `research` — Deep web research across multiple tabs via Oculo browser.
- `preview` — Pre-fetch URL without navigating in Oculo browser.
- `translate` — Translate page or text to any language via Oculo browser.
- `lens` — Visual analysis via screenshot in Oculo browser.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get xidik12/oculo <tool-name>
```
