cbrowser 17.6.0 → 18.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/browser.d.ts +4 -0
- package/dist/browser.d.ts.map +1 -1
- package/dist/browser.js +37 -1
- package/dist/browser.js.map +1 -1
- package/dist/cli.js +10 -5
- package/dist/cli.js.map +1 -1
- package/dist/mcp-server-remote.d.ts.map +1 -1
- package/dist/mcp-server-remote.js +16 -0
- package/dist/mcp-server-remote.js.map +1 -1
- package/docs/Tool-Cognitive-Journey-Autonomous.md +264 -0
- package/docs/Tool-Competitive-Benchmark.md +287 -0
- package/docs/Tool-Empathy-Audit.md +325 -0
- package/docs/Tool-Hunt-Bugs.md +299 -0
- package/docs/Tool-Marketing-Campaign.md +292 -0
- package/docs/Tool-Persona-Create.md +268 -0
- package/docs/Tools-Accessibility.md +202 -0
- package/docs/Tools-Browser-Automation.md +305 -0
- package/docs/Tools-Cognitive-Journeys.md +227 -0
- package/docs/Tools-Marketing-Intelligence.md +265 -0
- package/docs/Tools-Overview.md +143 -0
- package/docs/Tools-Persona-System.md +294 -0
- package/docs/Tools-Session-State.md +272 -0
- package/docs/Tools-Testing-Quality.md +251 -0
- package/docs/Tools-Utilities.md +176 -0
- package/docs/Tools-Visual-Performance.md +272 -0
- package/package.json +1 -1
|
@@ -0,0 +1,227 @@
|
|
|
1
|
+
# Cognitive Journey Tools
|
|
2
|
+
|
|
3
|
+
**Find out where users give up before they actually do.**
|
|
4
|
+
|
|
5
|
+
Cognitive journeys simulate real humans navigating your site — complete with patience that depletes, frustration that builds, and the moment they decide "this isn't worth it" and leave. These 6 tools let you experience your product through the minds of different user types.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## When to Use These Tools
|
|
10
|
+
|
|
11
|
+
- **Your conversion rate is mysteriously low** and analytics can't tell you why people abandon
|
|
12
|
+
- **You're launching a new feature** and want to know if real users can figure it out
|
|
13
|
+
- **You need to compare experiences** across different audience segments
|
|
14
|
+
- **You want to find friction** before your users feel it
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Tools
|
|
19
|
+
|
|
20
|
+
### `cognitive_journey_init`
|
|
21
|
+
|
|
22
|
+
**What it does**: Starts a cognitive journey session with a specific persona, goal, and starting point. Returns the persona's cognitive profile and initial state.
|
|
23
|
+
|
|
24
|
+
**Why you'd use it**: Begin simulating how a specific user type would approach your site.
|
|
25
|
+
|
|
26
|
+
| Parameter | Type | Required | Description |
|
|
27
|
+
|-----------|------|----------|-------------|
|
|
28
|
+
| `persona` | string | Yes | Persona ID (e.g., `first-timer`, `elderly-user`, `cognitive-adhd`) |
|
|
29
|
+
| `startUrl` | string | Yes | URL where the journey begins |
|
|
30
|
+
| `goal` | string | Yes | What the persona is trying to accomplish |
|
|
31
|
+
| `maxSteps` | number | No | Maximum actions before forcing stop. Default: 50 |
|
|
32
|
+
|
|
33
|
+
**Example**:
|
|
34
|
+
```json
|
|
35
|
+
{
|
|
36
|
+
"persona": "first-timer",
|
|
37
|
+
"startUrl": "https://example.com",
|
|
38
|
+
"goal": "Create an account and make a purchase"
|
|
39
|
+
}
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
**Returns**: Session ID, persona profile (25 traits), initial cognitive state (patience, confusion, frustration at starting values).
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
### `cognitive_journey_update_state`
|
|
47
|
+
|
|
48
|
+
**What it does**: Updates the persona's cognitive state after each action. Tracks mood changes, calculates whether they would abandon, and generates inner monologue.
|
|
49
|
+
|
|
50
|
+
**Why you'd use it**: After each navigation step, report what happened and get the persona's reaction.
|
|
51
|
+
|
|
52
|
+
| Parameter | Type | Required | Description |
|
|
53
|
+
|-----------|------|----------|-------------|
|
|
54
|
+
| `sessionId` | string | Yes | Session ID from `cognitive_journey_init` |
|
|
55
|
+
| `action` | string | Yes | What action was just taken |
|
|
56
|
+
| `result` | string | Yes | What happened — success, failure, unexpected |
|
|
57
|
+
| `patienceChange` | number | No | How much patience changed (-1 to 1) |
|
|
58
|
+
| `confusionChange` | number | No | How much confusion changed (-1 to 1) |
|
|
59
|
+
| `frustrationChange` | number | No | How much frustration changed (-1 to 1) |
|
|
60
|
+
| `currentUrl` | string | No | Current page URL |
|
|
61
|
+
|
|
62
|
+
**Example**:
|
|
63
|
+
```json
|
|
64
|
+
{
|
|
65
|
+
"sessionId": "journey_abc123",
|
|
66
|
+
"action": "Clicked 'Sign Up' button",
|
|
67
|
+
"result": "Page showed loading spinner for 8 seconds before form appeared",
|
|
68
|
+
"patienceChange": -0.15,
|
|
69
|
+
"confusionChange": 0.05,
|
|
70
|
+
"frustrationChange": 0.10,
|
|
71
|
+
"currentUrl": "https://example.com/signup"
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**Returns**:
|
|
76
|
+
- `shouldAbandon`: boolean — would this persona leave?
|
|
77
|
+
- `abandonmentReason`: why they'd leave (if applicable)
|
|
78
|
+
- `innerMonologue`: what they're thinking ("This is taking forever...")
|
|
79
|
+
- `currentState`: updated patience/confusion/frustration values
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
### `cognitive_journey_autonomous` 🔒 Enterprise
|
|
84
|
+
|
|
85
|
+
**What it does**: Runs a complete journey autonomously with AI making all navigation decisions. No orchestration needed — just set the goal and watch.
|
|
86
|
+
|
|
87
|
+
**Why you'd use it**: Hands-off user simulation that generates complete friction reports and abandonment analysis.
|
|
88
|
+
|
|
89
|
+
> **Enterprise Feature** — Requires CBrowser Enterprise.
|
|
90
|
+
> Autonomous execution consumes Anthropic API credits for decision-making.
|
|
91
|
+
> [Learn about Enterprise →](/docs/Marketing-Suite/)
|
|
92
|
+
|
|
93
|
+
| Parameter | Type | Required | Description |
|
|
94
|
+
|-----------|------|----------|-------------|
|
|
95
|
+
| `persona` | string | Yes | Persona ID |
|
|
96
|
+
| `startUrl` | string | Yes | Starting URL |
|
|
97
|
+
| `goal` | string | Yes | What to accomplish |
|
|
98
|
+
| `maxSteps` | number | No | Max actions. Default: 50 |
|
|
99
|
+
| `maxTime` | number | No | Max seconds. Default: 300 |
|
|
100
|
+
| `vision` | boolean | No | Use screenshot analysis for decisions. Default: false |
|
|
101
|
+
| `headless` | boolean | No | Run without visible browser. Default: false |
|
|
102
|
+
|
|
103
|
+
**Example**:
|
|
104
|
+
```json
|
|
105
|
+
{
|
|
106
|
+
"persona": "elderly-user",
|
|
107
|
+
"startUrl": "https://bank.example.com",
|
|
108
|
+
"goal": "Transfer $100 to savings account",
|
|
109
|
+
"vision": true,
|
|
110
|
+
"maxSteps": 30
|
|
111
|
+
}
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
**Returns**: Complete journey trace with every decision, friction points, screenshots, and final outcome.
|
|
115
|
+
|
|
116
|
+
---
|
|
117
|
+
|
|
118
|
+
### `compare_personas`
|
|
119
|
+
|
|
120
|
+
**What it does**: Run the same journey with multiple personas and compare their experiences side-by-side.
|
|
121
|
+
|
|
122
|
+
**Why you'd use it**: Understand how different user segments experience the same flow differently.
|
|
123
|
+
|
|
124
|
+
| Parameter | Type | Required | Description |
|
|
125
|
+
|-----------|------|----------|-------------|
|
|
126
|
+
| `personas` | array | Yes | List of persona IDs to compare |
|
|
127
|
+
| `startUrl` | string | Yes | Starting URL |
|
|
128
|
+
| `goal` | string | Yes | What to accomplish |
|
|
129
|
+
| `parallel` | boolean | No | Run journeys simultaneously. Default: false |
|
|
130
|
+
|
|
131
|
+
**Example**:
|
|
132
|
+
```json
|
|
133
|
+
{
|
|
134
|
+
"personas": ["power-user", "first-timer", "elderly-user"],
|
|
135
|
+
"startUrl": "https://example.com/checkout",
|
|
136
|
+
"goal": "Complete purchase"
|
|
137
|
+
}
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
**Returns**: Comparison matrix showing success/failure, time taken, abandonment points, and friction experienced by each persona.
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
### `compare_personas_init`
|
|
145
|
+
|
|
146
|
+
**What it does**: Initialize a multi-persona comparison using the bridge workflow (no API key needed). Returns profiles for all personas ready for manual orchestration.
|
|
147
|
+
|
|
148
|
+
**Why you'd use it**: Run persona comparisons when you want Claude to orchestrate each step rather than autonomous execution.
|
|
149
|
+
|
|
150
|
+
| Parameter | Type | Required | Description |
|
|
151
|
+
|-----------|------|----------|-------------|
|
|
152
|
+
| `personas` | array | Yes | List of persona IDs |
|
|
153
|
+
| `startUrl` | string | Yes | Starting URL |
|
|
154
|
+
| `goal` | string | Yes | Goal to accomplish |
|
|
155
|
+
|
|
156
|
+
**Example**:
|
|
157
|
+
```json
|
|
158
|
+
{
|
|
159
|
+
"personas": ["mobile-user", "impatient-user"],
|
|
160
|
+
"startUrl": "https://example.com",
|
|
161
|
+
"goal": "Find pricing information"
|
|
162
|
+
}
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
---
|
|
166
|
+
|
|
167
|
+
### `compare_personas_complete`
|
|
168
|
+
|
|
169
|
+
**What it does**: Finalize a persona comparison by aggregating all journey results and generating the comparison report.
|
|
170
|
+
|
|
171
|
+
**Why you'd use it**: After running individual journeys for each persona, compile the results.
|
|
172
|
+
|
|
173
|
+
| Parameter | Type | Required | Description |
|
|
174
|
+
|-----------|------|----------|-------------|
|
|
175
|
+
| `comparisonId` | string | Yes | Comparison ID from `compare_personas_init` |
|
|
176
|
+
| `results` | array | Yes | Array of journey results for each persona |
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## Understanding Cognitive State
|
|
181
|
+
|
|
182
|
+
Every persona has three dynamic metrics that change throughout their journey:
|
|
183
|
+
|
|
184
|
+
| Metric | Range | What It Means |
|
|
185
|
+
|--------|-------|---------------|
|
|
186
|
+
| **Patience** | 0.0 - 1.0 | Willingness to keep trying. Depletes with delays, errors, confusion. |
|
|
187
|
+
| **Confusion** | 0.0 - 1.0 | How lost they feel. Increases with unclear UI, unexpected behavior. |
|
|
188
|
+
| **Frustration** | 0.0 - 1.0 | Emotional response to friction. Increases with repeated failures, dead ends. |
|
|
189
|
+
|
|
190
|
+
### Abandonment Triggers
|
|
191
|
+
|
|
192
|
+
A persona abandons when any of these occur:
|
|
193
|
+
- **Patience < 0.1** — "This is taking too long, I'm done"
|
|
194
|
+
- **Confusion > 0.8 for 30+ seconds** — "I have no idea what to do"
|
|
195
|
+
- **Frustration > 0.85** — "This is ridiculous"
|
|
196
|
+
- **No progress after 10+ steps** — "I'm not getting anywhere"
|
|
197
|
+
- **Same page visited 3+ times** — "I keep ending up here"
|
|
198
|
+
|
|
199
|
+
Different personas have different starting values and depletion rates. An impatient-user starts with 0.4 patience and loses it twice as fast as a power-user.
|
|
200
|
+
|
|
201
|
+
---
|
|
202
|
+
|
|
203
|
+
## Persona Quick Reference
|
|
204
|
+
|
|
205
|
+
| Persona | Patience | Confusion Tolerance | Key Trait |
|
|
206
|
+
|---------|----------|---------------------|-----------|
|
|
207
|
+
| `power-user` | High | Low (expects clarity) | Fast decisions, low reading |
|
|
208
|
+
| `first-timer` | Medium | Medium | Explores, reads more |
|
|
209
|
+
| `elderly-user` | High | High | Slow, thorough, easily confused by jargon |
|
|
210
|
+
| `impatient-user` | Very Low | Low | Abandons fast on any friction |
|
|
211
|
+
| `mobile-user` | Low | Medium | Fat-finger issues, small viewport |
|
|
212
|
+
| `cognitive-adhd` | Low | High | Skims, clicks fast, distracted easily |
|
|
213
|
+
|
|
214
|
+
See [Persona Index](/docs/Persona-Index/) for complete profiles.
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
## Related Documentation
|
|
219
|
+
|
|
220
|
+
- [Cognitive User Simulation](/docs/Cognitive-User-Simulation/) — Deep dive on how cognitive simulation works
|
|
221
|
+
- [Persona Index](/docs/Persona-Index/) — All 9 built-in personas
|
|
222
|
+
- [Multi-Persona Comparison](/docs/Multi-Persona-Comparison/) — Comparison workflows
|
|
223
|
+
- [Trait Index](/docs/Trait-Index/) — The 25 cognitive traits
|
|
224
|
+
|
|
225
|
+
---
|
|
226
|
+
|
|
227
|
+
*Last updated: v17.6.0*
|
|
@@ -0,0 +1,265 @@
|
|
|
1
|
+
# Marketing Intelligence Tools
|
|
2
|
+
|
|
3
|
+
**Stop guessing which messages work. Start measuring influence.**
|
|
4
|
+
|
|
5
|
+
These 11 tools let you test which psychological influence patterns work on which audience segments. Run A/B campaigns with cognitive personas, analyze conversion funnels, and benchmark against competitors — all with scientific rigor.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## When to Use These Tools
|
|
10
|
+
|
|
11
|
+
- **You're optimizing conversion** and want to know which messaging resonates with each audience
|
|
12
|
+
- **You have A/B test fatigue** from inconclusive results because you're testing at the population level, not segment level
|
|
13
|
+
- **You want competitive intelligence** on why competitor sites convert better
|
|
14
|
+
- **You need to prove ROI** on UX investments with actual persona-by-persona data
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## Tools
|
|
19
|
+
|
|
20
|
+
### `marketing_personas_list`
|
|
21
|
+
|
|
22
|
+
**What it does**: List available marketing-specific personas with their influence susceptibilities.
|
|
23
|
+
|
|
24
|
+
**Why you'd use it**: See which audience segments you can test against and what motivates each one.
|
|
25
|
+
|
|
26
|
+
| Parameter | Type | Required | Description |
|
|
27
|
+
|-----------|------|----------|-------------|
|
|
28
|
+
| `category` | string | No | Filter: `b2b`, `consumer`, `all`. Default: `all` |
|
|
29
|
+
|
|
30
|
+
**Returns**: Personas with descriptions, effective influence patterns, and ineffective patterns.
|
|
31
|
+
|
|
32
|
+
### Marketing Personas
|
|
33
|
+
|
|
34
|
+
| Persona | Category | Effective Patterns | Ineffective Patterns |
|
|
35
|
+
|---------|----------|-------------------|---------------------|
|
|
36
|
+
| `enterprise-buyer` | B2B | Authority, Social Proof, Default Bias | Scarcity, Reciprocity |
|
|
37
|
+
| `startup-founder` | B2B | Scarcity, Commitment, Reciprocity | Authority, Default Bias |
|
|
38
|
+
| `procurement-manager` | B2B | Authority, Social Proof, Default Bias | Scarcity, Reciprocity |
|
|
39
|
+
| `technical-evaluator` | B2B | Commitment, Reciprocity | Social Proof, Scarcity |
|
|
40
|
+
| `impulse-shopper` | Consumer | Scarcity, Anchoring, Social Proof | Authority, Commitment |
|
|
41
|
+
| `price-researcher` | Consumer | Anchoring, Scarcity, Social Proof | Authority, Unity |
|
|
42
|
+
| `loyal-customer` | Consumer | Unity, Reciprocity, Default Bias | Scarcity, Novelty |
|
|
43
|
+
| `skeptical-first-timer` | Consumer | Social Proof, Authority, Default Bias | Scarcity, Commitment |
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
### `marketing_campaign_create`
|
|
48
|
+
|
|
49
|
+
**What it does**: Create a multi-variant campaign that tests different page versions across multiple personas.
|
|
50
|
+
|
|
51
|
+
**Why you'd use it**: Set up structured testing to understand which variations work for which audiences.
|
|
52
|
+
|
|
53
|
+
| Parameter | Type | Required | Description |
|
|
54
|
+
|-----------|------|----------|-------------|
|
|
55
|
+
| `name` | string | Yes | Campaign name |
|
|
56
|
+
| `variants` | array | Yes | URLs or descriptions of variants to test |
|
|
57
|
+
| `personas` | array | Yes | Persona IDs to test with |
|
|
58
|
+
| `goal` | string | Yes | What success looks like |
|
|
59
|
+
| `metrics` | array | No | Custom metrics to track |
|
|
60
|
+
|
|
61
|
+
**Example**:
|
|
62
|
+
```json
|
|
63
|
+
{
|
|
64
|
+
"name": "Pricing Page Optimization",
|
|
65
|
+
"variants": [
|
|
66
|
+
{ "name": "Control", "url": "https://example.com/pricing" },
|
|
67
|
+
{ "name": "Social Proof", "url": "https://example.com/pricing-v2" },
|
|
68
|
+
{ "name": "Scarcity", "url": "https://example.com/pricing-v3" }
|
|
69
|
+
],
|
|
70
|
+
"personas": ["enterprise-buyer", "startup-founder", "impulse-shopper"],
|
|
71
|
+
"goal": "Click 'Start Free Trial' button"
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**Returns**: Campaign ID, test matrix (variants × personas), ready for execution.
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
### `marketing_campaign_report_result`
|
|
80
|
+
|
|
81
|
+
**What it does**: Report the result of a journey back to a campaign for aggregation.
|
|
82
|
+
|
|
83
|
+
**Why you'd use it**: After running a cognitive journey for a campaign, log whether it succeeded and what friction was encountered.
|
|
84
|
+
|
|
85
|
+
| Parameter | Type | Required | Description |
|
|
86
|
+
|-----------|------|----------|-------------|
|
|
87
|
+
| `campaignId` | string | Yes | Campaign ID |
|
|
88
|
+
| `variantIndex` | number | Yes | Which variant was tested |
|
|
89
|
+
| `persona` | string | Yes | Persona that ran the journey |
|
|
90
|
+
| `success` | boolean | Yes | Did the persona achieve the goal? |
|
|
91
|
+
| `friction` | array | No | Friction points encountered |
|
|
92
|
+
| `timeToGoal` | number | No | Seconds to achieve goal (if successful) |
|
|
93
|
+
| `abandonmentReason` | string | No | Why they gave up (if unsuccessful) |
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
### `marketing_campaign_run` 🔒 Enterprise
|
|
98
|
+
|
|
99
|
+
**What it does**: Execute a full campaign automatically — runs cognitive journeys for every variant × persona combination.
|
|
100
|
+
|
|
101
|
+
**Why you'd use it**: Hands-off campaign execution that produces complete results without manual orchestration.
|
|
102
|
+
|
|
103
|
+
> **Enterprise Feature** — Requires CBrowser Enterprise.
|
|
104
|
+
> Executes multiple autonomous journeys, consuming significant compute and API resources.
|
|
105
|
+
> [Learn about Enterprise →](/docs/Marketing-Suite/)
|
|
106
|
+
|
|
107
|
+
| Parameter | Type | Required | Description |
|
|
108
|
+
|-----------|------|----------|-------------|
|
|
109
|
+
| `campaignId` | string | Yes | Campaign to run |
|
|
110
|
+
| `variantIndex` | number | No | Run only specific variant |
|
|
111
|
+
| `personaFilter` | array | No | Run only specific personas |
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
### `marketing_influence_matrix` 🔒 Enterprise
|
|
116
|
+
|
|
117
|
+
**What it does**: Generate a matrix showing which influence patterns work for which personas based on campaign results.
|
|
118
|
+
|
|
119
|
+
**Why you'd use it**: Visualize pattern effectiveness at a glance. Know exactly what works for enterprise buyers vs impulse shoppers.
|
|
120
|
+
|
|
121
|
+
> **Enterprise Feature** — Requires CBrowser Enterprise.
|
|
122
|
+
|
|
123
|
+
| Parameter | Type | Required | Description |
|
|
124
|
+
|-----------|------|----------|-------------|
|
|
125
|
+
| `campaignId` | string | Yes | Campaign to analyze |
|
|
126
|
+
|
|
127
|
+
**Returns**: Matrix with personas on one axis, influence patterns on the other, with effectiveness scores.
|
|
128
|
+
|
|
129
|
+
---
|
|
130
|
+
|
|
131
|
+
### `marketing_lever_analysis` 🔒 Enterprise
|
|
132
|
+
|
|
133
|
+
**What it does**: Deep analysis of which psychological levers (scarcity, authority, social proof, etc.) drove behavior for each persona.
|
|
134
|
+
|
|
135
|
+
**Why you'd use it**: Understand *why* certain variants worked, not just *that* they worked.
|
|
136
|
+
|
|
137
|
+
> **Enterprise Feature** — Requires CBrowser Enterprise.
|
|
138
|
+
|
|
139
|
+
| Parameter | Type | Required | Description |
|
|
140
|
+
|-----------|------|----------|-------------|
|
|
141
|
+
| `campaignId` | string | Yes | Campaign to analyze |
|
|
142
|
+
|
|
143
|
+
**Returns**: Lever-by-lever breakdown with evidence from journey traces.
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
### `marketing_funnel_analyze` 🔒 Enterprise
|
|
148
|
+
|
|
149
|
+
**What it does**: Compare conversion funnels across variants — where do people drop off, what's different between successful and failed journeys?
|
|
150
|
+
|
|
151
|
+
**Why you'd use it**: Find the specific step where each persona type struggles.
|
|
152
|
+
|
|
153
|
+
> **Enterprise Feature** — Requires CBrowser Enterprise.
|
|
154
|
+
|
|
155
|
+
| Parameter | Type | Required | Description |
|
|
156
|
+
|-----------|------|----------|-------------|
|
|
157
|
+
| `campaignId` | string | Yes | Campaign to analyze |
|
|
158
|
+
|
|
159
|
+
**Returns**: Funnel visualization per variant, drop-off points, comparison between personas.
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
### `marketing_compete` 🔒 Enterprise
|
|
164
|
+
|
|
165
|
+
**What it does**: Run the same personas through your site and a competitor's site, then compare conversion effectiveness.
|
|
166
|
+
|
|
167
|
+
**Why you'd use it**: Understand why competitors might be converting better for specific audience segments.
|
|
168
|
+
|
|
169
|
+
> **Enterprise Feature** — Requires CBrowser Enterprise.
|
|
170
|
+
|
|
171
|
+
| Parameter | Type | Required | Description |
|
|
172
|
+
|-----------|------|----------|-------------|
|
|
173
|
+
| `yourUrl` | string | Yes | Your site URL |
|
|
174
|
+
| `competitorUrl` | string | Yes | Competitor site URL |
|
|
175
|
+
| `goal` | string | Yes | Goal to compare (e.g., "Sign up for trial") |
|
|
176
|
+
| `personas` | array | No | Which personas to use |
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
### `marketing_audience_discover` 🔒 Enterprise
|
|
181
|
+
|
|
182
|
+
**What it does**: Discover who your site is optimized for by running randomized personas and seeing which ones convert best.
|
|
183
|
+
|
|
184
|
+
**Why you'd use it**: Find out if your site accidentally favors one audience over another.
|
|
185
|
+
|
|
186
|
+
> **Enterprise Feature** — Requires CBrowser Enterprise.
|
|
187
|
+
> Runs many autonomous journeys to build statistical significance.
|
|
188
|
+
|
|
189
|
+
| Parameter | Type | Required | Description |
|
|
190
|
+
|-----------|------|----------|-------------|
|
|
191
|
+
| `url` | string | Yes | URL to analyze |
|
|
192
|
+
| `goal` | string | Yes | Conversion goal |
|
|
193
|
+
| `samples` | number | No | Number of randomized personas. Default: 50 |
|
|
194
|
+
| `maxConcurrency` | number | No | Parallel journey limit. Default: 5 |
|
|
195
|
+
|
|
196
|
+
**Returns**: Job ID for async polling.
|
|
197
|
+
|
|
198
|
+
---
|
|
199
|
+
|
|
200
|
+
### `marketing_discover_status` 🔒 Enterprise
|
|
201
|
+
|
|
202
|
+
**What it does**: Check status of an audience discovery job.
|
|
203
|
+
|
|
204
|
+
**Why you'd use it**: Poll for completion of long-running audience discovery.
|
|
205
|
+
|
|
206
|
+
| Parameter | Type | Required | Description |
|
|
207
|
+
|-----------|------|----------|-------------|
|
|
208
|
+
| `jobId` | string | Yes | Job ID from `marketing_audience_discover` |
|
|
209
|
+
|
|
210
|
+
---
|
|
211
|
+
|
|
212
|
+
### `competitive_benchmark`
|
|
213
|
+
|
|
214
|
+
**What it does**: Compare UX metrics across competitor sites — form friction, cognitive load, navigation clarity, trust signals.
|
|
215
|
+
|
|
216
|
+
**Why you'd use it**: Understand how your UX stacks up against competitors without running full campaigns.
|
|
217
|
+
|
|
218
|
+
| Parameter | Type | Required | Description |
|
|
219
|
+
|-----------|------|----------|-------------|
|
|
220
|
+
| `urls` | array | Yes | URLs to benchmark (your site + competitors) |
|
|
221
|
+
| `metrics` | array | No | Specific metrics to compare |
|
|
222
|
+
|
|
223
|
+
**Example**:
|
|
224
|
+
```json
|
|
225
|
+
{
|
|
226
|
+
"urls": [
|
|
227
|
+
"https://example.com/signup",
|
|
228
|
+
"https://competitor1.com/signup",
|
|
229
|
+
"https://competitor2.com/signup"
|
|
230
|
+
]
|
|
231
|
+
}
|
|
232
|
+
```
|
|
233
|
+
|
|
234
|
+
**Returns**: Ranking, metric scores, specific recommendations.
|
|
235
|
+
|
|
236
|
+
---
|
|
237
|
+
|
|
238
|
+
## Demo vs Enterprise for Marketing
|
|
239
|
+
|
|
240
|
+
| Capability | Demo | Enterprise |
|
|
241
|
+
|------------|------|------------|
|
|
242
|
+
| List marketing personas | ✅ | ✅ |
|
|
243
|
+
| Create campaigns | ✅ | ✅ |
|
|
244
|
+
| Report journey results | ✅ | ✅ |
|
|
245
|
+
| Run campaigns automatically | ❌ | ✅ |
|
|
246
|
+
| Influence matrix analysis | ❌ | ✅ |
|
|
247
|
+
| Lever analysis | ❌ | ✅ |
|
|
248
|
+
| Funnel analysis | ❌ | ✅ |
|
|
249
|
+
| Competitive analysis | ❌ | ✅ |
|
|
250
|
+
| Audience discovery | ❌ | ✅ |
|
|
251
|
+
|
|
252
|
+
**Demo gives you the framework** — create campaigns, run journeys manually with Claude, report results.
|
|
253
|
+
**Enterprise gives you the insights** — automated execution and deep analysis.
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
## Related Documentation
|
|
258
|
+
|
|
259
|
+
- [Marketing Suite](/docs/Marketing-Suite/) — Full marketing capabilities overview
|
|
260
|
+
- [Values Framework](/docs/Values-Framework/) — Schwartz values and motivation
|
|
261
|
+
- [Persona System](/docs/Tools-Persona-System/) — Creating custom personas
|
|
262
|
+
|
|
263
|
+
---
|
|
264
|
+
|
|
265
|
+
*Last updated: v17.6.0*
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
# Tools Reference
|
|
2
|
+
|
|
3
|
+
**Stop writing brittle test scripts. Start having conversations with your browser.**
|
|
4
|
+
|
|
5
|
+
CBrowser provides 82 MCP tools that let Claude automate browsers using natural language. No CSS selectors. No XPath. No "element not found" errors at 3am. Just describe what you want to do, and CBrowser figures out the rest.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## The Problem We Solve
|
|
10
|
+
|
|
11
|
+
Traditional browser automation breaks constantly:
|
|
12
|
+
- **Selectors drift** — A developer changes a CSS class and your entire test suite fails
|
|
13
|
+
- **Timing issues** — Pages load at different speeds, tests randomly fail
|
|
14
|
+
- **Maintenance burden** — You spend more time fixing tests than writing features
|
|
15
|
+
- **No user insight** — Tests tell you if buttons click, not if humans can use your product
|
|
16
|
+
|
|
17
|
+
CBrowser fixes this with AI-powered automation that:
|
|
18
|
+
- **Self-heals** when the DOM changes
|
|
19
|
+
- **Waits intelligently** for content, not arbitrary timeouts
|
|
20
|
+
- **Simulates real users** with patience, frustration, and abandonment
|
|
21
|
+
- **Works through conversation** — describe intent, not implementation
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## Tool Tiers
|
|
26
|
+
|
|
27
|
+
| Tier | Tools | Access | Best For |
|
|
28
|
+
|------|-------|--------|----------|
|
|
29
|
+
| **Demo** | 63 real tools | Free at `demo.cbrowser.ai/mcp` | Evaluation, small projects, learning |
|
|
30
|
+
| **Enterprise** | 82 tools (all Demo + 19 exclusive) | Self-hosted or authenticated | Production use, marketing intelligence, stealth testing |
|
|
31
|
+
|
|
32
|
+
The Demo tier gives you everything you need to automate browsers, run tests, and simulate users. Enterprise adds autonomous AI execution, marketing campaign analysis, and bot detection bypass for authorized testing.
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Tools by Capability
|
|
37
|
+
|
|
38
|
+
### [Browser Automation](/docs/Tools-Browser-Automation/)
|
|
39
|
+
**12 tools** — Navigate, click, fill forms, extract data. The foundation of everything else.
|
|
40
|
+
|
|
41
|
+
*"Click the blue login button"* works better than `document.querySelector('.btn-primary.auth-action.mt-4')`.
|
|
42
|
+
|
|
43
|
+
### [Cognitive Journeys](/docs/Tools-Cognitive-Journeys/)
|
|
44
|
+
**6 tools** — Simulate real users with patience thresholds, frustration tracking, and abandonment detection.
|
|
45
|
+
|
|
46
|
+
Find out where users give up *before* they actually do. A frustrated-first-timer abandons faster than a patient-power-user.
|
|
47
|
+
|
|
48
|
+
### [Persona System](/docs/Tools-Persona-System/)
|
|
49
|
+
**15 tools** — Create and customize personas backed by 25 research-validated cognitive traits.
|
|
50
|
+
|
|
51
|
+
Test as an elderly user with low tech confidence. Or an ADHD user who skims and clicks fast. Or your exact target demographic.
|
|
52
|
+
|
|
53
|
+
### [Testing & Quality](/docs/Tools-Testing-Quality/)
|
|
54
|
+
**7 tools** — Write tests in plain English, auto-repair broken selectors, detect flaky tests, map coverage.
|
|
55
|
+
|
|
56
|
+
*"Go to the checkout page, add a product, verify the cart updates"* — that's a test. No code required.
|
|
57
|
+
|
|
58
|
+
### [Visual & Performance](/docs/Tools-Visual-Performance/)
|
|
59
|
+
**10 tools** — Catch visual regressions, performance degradations, cross-browser issues, and responsive breakage.
|
|
60
|
+
|
|
61
|
+
Know when your staging deploy breaks the hero image on mobile Safari before your users tell you.
|
|
62
|
+
|
|
63
|
+
### [Marketing Intelligence](/docs/Tools-Marketing-Intelligence/)
|
|
64
|
+
**11 tools** — Test which psychological influence patterns work on which audience segments.
|
|
65
|
+
|
|
66
|
+
Does scarcity messaging work on enterprise buyers? (No.) Does social proof work on skeptical first-timers? (Yes.) Now you can measure it.
|
|
67
|
+
|
|
68
|
+
### [Accessibility](/docs/Tools-Accessibility/)
|
|
69
|
+
**1 flagship tool** — Simulate disabilities (motor tremor, low vision, ADHD, color blindness) with WCAG remediation.
|
|
70
|
+
|
|
71
|
+
Stop guessing if your site is accessible. Experience it through the eyes of someone who can't use a mouse.
|
|
72
|
+
|
|
73
|
+
### [Session & State](/docs/Tools-Session-State/)
|
|
74
|
+
**14 tools** — Save sessions, manage browser state, handle Cloudflare challenges (Enterprise), enable stealth mode (Enterprise).
|
|
75
|
+
|
|
76
|
+
Stay logged in across test runs. Bypass bot detection on sites you're authorized to test.
|
|
77
|
+
|
|
78
|
+
### [Utilities](/docs/Tools-Utilities/)
|
|
79
|
+
**6 tools** — Diagnostics, health checks, API key management (Enterprise), agent-readiness audits.
|
|
80
|
+
|
|
81
|
+
Is your site ready for AI agents to navigate it? Get a score and specific recommendations.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## Quick Start
|
|
86
|
+
|
|
87
|
+
**1. Connect to the Demo MCP** (free, rate-limited):
|
|
88
|
+
```
|
|
89
|
+
URL: https://demo.cbrowser.ai/mcp
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
**2. Or run locally** (no rate limits):
|
|
93
|
+
```bash
|
|
94
|
+
npx cbrowser mcp-server
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
**3. Start automating**:
|
|
98
|
+
```
|
|
99
|
+
Navigate to https://example.com
|
|
100
|
+
Click the "Get Started" button
|
|
101
|
+
Fill the email field with "test@example.com"
|
|
102
|
+
Take a screenshot
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
That's it. No setup, no configuration, no selectors.
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Enterprise Features
|
|
110
|
+
|
|
111
|
+
Enterprise adds capabilities that require either:
|
|
112
|
+
- **API credits** (autonomous AI journeys that make decisions)
|
|
113
|
+
- **Security attestation** (stealth/Cloudflare bypass requires domain authorization)
|
|
114
|
+
- **Compute resources** (marketing campaigns that run hundreds of journeys)
|
|
115
|
+
|
|
116
|
+
| Feature | Why It's Enterprise |
|
|
117
|
+
|---------|---------------------|
|
|
118
|
+
| Autonomous Journeys | AI makes decisions, consumes API credits |
|
|
119
|
+
| Marketing Execution | Runs campaigns with real cognitive journeys |
|
|
120
|
+
| Marketing Analysis | Influence matrices, lever analysis, funnel comparison |
|
|
121
|
+
| Stealth Mode | Constitutional bypass requires signed authorization |
|
|
122
|
+
| Cloudflare Handling | Challenge bypass for authorized domains only |
|
|
123
|
+
|
|
124
|
+
**Demo users can still:**
|
|
125
|
+
- Set up marketing campaigns and report results manually
|
|
126
|
+
- Run cognitive journeys with Claude orchestrating (no server-side autonomy)
|
|
127
|
+
- Use all 63 core automation, testing, and persona tools
|
|
128
|
+
|
|
129
|
+
[Contact for Enterprise →](mailto:alexandria.shai.eden@gmail.com)
|
|
130
|
+
|
|
131
|
+
---
|
|
132
|
+
|
|
133
|
+
## Related Documentation
|
|
134
|
+
|
|
135
|
+
- [Getting Started](/docs/Getting-Started/) — Installation and first steps
|
|
136
|
+
- [MCP Server](/docs/MCP-Server/) — Claude Desktop integration
|
|
137
|
+
- [Remote MCP Server](/docs/Remote-MCP-Server/) — claude.ai integration
|
|
138
|
+
- [Examples](/docs/Examples/) — Real-world usage patterns
|
|
139
|
+
- [CLI Reference](/docs/CLI-Reference/) — Command-line usage
|
|
140
|
+
|
|
141
|
+
---
|
|
142
|
+
|
|
143
|
+
*Last updated: v17.6.0*
|