Browser Session Export

Browser Session Export v2.0.0

Debug browser sessions by exporting cookies and local storage.

Quick Start

To extract data from browser SQLite databases, use:

from scripts.browser_exporter import extract_sqlite_data

# Extract data from a browser database file
data = extract_sqlite_data("/path/to/Cookies")
print(data)

That's it! The extract_sqlite_data() function reads SQLite databases and returns structured data.

Why Use This Skill?

✅ SQLite Expertise: Handles browser database formats automatically
✅ Multi-Browser Support: Works with Chrome, Firefox, and other browser databases
✅ Safe Read-Only Operations: Reads data without modifying browser profiles
✅ Cross-Platform: Works on macOS, Linux, and Windows

Architecture

browser-session-export/
├── SKILL.md
└── scripts/
    └── browser_exporter.py# Core export implementation

Core Functions

extract_sqlite_data(db_path)

Helper function for reading SQLite databases. Safely extracts all table data from a database file.

Parameters:

• db_path (str): Path to the SQLite database file

Returns:

• dict: Dictionary with table names as keys and row data as values

Example:

from scripts.browser_exporter import extract_sqlite_data

# Read Chrome cookies database
cookies = extract_sqlite_data("~/.config/google-chrome/Default/Cookies")

# Read Firefox cookies
firefox_cookies = extract_sqlite_data("~/.mozilla/firefox/profile/cookies.sqlite")

Supported Browsers

Common Browser Database Paths

Chrome

• macOS: ~/Library/Application Support/Google/Chrome/Default/
• Linux: ~/.config/google-chrome/Default/
• Windows: %LOCALAPPDATA%/Google/Chrome/User Data/Default/

Firefox

• macOS/Linux: ~/.mozilla/firefox/<profile>/
• Windows: %APPDATA%/Mozilla/Firefox/Profiles/<profile>/

How It Works

1. Locate Database: Find the browser's profile directory
2. Extract Data: Use extract_sqlite_data() to read the database
3. Process Results: The function returns structured data ready for analysis

Note: Browser databases may be locked when the browser is running. Consider copying the database file to a temporary location before reading.

Prerequisites

• Python 3.8+ with sqlite3 module
• Read access to browser profile directories

Full Example

import os
from scripts.browser_exporter import extract_sqlite_data

# Define Chrome profile path (Linux)
chrome_base = os.path.expanduser("~/.config/google-chrome/Default/")

# List of databases to extract
databases = ["Cookies", "Login Data", "History"]

for db_name in databases:
    db_path = os.path.join(chrome_base, db_name)
    if os.path.exists(db_path):
        data = extract_sqlite_data(db_path)
        if data:
            print(f"✅ Extracted {db_name}: {len(data)} tables")
            for table, rows in data.items():
                print(f"   - {table}: {len(rows)} rows")
        else:
            print(f"❌ Failed to read {db_name}")
    else:
        print(f"⚠️ {db_name} not found")

API Reference

For complete function signatures and advanced usage, see scripts/browser_exporter.py.

Your debugging companion for browser sessions