browser-reaper/README.md

A Node.js educational utility for extracting saved passwords and credit card information from Chromium-based browsers on macOS.

# Browser Reaper

Browser Reaper is an educational Node.js utility designed to extract saved passwords and credit card information from Chromium-based browsers on macOS. This tool is intended for educational purposes only and should not be used for malicious activities.

## Features

- Extract saved passwords and credit card information.
- Supports multiple Chromium-based browsers (e.g., Chrome, Brave, Edge Opera, Vivaldi, etc.).
- Outputs data in a structured format for easy consumption.

## Installation

```bash
npm install browser-reaper
```

## Usage

```javascript
import BrowserReaper from 'browser-reaper';

async function run() {
    const extractor = new BrowserReaper('chrome'); // Replace 'chrome' with your browser of choice
    const data = await extractor.extractData();
    console.log(JSON.stringify(data, null, 2));
}

run();
```

## Supported Browsers

- Chrome (`chrome`)
- Brave (`brave`)
- Edge (`edge`)
- Opera (`opera`)
- Vivaldi (`vivaldi`)
- Chromium (`chromium`)
- Chrome Canary (`chromeCanary`)

## Output Example

```json
{
  "ProfileName": {
    "accounts": [
      {
        "link": "http://example.com",
        "user": "user@example.com",
        "pass": "password123"
      }
    ],
    "cards": [
      {
        "cardType": "Visa",
        "cardName": "John Doe",
        "cardNumber": "4111111111111111",
        "expiration": "12/2025"
      }
    ]
  }
}
```

## Disclaimer

This tool is for **educational purposes only**. Unauthorized use of this tool to access or extract data without permission is illegal and unethical. Use responsibly.

## License

This project is licensed under the [MIT License](./LICENSE).