veil-browser 0.3.0 → 0.4.0

package/README.md

@@ -1,143 +1,195 @@
-# 🕶️ veil
+<div align="center">
 
-> Stealth browser CLI for AI agents — bypass bot detection, persist sessions, full web control.
+<img src="https://raw.githubusercontent.com/cuttlelab/veil/main/docs/logo.png" alt="veil" width="80" />
 
-Built for [OpenClaw](https://openclaw.ai) agents but works standalone. Playwright under the hood with stealth anti-detection baked in from day one.
+# veil
 
----
+**Stealth browser remote for AI agents.**
 
-## Features
+[![npm](https://img.shields.io/npm/v/veil-browser?color=000&style=flat-square)](https://www.npmjs.com/package/veil-browser)
+[![license](https://img.shields.io/badge/license-MIT-000?style=flat-square)](LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D18-000?style=flat-square)](https://nodejs.org)
 
-- 🥷 **Stealth by default** — powered by `playwright-extra` + `puppeteer-extra-plugin-stealth`
-- 🔐 **Persistent sessions** — log in once, use forever (saved to `~/.veil/sessions/`)
-- 👁️ **Interactive login mode** — opens a real visible browser for you to authenticate manually
-- 🤖 **Agent-friendly commands** — natural language actions, JSON output
-- 🌐 **Works everywhere** — X/Twitter, Reddit, LinkedIn, GitHub, Instagram, any site
+</div>
 
 ---
 
-## Install
+veil is a **headless browser CLI** built for AI agents. It runs a real, stealth Chromium browser and exposes every interaction as a simple command that returns clean JSON.
 
-```bash
-cd veil
-npm install
-npm run build
-npm link   # makes 'veil' available globally
-```
+You (or your agent) are the brain. veil is the hands.
 
-Or install Playwright browsers:
 ```bash
+npm install -g veil-browser
 npx playwright install chromium
+veil login x          # save your session once
+veil post "Hello, world from an AI agent."
 ```
 
 ---
 
-## Usage
+## Why veil
 
-### Login to a platform
+Most browser automation tools are built for developers writing scripts. veil is built for **AI agents making decisions in real-time** — where every step is a tool call, every result is parseable JSON, and the agent decides what to do next.
 
-```bash
-veil login twitter
-```
+- **No LLM inside** — veil is pure remote control. Your agent is the intelligence.
+- **Stealth by default** — hides automation signals, realistic user agent, human-like delays
+- **Persistent sessions** — log in once, reuse forever via saved cookies
+- **Every output is JSON** — `{ ok: true, ... }` or `{ ok: false, error: "..." }`
 
-Opens a visible Chromium browser. Log in normally (username, password, 2FA). Veil detects when you're on the home page and saves the session automatically.
+---
 
-### Post a tweet
+## Installation
 
 ```bash
-veil act "post tweet: Hello from veil 🕶️" --platform twitter
+npm install -g veil-browser
+npx playwright install chromium
 ```
 
-### Navigate headlessly
+---
+
+## Quick Start
 
 ```bash
-veil navigate https://x.com --platform twitter
+# Log in once (opens visible browser)
+veil login x
+
+# Post a tweet
+veil post "Building something new."
+
+# Like, reply, repost, quote
+veil like --nth 0
+veil reply "Great point." --nth 0
+veil repost --nth 1
+veil quote "Worth reading." --nth 2
+
+# Navigate and read any page
+veil go https://example.com
+veil snapshot          # DOM tree → understand the page
+veil read "h1"         # Extract specific elements
+veil find "Sign in"    # Check if text exists
+
+# Click, type, interact
+veil click "[data-testid='button']"
+veil type "input[name='q']" "search query"
+veil press Enter
+veil scroll down
+
+# Screenshot
+veil shot page.png
 ```
 
-### Extract data
+---
 
-```bash
-veil extract "tweets" --url https://x.com/home --platform twitter --json
-```
+## All Commands
 
-### Take a screenshot
+### Session
+| Command | Description |
+|---------|-------------|
+| `veil login <platform>` | Open visible browser → log in → save session |
+| `veil open <platform>` | Restore session and navigate to platform home |
+| `veil sessions` | List saved sessions |
+| `veil close` | Close browser |
 
-```bash
-veil screenshot --url https://x.com --platform twitter --output ./x-home.png
-```
+**Supported platforms:** `x`, `linkedin`, `reddit`, `bluesky` (or any URL)
 
-### List saved sessions
+### X / Social
+| Command | Description |
+|---------|-------------|
+| `veil post "text"` | Post a tweet |
+| `veil like --nth 0` | Like Nth post in feed |
+| `veil reply "text" --nth 0` | Reply to Nth post |
+| `veil repost --nth 0` | Repost Nth post |
+| `veil quote "text" --nth 0` | Quote Nth post with comment |
 
-```bash
-veil session list
-```
+### Navigation
+| Command | Description |
+|---------|-------------|
+| `veil go <url>` | Navigate to URL |
+| `veil url` | Get current URL and title |
+| `veil back` | Go back |
 
-### Remove a session
+### Reading
+| Command | Description |
+|---------|-------------|
+| `veil snapshot` | Full DOM tree (best for understanding page structure) |
+| `veil read [selector]` | Page text or element text |
+| `veil read <sel> --all` | All matches as array |
+| `veil read <sel> --attr href` | Read attribute value |
+| `veil find "text"` | Check if text exists on page |
+| `veil exists <selector>` | Check if selector exists |
+
+### Interaction
+| Command | Description |
+|---------|-------------|
+| `veil click <selector>` | Click element |
+| `veil click <sel> --force` | Force click (bypass overlays) |
+| `veil click <sel> --nth 2` | Click Nth match |
+| `veil type <selector> "text"` | Type into element |
+| `veil type <sel> "text" --clear` | Clear first, then type |
+| `veil press <key>` | Press key (Enter, Tab, Escape…) |
+| `veil scroll down\|up\|top\|bottom` | Scroll page |
+| `veil wait <ms>` | Wait N milliseconds |
+| `veil wait-for <selector>` | Wait until element appears |
+| `veil eval "script"` | Run JavaScript, returns result |
+
+### Screenshot
+| Command | Description |
+|---------|-------------|
+| `veil shot [file.png]` | Screenshot (full page with `--full`) |
+| `veil shot file.png --selector <sel>` | Screenshot specific element |
 
-```bash
-veil logout twitter
-```
+---
 
-### Status
+## For AI Agents (OpenClaw / MCP)
 
-```bash
-veil status
+veil ships with a `SKILL.md` that teaches OpenClaw exactly how to use it — all commands, all platform selectors, and complete task sequences.
+
+The agent pattern:
+```
+1. veil open x           → restore session
+2. veil snapshot         → understand current page
+3. veil click / type     → act
+4. veil wait 800         → let UI settle
+5. veil find / read      → verify
 ```
 
+Every command is deterministic. Every output is parseable. The agent decides the logic.
+
 ---
 
-## Command Reference
+## Platform Support
 
-| Command | Description |
-|---------|-------------|
-| `veil login <platform>` | Open visible browser for manual login, save session |
-| `veil logout <platform>` | Remove saved session |
-| `veil navigate <url>` | Navigate to URL (headless stealth) |
-| `veil act "<instruction>"` | Perform natural language action |
-| `veil extract "<query>"` | Extract data as JSON |
-| `veil screenshot` | Take screenshot |
-| `veil session list` | List all saved sessions |
-| `veil status` | Show veil status |
-
-### Common flags
-
-| Flag | Description |
-|------|-------------|
-| `-p, --platform <name>` | Use saved session for this platform |
-| `-u, --url <url>` | Navigate to URL before action |
-| `-H, --headed` | Run in visible browser mode |
-| `-o, --output <path>` | Output file path (screenshot) |
-| `--json` | Output machine-readable JSON |
+| Platform | Login | Post | Like | Reply | Repost | Quote |
+|----------|-------|------|------|-------|--------|-------|
+| X (Twitter) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| LinkedIn | ✅ | ✅ | ✅ | ✅ | — | — |
+| Reddit | ✅ | — | ✅ | ✅ | — | — |
+| Any website | — | — | ✅ via selectors | — | — | — |
 
 ---
 
-## Supported `act` instructions
+## Configuration
+
+Config stored at `~/.veil/config.json`. Sessions at `~/.veil/sessions/<platform>.json`.
 
 ```bash
-veil act "click Login"
-veil act "type 'hello world' into search"
-veil act "post tweet: your content here"
-veil act "like tweet"
-veil act "scroll down"
-veil act "press enter"
-veil act "go to https://example.com"
+veil status    # show current config and saved sessions
 ```
 
 ---
 
-## Session storage
+## How It Works
 
-Sessions are saved to `~/.veil/sessions/<platform>.json` as Playwright storage state (cookies + localStorage). No encryption currently — keep your machine secure.
+1. **Stealth Chromium** — launches with flags that hide automation signals
+2. **Session cookies** — saved after manual login, restored on every run
+3. **Human timing** — random delays between actions (400–1200ms)
+4. **Clean JSON output** — every command returns `{ ok, ... }` for easy parsing
 
 ---
 
-## OpenClaw integration
-
-Use `veil` as a drop-in for the OpenClaw Browser Relay. Add it as a skill and call it from any agent:
+## Built by CUTTLELAB
 
-```bash
-veil act "post tweet: launched something today" --platform twitter --json
-```
+veil is part of the tooling stack we're building for AI agents at [CUTTLELAB](https://cuttle.io).
 
 ---
 

package/dist/browser.js

@@ -2,9 +2,28 @@ import { chromium } from 'playwright';
 import { promises as fs } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
+import { execSync } from 'child_process';
 import { loadSession } from './session.js';
 const VEIL_DIR = join(homedir(), '.veil');
 const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36';
+// Detect system Chrome installation
+function findSystemChrome() {
+    const paths = [
+        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+        '/usr/bin/google-chrome',
+        '/usr/bin/chromium',
+        'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+        'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+    ];
+    for (const path of paths) {
+        try {
+            execSync(`test -x "${path}"`, { stdio: 'ignore' });
+            return path;
+        }
+        catch { }
+    }
+    return null;
+}
 let _browser = null;
 let _context = null;
 let _page = null;
@@ -12,9 +31,22 @@ export async function ensureBrowser(opts = {}) {
     if (_browser?.isConnected() && _page && !_page.isClosed()) {
         return { browser: _browser, context: _context, page: _page };
     }
+    const executablePath = findSystemChrome();
     const browser = await chromium.launch({
         headless: !opts.headed,
-        args: ['--disable-blink-features=AutomationControlled', '--no-sandbox', '--disable-setuid-sandbox', '--window-size=1280,800'],
+        executablePath: executablePath || undefined, // Use system Chrome if found, else fallback
+        args: [
+            '--disable-blink-features=AutomationControlled',
+            '--no-sandbox',
+            '--disable-setuid-sandbox',
+            '--window-size=1280,800',
+            '--disable-dev-shm-usage',
+            '--disable-gpu',
+            '--no-first-run',
+            '--no-default-browser-check',
+            '--disable-default-apps',
+            '--disable-extensions',
+        ],
     });
     const context = await browser.newContext({
         viewport: { width: 1280, height: 800 },
@@ -22,12 +54,27 @@ export async function ensureBrowser(opts = {}) {
         locale: 'en-US',
         timezoneId: 'America/New_York',
         extraHTTPHeaders: { 'Accept-Language': 'en-US,en;q=0.9' },
+        ignoreHTTPSErrors: true,
     });
     await context.addInitScript(() => {
+        // Spoof all automation detection vectors
         Object.defineProperty(navigator, 'webdriver', { get: () => undefined });
+        Object.defineProperty(navigator, 'chromeapp', { get: () => undefined });
         window.chrome = { runtime: {} };
         Object.defineProperty(navigator, 'plugins', { get: () => [1, 2, 3, 4, 5] });
         Object.defineProperty(navigator, 'languages', { get: () => ['en-US', 'en'] });
+        // Spoof permissions
+        window.navigator.permissions = {
+            query: () => Promise.resolve({ state: Notification.permission })
+        };
+        // Override toString on navigator to hide automation
+        const originalToString = Function.prototype.toString;
+        Function.prototype.toString = function () {
+            if (this === window.navigator.permissions.query) {
+                return 'function query() { [native code] }';
+            }
+            return originalToString.call(this);
+        };
     });
     const session = await loadSession(opts.platform ?? 'default').catch(() => null);
     if (session?.cookies?.length)

package/dist/index.js

@@ -3,31 +3,81 @@ import { Command } from 'commander';
 import chalk from 'chalk';
 import { ensureBrowser, closeBrowser, getPage } from './browser.js';
 import { saveSession } from './session.js';
+import { getPlatform, listPlatforms, searchPlatforms } from './platforms.js';
 const program = new Command();
 program
     .name('veil')
     .description('🕶️  OpenClaw browser remote — stealth headless browser')
-    .version('0.3.0');
+    .version('0.4.0');
+// ─── Platforms Directory ──────────────────────────────────────────────────────
+program
+    .command('platforms')
+    .description('Manage platform directory')
+    .action(() => {
+    console.log(chalk.blue('\n📚 Veil Platform Directory\n'));
+    const platforms = listPlatforms();
+    const byCategory = platforms.reduce((acc, p) => {
+        acc[p.category] = (acc[p.category] || []).concat(p);
+        return acc;
+    }, {});
+    for (const [category, proms] of Object.entries(byCategory)) {
+        console.log(chalk.cyan(`  ${category.toUpperCase()} (${proms.length})`));
+        proms.forEach(p => {
+            console.log(chalk.gray(`    • ${p.name} — ${p.aliases.join(', ')}`));
+        });
+        console.log();
+    }
+    console.log(chalk.gray(`Total: ${platforms.length} platforms\n`));
+});
+program
+    .command('platforms:list [category]')
+    .description('List platforms by category (ai, social, dev, productivity, finance, shopping, email, other)')
+    .action((category) => {
+    const platforms = listPlatforms(category);
+    console.log(chalk.blue(`\n📊 ${category ? `${category.toUpperCase()} Platforms` : 'All Platforms'} (${platforms.length})\n`));
+    platforms.forEach(p => {
+        console.log(`  ${chalk.cyan(p.name)}`);
+        console.log(`    Aliases: ${p.aliases.join(', ')}`);
+        if (p.notes)
+            console.log(`    Notes: ${chalk.gray(p.notes)}`);
+        console.log();
+    });
+});
+program
+    .command('platforms:search <query>')
+    .description('Search for a platform')
+    .action((query) => {
+    const results = searchPlatforms(query);
+    if (results.length === 0) {
+        console.log(chalk.yellow(`\nNo platforms found matching "${query}"\n`));
+    }
+    else {
+        console.log(chalk.blue(`\n🔍 Found ${results.length} platform(s):\n`));
+        results.forEach(p => {
+            console.log(`  ${chalk.cyan(p.name)}`);
+            console.log(`    Login: ${chalk.gray(p.loginUrl)}`);
+            console.log(`    Aliases: ${p.aliases.join(', ')}`);
+            console.log();
+        });
+    }
+});
 // ─── Session ──────────────────────────────────────────────────────────────────
 program
     .command('login <platform>')
-    .description('Open visible browser to log in and save session (x, linkedin, reddit)')
-    .action(async (platform) => {
-    const platformUrls = {
-        x: 'https://x.com/login',
-        twitter: 'https://x.com/login',
-        linkedin: 'https://www.linkedin.com/login',
-        reddit: 'https://www.reddit.com/login',
-        bluesky: 'https://bsky.app',
-    };
-    const url = platformUrls[platform.toLowerCase()] ?? `https://${platform}`;
-    const { browser, context, page } = await ensureBrowser({ headed: true, platform });
+    .description('Open visible browser to log in and save session')
+    .action(async (platformQuery) => {
+    const platform = getPlatform(platformQuery);
+    const url = platformQuery.startsWith('http://') || platformQuery.startsWith('https://')
+        ? platformQuery
+        : platform?.loginUrl ?? `https://${platformQuery}`;
+    const { browser, context, page } = await ensureBrowser({ headed: true, platform: platformQuery });
     await page.goto(url, { waitUntil: 'domcontentloaded' });
-    console.log(chalk.cyan(`\n🔐 Log into ${platform} in the browser window.`));
+    const displayName = platform?.name || platformQuery;
+    console.log(chalk.cyan(`\n🔐 Log into ${displayName} in the browser window.`));
     console.log(chalk.gray('   Press Enter here when done.\n'));
     await new Promise(res => process.stdin.once('data', () => res()));
-    await saveSession(platform, context);
-    console.log(chalk.green(`✅ Session saved for ${platform}`));
+    await saveSession(platformQuery, context);
+    console.log(chalk.green(`✅ Session saved for ${displayName}`));
     await browser.close();
 });
 program

package/dist/platforms.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Veil Platform Directory
+ * Comprehensive mapping of platforms with login URLs, selectors, and metadata
+ */
+export interface PlatformConfig {
+    name: string;
+    loginUrl: string;
+    aliases: string[];
+    category: 'social' | 'ai' | 'productivity' | 'email' | 'shopping' | 'dev' | 'finance' | 'other';
+    selectors?: {
+        emailInput?: string;
+        usernameInput?: string;
+        passwordInput?: string;
+        submitButton?: string;
+        nextButton?: string;
+        verificationInput?: string;
+    };
+    postLoginCheck?: string;
+    cookies?: string[];
+    notes?: string;
+}
+export declare const PLATFORMS: Record<string, PlatformConfig>;
+export declare function getPlatform(query: string): PlatformConfig | null;
+export declare function listPlatforms(category?: PlatformConfig['category']): PlatformConfig[];
+export declare function searchPlatforms(query: string): PlatformConfig[];

package/dist/platforms.js

@@ -0,0 +1,281 @@
+/**
+ * Veil Platform Directory
+ * Comprehensive mapping of platforms with login URLs, selectors, and metadata
+ */
+export const PLATFORMS = {
+    // ─── AI & Image Generation ───
+    gemini: {
+        name: 'Google Gemini',
+        loginUrl: 'https://gemini.google.com/',
+        aliases: ['gemini', 'google-gemini', 'bard'],
+        category: 'ai',
+        postLoginCheck: '[aria-label*="Send a message"]',
+        cookies: ['__Secure-GSID', '__Secure-HSID'],
+        notes: 'Google account required',
+    },
+    'dalle-web': {
+        name: 'DALL-E (OpenAI Web)',
+        loginUrl: 'https://openai.com/api/auth/callback/auth0',
+        aliases: ['dalle', 'dalle-3', 'dall-e', 'openai-images'],
+        category: 'ai',
+        postLoginCheck: 'button[aria-label*="Generate"]',
+        cookies: ['_U'],
+        notes: 'OpenAI account required',
+    },
+    'claude-web': {
+        name: 'Claude (Anthropic Web)',
+        loginUrl: 'https://claude.ai/',
+        aliases: ['claude', 'anthropic', 'claude-web'],
+        category: 'ai',
+        postLoginCheck: 'textarea[placeholder*="Send a message"]',
+        cookies: ['__Secure-SSID'],
+        notes: 'Anthropic/Claude subscription required',
+    },
+    midjourney: {
+        name: 'Midjourney',
+        loginUrl: 'https://www.midjourney.com/auth/login',
+        aliases: ['midjourney', 'mj'],
+        category: 'ai',
+        selectors: {
+            emailInput: 'input[type="email"]',
+            passwordInput: 'input[type="password"]',
+            submitButton: 'button[type="submit"]',
+        },
+        postLoginCheck: 'div[data-testid="sidebar"]',
+        notes: 'Discord-based, requires account',
+    },
+    'stability-ai': {
+        name: 'Stability AI (DreamStudio)',
+        loginUrl: 'https://dreamstudio.ai/generate',
+        aliases: ['stability', 'dreamstudio', 'stable-diffusion-web'],
+        category: 'ai',
+        postLoginCheck: 'button:has-text("Generate")',
+        notes: 'API key or account required',
+    },
+    // ─── Social Media ───
+    x: {
+        name: 'X (Twitter)',
+        loginUrl: 'https://x.com/login',
+        aliases: ['x', 'twitter', 'x-com'],
+        category: 'social',
+        selectors: {
+            emailInput: 'input[autocomplete="username"]',
+            passwordInput: 'input[type="password"]',
+            submitButton: 'button[type="submit"]',
+        },
+        postLoginCheck: 'a[href="/home"]',
+        cookies: ['auth_token'],
+    },
+    bluesky: {
+        name: 'Bluesky',
+        loginUrl: 'https://bsky.app/login',
+        aliases: ['bluesky', 'bsky'],
+        category: 'social',
+        selectors: {
+            usernameInput: 'input[placeholder*="Username"]',
+            passwordInput: 'input[type="password"]',
+            submitButton: 'button:has-text("Sign in")',
+        },
+        postLoginCheck: 'div[aria-label="Home timeline"]',
+    },
+    reddit: {
+        name: 'Reddit',
+        loginUrl: 'https://www.reddit.com/login',
+        aliases: ['reddit'],
+        category: 'social',
+        selectors: {
+            emailInput: 'input[id*="login-username"]',
+            passwordInput: 'input[id*="login-password"]',
+            submitButton: 'button[type="submit"]',
+        },
+        postLoginCheck: 'button[aria-label*="Create post"]',
+        cookies: ['session_tracker'],
+    },
+    linkedin: {
+        name: 'LinkedIn',
+        loginUrl: 'https://www.linkedin.com/login',
+        aliases: ['linkedin'],
+        category: 'social',
+        selectors: {
+            emailInput: 'input#username',
+            passwordInput: 'input#password',
+            submitButton: 'button[type="submit"]',
+        },
+        postLoginCheck: 'a[data-control-name="feed_home_button"]',
+        cookies: ['li_at'],
+    },
+    github: {
+        name: 'GitHub',
+        loginUrl: 'https://github.com/login',
+        aliases: ['github', 'gh'],
+        category: 'dev',
+        selectors: {
+            emailInput: 'input#login_field',
+            passwordInput: 'input#password',
+            submitButton: 'input[type="submit"]',
+        },
+        postLoginCheck: 'div[data-nav-core-github-home-feed]',
+        cookies: ['user_session', 'logged_in'],
+    },
+    // ─── Email & Productivity ───
+    gmail: {
+        name: 'Gmail',
+        loginUrl: 'https://accounts.google.com/ServiceLogin?service=mail',
+        aliases: ['gmail', 'google-mail'],
+        category: 'email',
+        postLoginCheck: 'div[role="button"]:has-text("Compose")',
+        cookies: ['__Secure-GSID'],
+        notes: 'Google account',
+    },
+    notion: {
+        name: 'Notion',
+        loginUrl: 'https://www.notion.so/login',
+        aliases: ['notion'],
+        category: 'productivity',
+        selectors: {
+            emailInput: 'input[type="email"]',
+            submitButton: 'button:has-text("Continue with email")',
+        },
+        postLoginCheck: 'div[data-testid="sidebar"]',
+    },
+    notion_sso: {
+        name: 'Notion (Google SSO)',
+        loginUrl: 'https://www.notion.so/login?google=true',
+        aliases: ['notion-google', 'notion-sso'],
+        category: 'productivity',
+        postLoginCheck: 'div[data-testid="sidebar"]',
+    },
+    // ─── Development & APIs ───
+    openai_platform: {
+        name: 'OpenAI Platform',
+        loginUrl: 'https://platform.openai.com/login',
+        aliases: ['openai', 'openai-api', 'openai-platform'],
+        category: 'dev',
+        selectors: {
+            emailInput: 'input[type="email"]',
+            submitButton: 'button:has-text("Continue")',
+        },
+        postLoginCheck: 'button[aria-label="Create new secret key"]',
+        cookies: ['_auth0sso'],
+    },
+    anthropic_console: {
+        name: 'Anthropic Console',
+        loginUrl: 'https://console.anthropic.com/login',
+        aliases: ['anthropic', 'anthropic-api', 'anthropic-console'],
+        category: 'dev',
+        postLoginCheck: 'button:has-text("Create API key")',
+    },
+    huggingface: {
+        name: 'Hugging Face',
+        loginUrl: 'https://huggingface.co/login',
+        aliases: ['huggingface', 'hf'],
+        category: 'dev',
+        selectors: {
+            usernameInput: 'input[name="username"]',
+            passwordInput: 'input[name="password"]',
+            submitButton: 'button[type="submit"]',
+        },
+        postLoginCheck: 'a[href*="/settings"]',
+    },
+    // ─── Shopping ───
+    amazon: {
+        name: 'Amazon',
+        loginUrl: 'https://www.amazon.com/ap/signin',
+        aliases: ['amazon'],
+        category: 'shopping',
+        selectors: {
+            emailInput: 'input#ap_email',
+            passwordInput: 'input#ap_password',
+            submitButton: 'input#signInSubmit',
+        },
+        postLoginCheck: 'a[data-nav-ref="nav_your_account"]',
+    },
+    ebay: {
+        name: 'eBay',
+        loginUrl: 'https://signin.ebay.com/signin/',
+        aliases: ['ebay'],
+        category: 'shopping',
+        selectors: {
+            emailInput: 'input#userid',
+            passwordInput: 'input#pass',
+            submitButton: 'button#signin-continue',
+        },
+        postLoginCheck: 'a[href*="myaccount"]',
+    },
+    // ─── Finance ───
+    stripe: {
+        name: 'Stripe Dashboard',
+        loginUrl: 'https://dashboard.stripe.com/login',
+        aliases: ['stripe'],
+        category: 'finance',
+        selectors: {
+            emailInput: 'input[type="email"]',
+            passwordInput: 'input[type="password"]',
+            submitButton: 'button[type="submit"]',
+        },
+        postLoginCheck: 'button[aria-label*="Account menu"]',
+    },
+    // ─── Miscellaneous ───
+    google: {
+        name: 'Google (Generic)',
+        loginUrl: 'https://accounts.google.com/',
+        aliases: ['google', 'google-account'],
+        category: 'other',
+        selectors: {
+            emailInput: 'input#identifierId',
+            submitButton: 'button#identifierNext',
+        },
+    },
+    microsoft: {
+        name: 'Microsoft Account',
+        loginUrl: 'https://login.live.com/',
+        aliases: ['microsoft', 'outlook', 'hotmail'],
+        category: 'other',
+        selectors: {
+            emailInput: 'input[type="email"]',
+            submitButton: 'input[type="submit"]',
+        },
+    },
+    apple: {
+        name: 'Apple ID',
+        loginUrl: 'https://appleid.apple.com/',
+        aliases: ['apple', 'apple-id'],
+        category: 'other',
+        selectors: {
+            emailInput: 'input#user-name',
+            passwordInput: 'input#password',
+            submitButton: 'button[type="submit"]',
+        },
+    },
+};
+export function getPlatform(query) {
+    const lower = query.toLowerCase();
+    // Exact match in key
+    if (PLATFORMS[lower]) {
+        return PLATFORMS[lower];
+    }
+    // Check aliases
+    for (const [, platform] of Object.entries(PLATFORMS)) {
+        if (platform.aliases.includes(lower)) {
+            return platform;
+        }
+    }
+    // Fuzzy match on name
+    for (const [, platform] of Object.entries(PLATFORMS)) {
+        if (platform.name.toLowerCase().includes(lower)) {
+            return platform;
+        }
+    }
+    return null;
+}
+export function listPlatforms(category) {
+    if (!category) {
+        return Object.values(PLATFORMS);
+    }
+    return Object.values(PLATFORMS).filter(p => p.category === category);
+}
+export function searchPlatforms(query) {
+    const lower = query.toLowerCase();
+    return Object.values(PLATFORMS).filter(p => p.name.toLowerCase().includes(lower) ||
+        p.aliases.some(a => a.includes(lower)));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veil-browser",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Stealth browser CLI for AI agents — bypass bot detection, persist sessions, local CAPTCHA solving, MCP server",
   "keywords": [
     "browser",