Quickstart

Get a Skyvern API key, install the Python or TypeScript SDK, run a browser task from code or cURL, and watch the run in the Skyvern app.

This page takes you from zero to a finished run in Skyvern Cloud. You send Skyvern a prompt and a URL, Skyvern runs a cloud browser, and you get structured output back.

Prefer to build without code? Start with the app quickstart. Using Claude Code, Cursor or another coding agent? Skip to Hand it to your coding agent.

Get your API key

Sign in at app.skyvern.com, open Settings → API keys and copy the key.

Set it in your shell:

export SKYVERN_API_KEY="your-api-key"

Install the SDK

Python

pip install skyvern

The Python SDK supports Python 3.11, 3.12, 3.13 and 3.14. The plain skyvern package covers the REST API: running tasks and agents, reading runs, managing credentials. To drive a browser page from your own code, you also need the local extra; see Drive the browser from code.

Run your first task

A task is one prompt plus a starting URL. Skyvern opens a cloud browser, works toward the goal and returns the result. The SDK samples wait for the run to finish; the REST API returns immediately and you poll.

Python

import asyncio
import os

from skyvern import Skyvern


async def main():
    skyvern = Skyvern(api_key=os.environ["SKYVERN_API_KEY"])

    result = await skyvern.run_task(
        prompt="Get the title and points of the #1 post",
        url="https://news.ycombinator.com",
        data_extraction_schema={
            "type": "object",
            "properties": {
                "title": {"type": "string", "description": "Title of the top post"},
                "points": {"type": "integer", "description": "Points of the top post"},
            },
        },
        wait_for_completion=True,
    )

    print(f"Status: {result.status}")
    print(f"Output: {result.output}")
    print(f"View run: {result.app_url}")


asyncio.run(main())

When the run finishes, you get something like:

Status: completed
Output: {'title': 'Show HN: ...', 'points': 312}
View run: https://app.skyvern.com/runs/tsk_...

Run statuses:

• created, queued: waiting for a browser.
• running: the agent is working.
• paused: waiting on a person (agent runs with a human interaction step).
• completed: finished successfully.
• failed, terminated, timed_out, canceled: finished without success. Read failure_reason on the run.

wait_for_completion (Python) and waitForCompletion (TypeScript) poll for up to 30 minutes by default. Pass timeout in seconds to change that.

See the run in the app

Open the app_url from the output, or go to Agents → Runs in the app. Each run shows the browser recording, every step the agent took with its screenshot and reasoning, and the extracted output.

When a run does something unexpected, this page is the first place to look. See Runs and schedules for what each panel shows.

Drive the browser from code

run_task hands the whole goal to Skyvern. To control each step yourself, launch a cloud browser and work with its page. The page is a Playwright page with AI methods added: act, extract, validate and prompt.

In Python, these browser methods need the local extra, which adds Playwright. You need it even though the browser runs in Skyvern Cloud. The TypeScript package already includes Playwright.

pip install "skyvern[local]"

Python

import asyncio
import os

from skyvern import Skyvern


async def main():
    skyvern = Skyvern(api_key=os.environ["SKYVERN_API_KEY"])

    browser = await skyvern.launch_cloud_browser()
    try:
        page = await browser.get_working_page()
        await page.goto("https://news.ycombinator.com")

        title = await page.extract("Get the title of the #1 post")
        print(f"Extracted: {title}")
    finally:
        # Close the browser to end the cloud session.
        await browser.close()


asyncio.run(main())

When the browser launches, the SDK logs a Launched new cloud browser session line with a https://app.skyvern.com/browser-session/pbs_... link. Open it to watch the browser live while your script runs.

Browser automation covers the full page model: selectors with AI fallback, schemas, logins, downloads and tabs.

Hand it to your coding agent

Paste your API key into the box, then copy the prompt into Claude Code, Cursor, Codex or another coding agent. The agent installs the SDK, asks what you want to automate, writes the script and runs it.

To give the agent browser tools directly instead of writing SDK code, connect the MCP server.

Troubleshooting

Error: ... requires local embedded/browser support

You called a browser method (launch_cloud_browser, get_working_page, page.extract) with only the base package installed. Install the local extra:

pip install "skyvern[local]"

Python version errors

The SDK requires Python 3.11 to 3.14. Check with python3 --version. To install into an isolated environment instead, use pipx install "skyvern[local]".

401 or invalid API key

Copy the key again from Settings → API keys and check for stray spaces or newlines. If someone clicked Rotate API Key, the old key no longer works.

I want to run Skyvern on my own machine

Running against your own Skyvern server and a local browser is covered in Self-host. The SDK code stays the same; you point it at your server.

More fixes are in Troubleshooting.

Next

Browser automation

Selectors with AI fallback, schemas, logins, downloads and tabs.

MCP and coding agents

Give Claude Code, Cursor and other agents Skyvern’s browser tools.

Going to production

Webhooks, retries, proxies and cost control.