rtrvr.ai
Log inBook DemoAdd to Chrome
Log in
Menu
Add to ChromeBook a demo
DocsChrome / Cloud / API / MCP
Search docs⌘ K
Quick startAPIMCP

RUN

Run from anywhere.

Start browser jobs from your terminal, CI, or another agent. Choose Cloud, the Chrome browser on your device, or let rtrvr route the job.
Install from npmOpen on GitHub
01

Cloud

Run away from your laptop in a managed browser.

02

Chrome

Use the signed-in browser already on your device.

03

Auto

Use Chrome when it is available and Cloud when it is not.

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

Pick where the browser should run. Use --target, or keep Auto when the same job should work across environments.

01--cloud

Cloud

Run in a managed browser away from your device. Best for public pages, scheduled jobs, and unattended work.

02--extension

Chrome

Use the signed-in Chrome browser on your device. Best for private apps, SSO, and internal tools.

03--target auto

Auto (default)

Use Chrome when it is available; fall back to Cloud when it is not. Best for portable jobs.

Auto routing

rtrvr run "task"
Chrome onlineRun in Chrome
No deviceRun in 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

YOUR NEXT RUN

Run from anywhere.

Install the CLI to start jobs from your terminal, CI, or another agent.