qamax-auth-cli

QualityMax Auth Capture CLI

CLI tool to capture authentication sessions for QualityMax AI crawling.

Installation

npm install -g qamax-auth-cli

Or run directly with npx (no install needed):

npx qamax-auth-cli login

Requirements

• Node.js 18+
• Chrome browser installed

Usage

1. Login to QualityMax

qamax-auth login

This opens your browser to authenticate with QualityMax and saves your token locally.

2. List Your Projects

qamax-auth projects

3. Capture Authentication

Open Chrome, log into your app manually, then the CLI captures and uploads the session:

qamax-auth capture https://myapp.com -p PROJECT_ID -n "profile-name"

Options:

• -p, --project <id> - Project ID (required)
• -n, --name <name> - Auth profile name (required)
• -t, --timeout <ms> - Browser timeout (default: 300000)

Example Workflow

# Login to QualityMax
qamax-auth login

# List your projects to find the ID
qamax-auth projects

# Capture auth for your staging environment
qamax-auth capture https://staging.myapp.com -p 42 -n "staging_auth"

# The captured auth is now available in your project's User Data Variables
# Use it in AI Crawl to authenticate before crawling

How It Works

• Opens Chrome with remote debugging enabled
• You log into your application manually
• When you press ENTER, CLI captures cookies, localStorage, and session storage
• Uploads encrypted storage state to your QualityMax project (User Data Variables)
• AI Crawl can use this auth data to access authenticated pages

Troubleshooting

"Chrome not found"

Install Chrome or set the path:

export CHROME_PATH=/path/to/chrome

Session not working in AI Crawl

• Ensure you completed the full login flow before pressing ENTER
• Check if the session has expired (some sites have short session timeouts)
• Try capturing again with a fresh login

Links

• npm package
• GitHub repo
• QualityMax