cookie-sync

Sync cookies from local Chrome to a Browserbase persistent context.

3.7k|235|Updated Oct 12, 2025
One-click install
npx skills add https://github.com/browserbase/skills --skill cookie-sync-browserbase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cookie-sync
Source: https://github.com/browserbase/skills/tree/main/skills/cookie-sync
Command: npx skills add https://github.com/browserbase/skills --skill cookie-sync-browserbase

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @browserbasehq/stagehand, @browserbasehq/sdk, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill solves the problem of manually syncing cookies between local Chrome and a Browserbase persistent context, allowing for seamless browsing and access to authenticated sites.

Core Features & Use Cases

  • Cookie Syncing: Automatically syncs cookies from local Chrome to a Browserbase context.
  • Context Reuse: Reuses existing contexts without re-syncing cookies.
  • Domain Filtering: Allows users to sync only specific domains' cookies.
  • Verified Browser Mode: Supports Browserbase Identity and Verified browser for improved access on protected sites.
  • Residential Proxy: Routes through a residential proxy to match the user's geolocation for authentication purposes.
  • Use Case: If you need to browse as yourself, sync cookies, or log into sites via Browserbase, this skill simplifies the process by automating the cookie synchronization.

Quick Start

Sync all cookies to a new context: node scripts/cookie-sync.mjs

Frequently Asked Questions about cookie-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync local Chrome cookies to a Browserbase persistent context?

Sync local Chrome cookies to a Browserbase persistent context by running the cookie-sync script, which automates transferring authentication data for seamless browsing. It requires Stagehand and the Browserbase SDK to establish browser connections and execute API calls.

Can I sync cookies for only specific domains to Browserbase?

Yes, you can sync cookies for only specific domains using the domain filtering feature. This allows you to selectively transfer local Chrome authentication data to your Browserbase persistent context instead of syncing all cookies globally.

How does cookie sync handle context reuse without re-authenticating?

Cookie sync handles context reuse by allowing you to reuse existing Browserbase persistent contexts without re-syncing cookies. This skips the local Chrome transfer step, letting you resume authenticated browsing sessions directly through the Browserbase SDK.

Do I need a residential proxy to authenticate sites via Browserbase?

You need a residential proxy if you want to route Browserbase traffic to match your local geolocation for authentication. This integrates with verified browser mode to improve access to protected sites that restrict logins by IP location.

Does Browserbase verified browser mode work with synced local cookies?

Yes, Browserbase verified browser mode works with synced local cookies to provide improved access on protected sites. It combines your local Chrome authentication state with Browserbase Identity verification for seamless browsing.

What are the limitations of syncing cookies from local Chrome to Browserbase?

A key limitation of syncing cookies from local Chrome to Browserbase is the dependency on Stagehand and the Browserbase SDK for browser connections. You must run the sync script locally, and context reuse is limited to existing Browserbase persistent contexts.