rtrvr CLI & SDK

One CLI, three execution modes. Browser automation for AI agents and humans — across cloud, local browser extension, or auto-routed.

npm → @rtrvr-ai/cli GitHub

Cloud Mode

Run agents and scrape via rtrvr's managed cloud browsers.

Extension Mode

Route to your local browser extension for authenticated sessions.

Auto Mode

Smart routing with automatic fallback between cloud and extension.

CLI (global)

bash

npm install -g @rtrvr-ai/cli

Programmatic API

bash

curl https://api.rtrvr.ai/agent

The CLI provides the rtrvr command. Programmatic callers can use the HTTP API directly.

1Authenticate

bash

rtrvr auth login

2Run your first task

CLI

rtrvr run "Extract the top 10 products and prices" --url https://example.com

3Explore

bash

# Scrape a page
rtrvr scrape --url https://example.com

# Check your capabilities
rtrvr capabilities

# Run diagnostics
rtrvr doctor

Every command supports three execution targets. Use --target or the shortcut flags.

Cloud

--cloud

Managed browsers via api.rtrvr.ai. No local setup needed. Best for scraping, data extraction, and tasks that don't require your login sessions.

Extension

--extension

Route to your local browser via the rtrvr Chrome extension. Use for authenticated sessions (logged-in sites) and tasks that need your cookies/sessions.

Auto (default)

--target auto

Smart routing — checks if extension devices are online, tries extension first, falls back to cloud automatically. This is the default behavior.

Auto mode routing flow

rtrvr run "task"

Check for online extension devices

Found

Extension

Not found

Cloud

The response includes routing metadata showing which mode was selected and whether fallback was applied:

json

{
  "metadata": {
    "selectedMode": "cloud",
    "fallbackApplied": true,
    "fallbackReason": "no extension devices online"
  }
}

bash

# Positional input
rtrvr run "Find the latest pricing for each plan" --url https://example.com

# From file
rtrvr run --input-file ./task.txt --url https://example.com --target cloud

# From stdin
echo "Summarize this page" | rtrvr run --url https://example.com

<input>

Task description (positional argument)

--input <text>

Task description (flag alternative)

--input-file <path>

Read task description from a file

--url <url>

Target URL(s) for the agent

--target <mode>default: auto

Routing mode: auto, cloud, or extension

--cloud

Shortcut for --target cloud

--extension

Shortcut for --target extension

--device-id <id>

Target a specific browser extension device

--schema-file <path>

JSON schema file for structured output

--json

Machine-readable JSON output

--no-stream

Disable real-time progress streaming

Use the authenticated HTTP API directly for programmatic cloud runs.

Create a Run

cURL

curl -X POST https://api.rtrvr.ai/agent \
  -H "Authorization: Bearer $RTRVR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Find latest headline and author",
    "urls": ["https://example.com"],
    "target": "auto"
  }'

Client Options

apiKey

Your rtrvr API key (rtrvr_...)

defaultTargetdefault: auto

Default routing mode

baseUrldefault: https://api.rtrvr.ai

Override the API base URL

mcpUrldefault: https://mcp.rtrvr.ai

Override the MCP base URL

Unified Run

JSON body

{
  "input": "Find latest headline and author",
  "urls": ["https://example.com"],
  "target": "auto"
}

Direct Tool Calls

CLI

rtrvr raw extract_from_tab --user_input "Extract all product names and prices" --tab_urls '["https://example.com/products"]'
rtrvr raw act_on_tab --user_input "Click the Sign Up button" --tab_urls '["https://example.com"]'
rtrvr raw crawl_and_extract_from_tab --user_input "Find all blog post titles" --tab_urls '["https://example.com/blog"]'

Scrape

CLI

rtrvr scrape https://example.com

Utilities

CLI

rtrvr devices
rtrvr credits
rtrvr profile

Ready to automate from your terminal?

Install the rtrvr CLI and start running agents in seconds.

# Positional input rtrvr run "Find the latest pricing for each plan" --url https://example.com # From file rtrvr run --input-file ./task.txt --url https://example.com --target cloud # From stdin echo "Summarize this page" | rtrvr run --url https://example.com

curl -X POST https://api.rtrvr.ai/agent \ -H "Authorization: Bearer $RTRVR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": "Find latest headline and author", "urls": ["https://example.com"], "target": "auto" }'

rtrvr raw extract_from_tab --user_input "Extract all product names and prices" --tab_urls '["https://example.com/products"]' rtrvr raw act_on_tab --user_input "Click the Sign Up button" --tab_urls '["https://example.com"]' rtrvr raw crawl_and_extract_from_tab --user_input "Find all blog post titles" --tab_urls '["https://example.com/blog"]'

rtrvr CLI & SDK

Install

Quick Start

Execution Modes

CLI Commands Reference

HTTP API Reference

Create a Run

Client Options

Unified Run

Direct Tool Calls

Scrape

Utilities

Authentication

Configuration

MCP Integration

Skills System

Streaming & Events

Packages

Ready to automate from your terminal?

rtrvr CLI & SDK

Install

Quick Start

Execution Modes

CLI Commands Reference

HTTP API Reference

Create a Run

Client Options

Unified Run

Direct Tool Calls

Scrape

Utilities

Authentication

Configuration

MCP Integration

Skills System

Streaming & Events

Packages

Ready to automate from your terminal?

rtrvr CLI & SDK

Install

Quick Start

Execution Modes

CLI Commands Reference

HTTP API Reference

Create a Run

Client Options

Unified Run

Direct Tool Calls

Scrape

Utilities

Authentication

Configuration

MCP Integration

Skills System

Streaming & Events

Packages

Related Documentation

Ready to automate from your terminal?

rtrvr CLI & SDK

Install

Quick Start

Execution Modes

CLI Commands Reference

HTTP API Reference

Create a Run

Client Options

Unified Run

Direct Tool Calls

Scrape

Utilities

Authentication

Configuration

MCP Integration

Skills System

Streaming & Events

Packages

Related Documentation

Ready to automate from your terminal?