# Steel Documentation

> Steel is a cloud browser API for AI agents and developers.
> Use Steel to launch cloud browsers, scrape content, and automate web tasks.

## Quick Reference

- Install: `npm install steel-sdk` (Node.js) or `pip install steel-sdk` (Python)
- CLI: `curl -sSf https://setup.steel.dev | sh`
- Auth header: `steel-api-key: <your-key>`
- Auth env var: `STEEL_API_KEY`
- API base URL: `https://api.steel.dev`
- WebSocket: `wss://connect.steel.dev?apiKey=<key>&sessionId=<id>`
- API reference: https://steel.apidocumentation.com/api-reference

## Agent Instructions

- For the simplest one-liner scrape, use the CLI:
  ```bash
  steel scrape https://example.com
  ```
- For simple scraping without a browser session, use the REST scrape endpoint:
  ```
  curl -X POST https://api.steel.dev/v1/scrape \
    -H "steel-api-key: YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://example.com"}'
  ```
- For browser automation, connect Puppeteer or Playwright via WebSocket:
  ```js
  import Steel from 'steel-sdk';
  import puppeteer from 'puppeteer-core';

  const client = new Steel({ steelAPIKey: process.env.STEEL_API_KEY });
  const session = await client.sessions.create();
  const browser = await puppeteer.connect({
    browserWSEndpoint: `wss://connect.steel.dev?apiKey=${process.env.STEEL_API_KEY}&sessionId=${session.id}`,
  });
  // ... use browser ...
  await browser.close();
  await client.sessions.release(session.id);
  ```
- Python SDK:
  ```python
  from steel import Steel
  client = Steel(steel_api_key="YOUR_KEY")  # or set STEEL_API_KEY env var
  result = client.scrape(url="https://example.com")
  print(result.content.html)
  ```
- Always release sessions when done: `client.sessions.release(sessionId)`
- Do NOT use `session.websocketUrl` directly — construct the WSS URL as shown above
- The Node SDK constructor param is `steelAPIKey` (not `apiKey`)
- The Python SDK constructor param is `steel_api_key` (not `api_key`)
- Individual doc pages are available as markdown by appending `.mdx` to any URL


## Pages

#### Changelog

- [changelog-000](https://docs.steel.dev/changelog/changelog-000.mdx)
- [changelog-001](https://docs.steel.dev/changelog/changelog-001.mdx)
- [changelog-002](https://docs.steel.dev/changelog/changelog-002.mdx)
- [changelog-003](https://docs.steel.dev/changelog/changelog-003.mdx)
- [changelog-004](https://docs.steel.dev/changelog/changelog-004.mdx)
- [changelog-005](https://docs.steel.dev/changelog/changelog-005.mdx)
- [changelog-006](https://docs.steel.dev/changelog/changelog-006.mdx)
- [changelog-007](https://docs.steel.dev/changelog/changelog-007.mdx)
- [changelog-008](https://docs.steel.dev/changelog/changelog-008.mdx)
- [changelog-009](https://docs.steel.dev/changelog/changelog-009.mdx)
- [changelog-010](https://docs.steel.dev/changelog/changelog-010.mdx)
- [changelog-011](https://docs.steel.dev/changelog/changelog-011.mdx)
- [changelog-012](https://docs.steel.dev/changelog/changelog-012.mdx)
- [changelog-013](https://docs.steel.dev/changelog/changelog-013.mdx)
- [changelog-014](https://docs.steel.dev/changelog/changelog-014.mdx)
- [changelog-015](https://docs.steel.dev/changelog/changelog-015.mdx)
- [changelog-016](https://docs.steel.dev/changelog/changelog-016.mdx)
- [changelog-017](https://docs.steel.dev/changelog/changelog-017.mdx)
- [changelog-018](https://docs.steel.dev/changelog/changelog-018.mdx)
- [changelog-019](https://docs.steel.dev/changelog/changelog-019.mdx)
- [changelog-020](https://docs.steel.dev/changelog/changelog-020.mdx)
- [changelog-021](https://docs.steel.dev/changelog/changelog-021.mdx)

#### Cookbook

- [auth-context-starter](https://docs.steel.dev/cookbook/auth-context-starter.mdx)
- [credentials-starter](https://docs.steel.dev/cookbook/credentials-starter.mdx)
- [extensions-starter](https://docs.steel.dev/cookbook/extensions-starter.mdx)
- [files-starter](https://docs.steel.dev/cookbook/files-starter.mdx)
- [playwright](https://docs.steel.dev/cookbook/playwright.mdx)
- [puppeteer](https://docs.steel.dev/cookbook/puppeteer.mdx)
- [selenium](https://docs.steel.dev/cookbook/selenium.mdx)
- [stagehand-py](https://docs.steel.dev/cookbook/stagehand-py.mdx)
- [stagehand-ts](https://docs.steel.dev/cookbook/stagehand-ts.mdx)

#### Integrations

- [agentkit-overview](https://docs.steel.dev/integrations/agentkit/agentkit-overview.mdx)
- [agno-overview](https://docs.steel.dev/integrations/agno/agno-overview.mdx)
- [captcha-solving](https://docs.steel.dev/integrations/browser-use/captcha-solving.mdx)
- [integrations-overview](https://docs.steel.dev/integrations/browser-use/integrations-overview.mdx)
- [integrations-overview](https://docs.steel.dev/integrations/claude-computer-use/integrations-overview.mdx)
- [integrations-overview](https://docs.steel.dev/integrations/crewai/integrations-overview.mdx)
- [overview](https://docs.steel.dev/integrations/gemini-computer-use/overview.mdx)
- [overview](https://docs.steel.dev/integrations/openai-computer-use/overview.mdx)
- [overview](https://docs.steel.dev/integrations/stagehand/overview.mdx)
- [overview](https://docs.steel.dev/integrations/valtown/overview.mdx)
- [quickstart](https://docs.steel.dev/integrations/agentkit/quickstart.mdx)
- [quickstart](https://docs.steel.dev/integrations/agno/quickstart.mdx)
- [quickstart](https://docs.steel.dev/integrations/browser-use/quickstart.mdx)
- [quickstart](https://docs.steel.dev/integrations/crewai/quickstart.mdx)
- [quickstart](https://docs.steel.dev/integrations/magnitude/quickstart.mdx)
- [quickstart](https://docs.steel.dev/integrations/notte/quickstart.mdx)
- [quickstart](https://docs.steel.dev/integrations/replit/quickstart.mdx)
- [quickstart](https://docs.steel.dev/integrations/stackblitz-bolt.new/quickstart.mdx)
- [quickstart](https://docs.steel.dev/integrations/valtown/quickstart.mdx)
- [quickstart-py](https://docs.steel.dev/integrations/claude-computer-use/quickstart-py.mdx)
- [quickstart-py](https://docs.steel.dev/integrations/gemini-computer-use/quickstart-py.mdx)
- [quickstart-py](https://docs.steel.dev/integrations/openai-computer-use/quickstart-py.mdx)
- [quickstart-py](https://docs.steel.dev/integrations/stagehand/quickstart-py.mdx)
- [quickstart-ts](https://docs.steel.dev/integrations/claude-computer-use/quickstart-ts.mdx)
- [quickstart-ts](https://docs.steel.dev/integrations/gemini-computer-use/quickstart-ts.mdx)
- [quickstart-ts](https://docs.steel.dev/integrations/openai-computer-use/quickstart-ts.mdx)
- [quickstart-ts](https://docs.steel.dev/integrations/stagehand/quickstart-ts.mdx)

#### Overview

- [overview](https://docs.steel.dev/overview/sessions-api/overview.mdx)
- [overview](https://docs.steel.dev/overview/profiles-api/overview.mdx)
- [overview](https://docs.steel.dev/overview/files-api/overview.mdx)
- [overview](https://docs.steel.dev/overview/extensions-api/overview.mdx)
- [overview](https://docs.steel.dev/overview/credentials-api/overview.mdx)
- [overview](https://docs.steel.dev/overview/captchas-api/overview.mdx)
- [captcha-solving](https://docs.steel.dev/overview/stealth/captcha-solving.mdx)
- [clustering](https://docs.steel.dev/overview/self-hosting/clustering.mdx)
- [docker](https://docs.steel.dev/overview/self-hosting/docker.mdx)
- [extensions](https://docs.steel.dev/overview/self-hosting/extensions.mdx)
- [human-in-the-loop](https://docs.steel.dev/overview/sessions-api/human-in-the-loop.mdx)
- [index](https://docs.steel.dev/overview/sessions-api/embed-sessions.mdx)
- [intro-to-steel](https://docs.steel.dev/overview/intro-to-steel.mdx)
- [legal](https://docs.steel.dev/overview/legal.mdx)
- [live-sessions](https://docs.steel.dev/overview/sessions-api/embed-sessions/live-sessions.mdx)
- [llms-full.txt](https://docs.steel.dev/overview/llms-full.txt.mdx)
- [mobile-mode](https://docs.steel.dev/overview/sessions-api/mobile-mode.mdx)
- [multi-region](https://docs.steel.dev/overview/sessions-api/multi-region.mdx)
- [need-help](https://docs.steel.dev/overview/need-help.mdx)
- [past-sessions](https://docs.steel.dev/overview/sessions-api/embed-sessions/past-sessions.mdx)
- [playwright-node](https://docs.steel.dev/overview/guides/playwright-node.mdx)
- [playwright-python](https://docs.steel.dev/overview/guides/playwright-python.mdx)
- [pricinglimits](https://docs.steel.dev/overview/pricinglimits.mdx)
- [profiles](https://docs.steel.dev/overview/self-hosting/profiles.mdx)
- [proxies](https://docs.steel.dev/overview/stealth/proxies.mdx)
- [puppeteer](https://docs.steel.dev/overview/guides/puppeteer.mdx)
- [quickstart](https://docs.steel.dev/overview/sessions-api/quickstart.mdx)
- [railway](https://docs.steel.dev/overview/self-hosting/railway.mdx)
- [render](https://docs.steel.dev/overview/self-hosting/render.mdx)
- [reusing-auth-context](https://docs.steel.dev/overview/sessions-api/reusing-auth-context.mdx)
- [selenium](https://docs.steel.dev/overview/guides/selenium.mdx)
- [session-lifecycle](https://docs.steel.dev/overview/sessions-api/session-lifecycle.mdx)
- [steel-cli](https://docs.steel.dev/overview/steel-cli.mdx)
- [steel-local-vs-steel-cloud](https://docs.steel.dev/overview/self-hosting/steel-local-vs-steel-cloud.mdx)
- [webrtc](https://docs.steel.dev/overview/self-hosting/webrtc.mdx)