CBrowser — Cognitive Browser Automation

1---
2name: CBrowser
3description: Cognitive browser automation with 91 MCP tools. AI-friendliness audits, persona testing, empathy audits, WebMCP readiness. USE WHEN browser automation, screenshot, agent-ready audit, ai-benchmark, empathy audit, webmcp-ready, hunt bugs, cognitive journey, persona comparison, visual regression, cross-browser test.
4version: 18.18.4
5compatibility:
6  min_claude_code: "1.0.0"
7  features: ["mcp_servers"]
8---
9 
10# CBrowser (Cognitive Browser)
11 
12**The browser automation that thinks like your users.** Simulate real user cognition with patience thresholds, frustration tracking, and abandonment detection.
13 
14## Tool Priority
15 
16**When this skill is active, ALWAYS use CBrowser tools:**
17 
18| Preferred | DO NOT USE |
19|-----------|------------|
20| `npx cbrowser navigate "url"` | `mcp__chrome-devtools__*` tools |
21| `npx cbrowser click "element"` | `mcp__claude-in-chrome__*` tools |
22| `mcp__claude_ai_CBrowser_Demo__*` | Direct Playwright/Puppeteer |
23 
24## AI Friendliness Commands (CLI)
25 
26### agent-ready-audit
27Audit site for AI-agent friendliness (A-F grade).
28 
29```bash
30npx cbrowser agent-ready-audit "https://example.com"
31npx cbrowser agent-ready-audit "https://example.com" --html --output report.json
32```
33 
34Grades on: Findability (35%), Stability (30%), Accessibility (20%), Semantics (15%)
35 
36### ai-benchmark
37Compare AI-friendliness across multiple sites.
38 
39```bash
40npx cbrowser ai-benchmark --urls "https://site1.com,https://site2.com,https://site3.com"
41npx cbrowser ai-benchmark --urls "https://amazon.com,https://ebay.com" --html
42```
43 
44Runs agent-ready-audit on each URL and produces ranked comparison.
45 
46### empathy-audit
47Simulate disability experience on site.
48 
49```bash
50npx cbrowser empathy-audit "https://example.com" \
51  --goal "complete checkout" \
52  --personas "motor-impairment-tremor,cognitive-adhd" --html
53```
54 
55Available personas: motor-impairment-tremor, low-vision-magnified, cognitive-adhd, dyslexic-user, deaf-user, elderly-low-vision, color-blind-deuteranopia
56 
57### webmcp-ready
58Audit MCP server for WebMCP compatibility.
59 
60```bash
61npx cbrowser webmcp-ready "https://demo.cbrowser.ai/mcp"
62npx cbrowser webmcp-ready "https://your-server.com/mcp" --api-key KEY --html
63```
64 
656-tier evaluation: Server (25%), Tools (20%), Instrumentation (15%), Consistency (15%), Agent Opts (15%), Docs (10%)
66 
67### hunt-bugs
68Automatically find UX bugs on a page.
69 
70```bash
71npx cbrowser hunt-bugs "https://example.com"
72npx cbrowser hunt-bugs "https://example.com" --max-pages 20
73```
74 
75### competitive-benchmark
76Compare UX across competitor sites.
77 
78```bash
79npx cbrowser competitive-benchmark \
80  --sites "https://yoursite.com,https://competitor.com" \
81  --goal "sign up for free trial" --html
82```
83 
84## MCP Tools (91 total)
85 
86### AI Friendliness Tools
87| Tool | Description |
88|------|-------------|
89| `agent_ready_audit` | Audit site for AI-agent friendliness |
90| `empathy_audit` | Simulate disability experience |
91| `hunt_bugs` | Automatically find UX bugs |
92| `competitive_benchmark` | Compare UX across sites |
93| `chaos_test` | Test site resilience |
94 
95### Cognitive Journey Tools
96| Tool | Description |
97|------|-------------|
98| `cognitive_journey_init` | Initialize cognitive journey with persona |
99| `cognitive_journey_update_state` | Update cognitive state (patience, confusion) |
100| `list_cognitive_personas` | List available cognitive personas |
101| `compare_personas` | Compare personas on same site |
102 
103### Visual Testing Tools
104| Tool | Description |
105|------|-------------|
106| `visual_baseline` | Capture visual baseline |
107| `visual_regression` | Compare against baseline |
108| `cross_browser_test` | Test across browsers |
109| `responsive_test` | Test across viewports |
110| `ab_comparison` | Compare two URLs |
111 
112### Navigation & Interaction
113| Tool | Description |
114|------|-------------|
115| `navigate` | Navigate to URL |
116| `click` | Click element |
117| `fill` | Fill form field |
118| `extract` | Extract content |
119| `screenshot` | Take screenshot |
120| `scroll` | Scroll page |
121 
122### Session Management
123| Tool | Description |
124|------|-------------|
125| `save_session` | Save browser session |
126| `load_session` | Load saved session |
127| `list_sessions` | List saved sessions |
128| `delete_session` | Delete session |
129 
130### Testing Tools
131| Tool | Description |
132|------|-------------|
133| `nl_test_inline` | Run natural language test |
134| `generate_tests` | Generate test cases |
135| `detect_flaky_tests` | Find unreliable tests |
136| `coverage_map` | Map test coverage |
137 
138### Performance Tools
139| Tool | Description |
140|------|-------------|
141| `perf_baseline` | Capture performance baseline |
142| `perf_regression` | Detect performance regression |
143| `list_baselines` | List saved baselines |
144 
145## MCP Server Setup
146 
147### Claude Desktop (stdio)
148Add to `claude_desktop_config.json`:
149```json
150{
151  "mcpServers": {
152    "cbrowser": {
153      "command": "npx",
154      "args": ["cbrowser", "mcp-server"]
155    }
156  }
157}
158```
159 
160### Claude.ai (remote)
161Add as custom connector: `https://demo.cbrowser.ai/mcp`
162 
163### Claude Desktop Extension
164Download and install: [cbrowser-18.18.4.mcpb](https://github.com/alexandriashai/cbrowser/releases/download/v18.18.4/cbrowser-18.18.4.mcpb)
165 
166## Cognitive Personas (17 built-in)
167 
168| Persona | Description |
169|---------|-------------|
170| `first-timer` | New user exploring for first time |
171| `power-user` | Tech-savvy expert |
172| `mobile-user` | Smartphone user |
173| `elderly-user` | Older adult with limitations |
174| `impatient-user` | Quick to abandon |
175| `screen-reader-user` | Blind user with screen reader |
176| `motor-impairment-tremor` | User with motor tremor |
177| `low-vision-magnified` | User with low vision |
178| `cognitive-adhd` | User with ADHD |
179| `dyslexic-user` | User with dyslexia |
180| `deaf-user` | Deaf user |
181| `color-blind-deuteranopia` | Red-green color blind |
182 
183## 25 Cognitive Traits
184 
185| Tier | Traits |
186|------|--------|
187| Core | patience, riskTolerance, comprehension |
188| Emotional | frustrationResponse, resilience, confidenceLevel |
189| Decision | decisionStyle, satisficing, impulsivity |
190| Planning | goalPersistence, taskSwitching, planningHorizon |
191| Perception | attentionPattern, visualProcessing, informationFiltering |
192| Social | trustCalibration, socialProofSensitivity, authorityResponse |
193 
194## Version History
195 
196| Version | Features |
197|---------|----------|
198| v18.18.4 | Browser auto-install fallback for MCPB context |
199| v18.18.3 | WebMCP readiness audit, llms.txt endpoint |
200| v18.15.0 | AI Friendliness tools, competitive benchmark |
201| v16.14.0 | Trait-based value derivation for personas |
202| v16.12.0 | Category-aware persona values system |
203| v8.3.1 | Cognitive user simulation with abandonment |
204 
205## Links
206 
207- **GitHub:** https://github.com/alexandriashai/cbrowser
208- **Docs:** https://cbrowser.ai/docs
209- **npm:** https://www.npmjs.com/package/cbrowser
210