Overview

• Best on Outcrawl’s cloud. One line, browser: 'outcrawl', gives Scout a browser that sites treat like anyone at home, with captcha solving and a replay of every run. It also drives a local browser it launches for you, or any browser you already run over the DevTools protocol.
• Your models, one per job. Any endpoint that speaks the chat completions API: a hosted provider, a gateway, or a server on your own machine. There is no default model.
• An answer even when a run falls short. A run that hits a limit or cannot finish still returns what it found, and says what is missing.

import { Scout } from '@outcrawl/scout';

const scout = new Scout({
  browser: 'outcrawl',
  models: {
    hands: {
      model: 'your-model-id',
      baseURL: 'https://your-endpoint/v1',
      apiKey: process.env.SCOUT_API_KEY ?? '',
    },
  },
});

const result = await scout.run(
  'Find the top three stories on Hacker News right now',
);
console.log(result.data);
console.log(result.replayUrl); // watch the whole run

​

Scout or the hosted agent

• Scout runs in your own process, on Node 22 or later. You name a model for each job and pay your model endpoints directly. On Outcrawl’s cloud the browser session is billed in credits; on your own browser Outcrawl bills nothing.
• The hosted agent runs on Outcrawl’s side behind one API call, from the SDKs, the CLI or MCP. A run is billed in credits for model usage, browser time and proxy usage, and you read its status and results separately.