@mherod/get-cookie NPM

get-cookie 🍪

Tired of manually copying cookies for API testing? get-cookie extracts authentication cookies directly from Chrome, Firefox, and Safari - perfect for testing, debugging, and automation.

Quick Start 🚀

# Install globally
pnpm add -g @mherod/get-cookie

# Get a cookie
get-cookie auth example.com

# Get all cookies for a domain
get-cookie % example.com

// Node.js usage
import { getCookie } from "@mherod/get-cookie";

const cookies = await getCookie({
  name: "auth",
  domain: "example.com",
});

⚠️ Platform Support:

Chrome: macOS only
Firefox: macOS and Linux
Safari: macOS only

Installation 📦

pnpm add @mherod/get-cookie    # recommended
npm install @mherod/get-cookie # or npm
yarn add @mherod/get-cookie    # or yarn

Common Use Cases 🎯

🔐 Get auth cookies for API testing
🔍 Debug cookie issues across browsers
🤖 Automate cookie extraction
🧪 Use real cookies in integration tests

Basic Usage Examples 💡

CLI

# Get specific cookie
get-cookie auth example.com

# Pretty print
get-cookie auth example.com --render

# From URL
get-cookie --url https://example.com/path

Node.js

import { getCookie, type CookieSpec } from "@mherod/get-cookie";

try {
  // Get specific cookie
  const authCookie = await getCookie({
    name: "auth",
    domain: "example.com",
  });

  // Get multiple cookies
  const cookies = await getCookie({
    name: "%", // all cookies
    domain: "example.com",
  });
} catch (error) {
  console.error("Failed:", error);
}

Features ✨

🌐 Multi-Browser Support:
- Chrome (macOS)
- Firefox (macOS, Linux)
- Safari (macOS)
🔒 Secure: Browser-specific encryption handling
📝 TypeScript Ready: Full type safety with exported type definitions
🎯 Flexible Querying: Search by name, domain, or use wildcards
🔄 Multiple Output Formats: JSON, rendered, or grouped results
👥 Profile Support: Chrome and Firefox multi-profile support

⚠️ Note: Platform support varies by browser. See our Platform Support Guide for details.

Output Formats 📊

The CLI supports various output formats:

# Default output (just values)
get-cookie auth example.com

# JSON output
get-cookie auth example.com --output json

# Rendered output (human-readable)
get-cookie auth example.com --render

# Grouped by browser/profile
get-cookie auth example.com --dump-grouped

Documentation 📚

Full docs at mherod.github.io/get-cookie

API Reference
Advanced Usage
TypeScript Types
Security Guide ⚠️

Contributing 🤝

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.