# CBrowser

> The browser automation that thinks like your users - cognitive simulation, constitutional AI safety, and self-healing selectors.

## Overview

CBrowser (Cognitive Browser) is an AI-native browser automation tool for Claude and other AI agents. It provides:

- **Cognitive User Simulation**: Simulate how real users think, not just how they click
- **Constitutional AI Safety**: Action classification (green/yellow/red/black zones) prevents dangerous operations
- **Self-Healing Selectors**: AI-powered element finding that survives DOM changes
- **25 Cognitive Traits**: Research-backed personality simulation (patience, comprehension, risk tolerance, etc.)
- **Accessibility Testing**: Empathy audit simulates users with disabilities
- **AI-Friendliness Audit**: Score sites on AI-agent compatibility (A-F grades)

## Key Pages

- [Home](https://cbrowser.ai/) - Main landing page with feature overview
- [Documentation](https://cbrowser.ai/docs/Home) - Getting started and API reference
- [Tools Overview](https://cbrowser.ai/tools) - All 105 MCP tools
- [AI-Friendliness](https://cbrowser.ai/ai-friendliness) - Make sites AI-agent ready
- [Security](https://cbrowser.ai/security) - Constitutional safety and threat model
- [Enterprise](https://cbrowser.ai/enterprise) - Marketing intelligence features
- [Product Intelligence](https://cbrowser.ai/product-intelligence) - UX research automation
- [About](https://cbrowser.ai/about) - Team and mission

## AI-Friendliness Hub

- [AI-Friendliness Hub](https://cbrowser.ai/ai-friendliness) - Overview of AI-agent compatibility
- [Agent-Ready Audit](https://cbrowser.ai/ai-friendliness/audit) - Score your site for AI navigation
- [AI Benchmark](https://cbrowser.ai/ai-friendliness/benchmark) - Compare against industry standards
- [Remediation Guide](https://cbrowser.ai/ai-friendliness/remediation) - Fix AI-unfriendly patterns
- [llms.txt Generator](https://cbrowser.ai/ai-friendliness/llms-txt) - Create your own llms.txt
- [WebMCP Ready](https://cbrowser.ai/ai-friendliness/webmcp-ready) - MCP server compatibility audit

## Flagship Tools

- [Cognitive Journey](https://cbrowser.ai/tools/cognitive-journey) - Simulate real user cognition with abandonment detection
- [Empathy Audit](https://cbrowser.ai/tools/empathy-audit) - Test with disability personas (motor tremor, low vision, ADHD)
- [Hunt Bugs](https://cbrowser.ai/tools/hunt-bugs) - AI-powered bug detection
- [Competitive Benchmark](https://cbrowser.ai/tools/competitive-benchmark) - Compare UX across competitor sites
- [Persona Create](https://cbrowser.ai/tools/persona-create) - Build custom user personas with 26 traits
- [Marketing Campaign](https://cbrowser.ai/tools/marketing-campaign) - A/B testing with influence matrix

## Documentation Sections

### Getting Started
- [Getting Started](https://cbrowser.ai/docs/Getting-Started) - Installation and quick start
- [FAQ](https://cbrowser.ai/docs/FAQ) - Frequently asked questions
- [Troubleshooting](https://cbrowser.ai/docs/Troubleshooting) - Common issues and solutions

### Core Features
- [Cognitive User Simulation](https://cbrowser.ai/docs/Cognitive-User-Simulation) - How cognitive journeys work
- [Constitutional Safety](https://cbrowser.ai/docs/Constitutional-Safety) - Action classification zones
- [UX Analysis Suite](https://cbrowser.ai/docs/UX-Analysis-Suite) - Comprehensive UX testing

### Cognitive Traits
- [Trait Index](https://cbrowser.ai/docs/Trait-Index) - All 26 research-backed traits
- [Trait Patience](https://cbrowser.ai/docs/Trait-Patience) - Time tolerance and abandonment
- [Trait Comprehension](https://cbrowser.ai/docs/Trait-Comprehension) - Understanding UI conventions
- [Trait RiskTolerance](https://cbrowser.ai/docs/Trait-RiskTolerance) - Willingness to explore

### User Personas
- [Persona Index](https://cbrowser.ai/docs/Persona-Index) - All built-in and custom personas
- [Persona Questionnaire](https://cbrowser.ai/docs/Persona-Questionnaire) - Create personas from surveys
- [Multi-Persona Comparison](https://cbrowser.ai/docs/Multi-Persona-Comparison) - Compare UX across user types

### MCP Tools
- [Tools Overview](https://cbrowser.ai/docs/Tools-Overview) - All 105 tools by category
- [Browser Automation](https://cbrowser.ai/docs/Tools-Browser-Automation) - Navigation, clicking, forms
- [Cognitive Journeys](https://cbrowser.ai/docs/Tools-Cognitive-Journeys) - User simulation tools
- [Persona System](https://cbrowser.ai/docs/Tools-Persona-System) - Persona management tools
- [Testing & Quality](https://cbrowser.ai/docs/Tools-Testing-Quality) - Test automation tools
- [Visual & Performance](https://cbrowser.ai/docs/Tools-Visual-Performance) - Visual regression, performance
- [Marketing Intelligence](https://cbrowser.ai/docs/Tools-Marketing-Intelligence) - Campaign and influence tools
- [Accessibility](https://cbrowser.ai/docs/Tools-Accessibility) - Empathy audit and WCAG
- [Session & State](https://cbrowser.ai/docs/Tools-Session-State) - Browser state management
- [Utilities](https://cbrowser.ai/docs/Tools-Utilities) - Diagnostics and helpers

### Integration
- [MCP Server](https://cbrowser.ai/docs/MCP-Server) - Claude Desktop setup
- [Remote MCP Server](https://cbrowser.ai/docs/Remote-MCP-Server) - claude.ai integration
- [Claude Skill Installation](https://cbrowser.ai/docs/Claude-Skill-Installation) - Claude Code skill

### Reference
- [API Reference](https://cbrowser.ai/docs/API-Reference) - MCP tool parameters and responses
- [CLI Reference](https://cbrowser.ai/docs/CLI-Reference) - Command-line usage
- [Examples](https://cbrowser.ai/docs/Examples) - Real-world usage patterns

### Research
- [Bibliography](https://cbrowser.ai/docs/Bibliography) - Academic sources for cognitive traits
- [Values Framework](https://cbrowser.ai/docs/Values-Framework) - Schwartz values in personas
- [Research Methodology](https://cbrowser.ai/docs/Research-Methodology) - How traits were validated

### Security
- [Threat Model](https://cbrowser.ai/docs/THREAT_MODEL) - Security analysis
- [Security Whitepaper](https://cbrowser.ai/docs/SECURITY_WHITEPAPER) - Constitutional AI safety

## Actions

### Allowed
- Browse documentation and tool pages
- Read API reference and examples
- View cognitive trait and persona information
- Search for specific tools or features
- Access AI-friendliness audit tools

### Requires Authentication
- None - all documentation is public

### Not Applicable
- CBrowser is a documentation site; no user accounts or data modification

## Installation

```bash
npm install cbrowser
npx cbrowser --help
```

## MCP Server

Add to `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "cbrowser": {
      "command": "npx",
      "args": ["cbrowser", "mcp-server"]
    }
  }
}
```

## Demo MCP Server

Free, rate-limited access:
```
URL: https://demo.cbrowser.ai/mcp
```

## Legal

- [Privacy Policy](https://cbrowser.ai/privacy)
- [Terms of Service](https://cbrowser.ai/terms)
- [Acknowledgements](https://cbrowser.ai/acknowledgements)

## Contact

- GitHub: https://github.com/alexandriashai/cbrowser
- npm: https://www.npmjs.com/package/cbrowser
- Issues: https://github.com/alexandriashai/cbrowser/issues

## Version

Current: v18.29.0
Last updated: 2026-04-11