> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.airtop.ai/guides/getting-started/quick-start/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.airtop.ai/_mcp/server.

# Quick Start

Welcome to Airtop! We're thrilled to guide you through connecting your AI Agent to the web using our powerful cloud browsers. In this quick-start guide, we'll walk you through:

* Setting up your project
* Creating a browser session
* Navigating the web
* Summarizing web pages using AI

By the end, you'll have created your browser session and summarized the page contents in just a few minutes. Let's get started!

### Step 1

Let's begin by installing the necessary packages. You'll need the Airtop SDK to interact with our service.

**`NodeJS (npm)`**

```bash NodeJS (npm)
npm i -s @airtop/sdk
```

**`NodeJS (yarn)`**

```bash NodeJS (yarn)
yarn add @airtop/sdk
```

**`NodeJS (pnpm)`**

```bash NodeJS (pnpm)
pnpm add @airtop/sdk
```

**`Python`**

```bash Python
pip install airtop
```

### Step 2

Get an API key from the [Airtop Developer Portal](https://portal.airtop.ai/api-keys).

> **Tip**
>
> You can create a **free** account if you don't already have one when you first log in.

### Step 3

Open up your favorite code editor and create a new file called `quickstart.js`. Create a new Airtop client.

**`NodeJS`**

```ts NodeJS
import { AirtopClient } from '@airtop/sdk';

const apiKey = 'YOUR_AIRTOP_API_KEY';
const client = new AirtopClient({ apiKey });
```

**`Python`**

```python Python
from airtop import Airtop

client = Airtop(api_key="YOUR_AIRTOP_API_KEY")
```

### Step 4

Create a new browser session.

**`NodeJS`**

```ts NodeJS
const session = await client.sessions.create();
```

**`Python`**

```python Python
session = client.sessions.create()
```

### Step 5

Create a new window, load a URL and get the window information.

**`NodeJS`**

```ts NodeJS
const window = await client.windows.create(session.data.id, { url: "https://www.airtop.ai" });
```

**`Python`**

```python Python
window = client.windows.create(session.data.id, url="https://www.airtop.ai")
```

### Step 6

Get the page content and summarize using AI.

**`NodeJS`**

```ts NodeJS
const contentSummary = await client.windows.pageQuery(session.data.id, window.data.windowId, {
  prompt: 'Summarize the contents of the page in 1 short paragraph up to 170 characters.',
});
console.log(contentSummary.data.modelResponse);

// Terminate the session when you're done
await client.sessions.terminate(session.data.id);
```

**`Python`**

```python Python
prompt = 'Summarize the contents of the page in 1 short paragraph up to 170 characters.'
content_summary = client.windows.page_query(session.data.id, window.data.window_id, prompt=prompt)
print(content_summary.data.model_response)

# Terminate the session when you're done
client.sessions.terminate(session.data.id)
```

### Step 7

In your terminal, run the following command:

**`NodeJS`**

```bash NodeJS
node quickstart.js
```

**`Python`**

```bash Python
python quickstart.py
```

Congratulations 🎉! You've just created your first browser session, navigated to the Airtop website and summarized the page contents using AI.

> Connect your AI Agent to the web in just 2 minutes