> ## Documentation Index
> Fetch the complete documentation index at: https://docs.browser-use.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Easiest way to automate the web. Tell this agent in natural language what it should do, and it can interact with the web like a human.

The SDK is a thin wrapper around the [API v3 Reference](/cloud/api-reference). Every endpoint in the API reference is available as an SDK method — `client.sessions`, `client.browsers`, `client.profiles`, `client.workspaces`, and `client.billing`.

`client.run()` creates a session, polls every 2 seconds until completion (up to 4 hours), and returns the result. It accepts all parameters from the [Create Session](/cloud/api-v3/sessions/create-session) endpoint. The result is a [Session object](/cloud/api-v3/sessions/get-session) — use `result.output` for the agent's response.

<CodeGroup>
  ```python Python theme={null}
  from browser_use_sdk.v3 import AsyncBrowserUse

  client = AsyncBrowserUse()
  result = await client.run("List the top 20 posts on Hacker News today with their points")
  print(result.output)
  ```

  ```typescript TypeScript theme={null}
  import { BrowserUse } from "browser-use-sdk/v3";

  const client = new BrowserUse();
  const result = await client.run("List the top 20 posts on Hacker News today with their points");
  console.log(result.output);
  ```

  ```bash curl theme={null}
  curl -X POST https://api.browser-use.com/api/v3/sessions \
    -H "X-Browser-Use-API-Key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"task": "List the top 20 posts on Hacker News today with their points"}'
  ```
</CodeGroup>

**What this agent can do:**

* **Data extraction** — scrape websites with thousands of listings
* **Form filling** — submit applications, fill out surveys, enter data
* **Multi-step workflows** — log in, navigate, click through flows, download files
* **Research** — search across multiple sites, compare results, summarize findings
* **Monitoring** — monitor a website and get notified if something changes
* **Testing** — test websites end-to-end with natural language instructions
* **Scheduling** — schedule tasks to run on a recurring basis
* **1,000+ integrations** — Gmail, Calendar, Notion, and more

The best SOTA browser agent — see our [online Mind2Web benchmark](https://browser-use.com/posts/online-mind2web-benchmark).

If you are an LLM, read/include [docs.browser-use.com/llms-full.txt](https://docs.browser-use.com/llms-full.txt) — it contains the complete SDK reference with all code examples in a single file optimized for LLMs.
