Quick Start

Get Rover running on your site in under 2 minutes.

Prerequisite: Rover requires an active rtrvr.ai account with available credits. Free accounts get 250 credits. Check your balance in the Workspace or upgrade at rtrvr.ai.

Create a Site Key

Go to the Rover Workspace and create a site key. You'll specify your allowed domains and get back an API key and a ready-to-paste install snippet. Choose capability profile if you want the same key to support cloud scrape/agent APIs in addition to embed usage.

If you enable tools.web.scrapeMode: 'on_demand', use the workspace profile that includes cloud capabilities.

No workspace access yet? Sign in with Google at the workspace to get started. Each key is scoped to specific domains — Rover will refuse to run on unlisted hosts.

Add the Embed Script

Include the Rover embed script before your closing </body> tag:

HTML

<script src="https://rover.rtrvr.ai/embed.js" async></script>

Boot Rover

Call rover('boot', config) with your site key credentials:

JavaScript

<script>
  (function(){ var r = window.rover = window.rover || function(){ (r.q = r.q || []).push(arguments); }; r.l = +new Date(); })();
  rover('boot', {
    siteId: 'your-site-id',
    apiKey: 'rtrvr_your_api_key_here',
    siteKeyId: 'your-key-id',
    allowedDomains: ['yourdomain.com'],
    domainScopeMode: 'registrable_domain',
    externalNavigationPolicy: 'open_new_tab_notice',
    taskRouting: { mode: 'act', plannerOnActError: true },
    checkpointing: { enabled: true, autoVisitorId: true },
    // Optional: external page context + custom branding
    tools: { web: { enableExternalWebContext: true, scrapeMode: 'on_demand', allowDomains: ['google.com'] } },
    ui: { agent: { name: 'Support Copilot' } },
  });
</script>

Replace the placeholder values with the credentials from your workspace. See Configuration for all available options.

Complete Snippet

HTML — paste before </body>

<!-- Add before </body> -->
<script>
  (function(){ var r = window.rover = window.rover || function(){ (r.q = r.q || []).push(arguments); }; r.l = +new Date(); })();
  rover('boot', {
    siteId: 'your-site-id',
    apiKey: 'rtrvr_your_api_key_here',
    siteKeyId: 'your-key-id',
    allowedDomains: ['yourdomain.com'],
    domainScopeMode: 'registrable_domain',
    externalNavigationPolicy: 'open_new_tab_notice',
    taskRouting: { mode: 'act', plannerOnActError: true },
    checkpointing: { enabled: true, autoVisitorId: true },
    tools: { web: { enableExternalWebContext: true, scrapeMode: 'on_demand', allowDomains: ['google.com'] } },
    ui: { agent: { name: 'Support Copilot' } },
  });
</script>
<script src="https://rover.rtrvr.ai/embed.js" async></script>

What Happens Next

Rover loads asynchronously — zero impact on page performance.

It reads your live DOM to understand the page structure.

A chat widget appears (or you can trigger it programmatically).

Users describe what they want; Rover clicks, fills, and navigates for them.

Configuration Reference Security & Policies