website-screenshot

# Website Screenshot

Capture screenshots of any website or web page. Useful for documentation, monitoring, and visual records.

## When to Use

- User asks for a screenshot of a website
- User wants to see what a site looks like
- Documenting web pages
- Monitoring website changes
- Creating visual records

## How It Works

Uses Notte or Brand.dev APIs to capture website screenshots.

## Usage

### Screenshot with Notte

```bash
# First start a session, then screenshot
orth run notte /sessions/start -d '{"url":"https://stripe.com"}'
# Then take screenshot with the session_id
orth run notte /sessions/{session_id}/page/screenshot
```

### Screenshot with Brand.dev (simpler)

```bash
orth run brand-dev /v1/brand/screenshot --query 'domain=stripe.com'
```

### Scrape and Screenshot with Notte

```bash
orth run notte /scrape -d '{"url":"https://example.com"}'
```

## Parameters

### Notte Session
- **url** (required) - Full URL to navigate to

### Brand.dev
- **domain** (required) - Website domain

## Response

### Brand.dev Response
Returns screenshot URL:
- **status** (string) - `ok` on success
- **domain** (string) - Domain that was screenshotted
- **screenshot** (string) - Public URL to the screenshot image (PNG)
- **screenshotType** (string) - `viewport` (above-the-fold) or `full_page`
- **code** (integer) - HTTP status code

### Notte Response
Returns page content + session:
- **markdown** (string) - Page content as markdown text
- **images** (array|null) - Extracted images (if any)
- **structured** (object|null) - Structured data (if extraction was requested)
- **session.session_id** (string) - Session ID for follow-up actions
- **session.status** (string) - `active` while session is open
- **session.credit_usage** (integer) - Credits consumed

To take an explicit screenshot via Notte session:
```bash
orth run notte /sessions/{session_id}/page/screenshot
```

## Examples

**User:** "Take a screenshot of Notion's homepage"
```bash
orth run brand-dev /v1/brand/screenshot --query 'domain=notion.so'
```

**User:** "Capture what vercel.com looks like"
```bash
orth run brand-dev /v1/brand/screenshot --query 'domain=vercel.com'
```

**User:** "Screenshot and scrape the content from this article"
```bash
orth run notte /scrape -d '{"url":"https://example.com/article"}'
```

## Error Handling

- **400** - Missing required parameter (`domain` for Brand.dev, `url` for Notte)
- **404** - Domain not found or page doesn't exist
- **504** - Page took too long to load — retry or try simpler URL
- Brand.dev only screenshots the homepage (pass domain, not full URL)
- Notte sessions auto-expire after `idle_timeout_minutes` (default 3) — take screenshots promptly

## Tips

- Brand.dev is simpler for quick homepage screenshots
- Notte is more powerful for full page control
- For pages requiring login, use Notte sessions with authentication
- Screenshots are typically full-page or viewport-sized
- Some sites may block automated screenshots