cbrowser 18.63.0 → 18.63.1

package/docs/Tools-Marketing-Intelligence.md

@@ -1,271 +0,0 @@
-> **This documentation is no longer maintained here.**
->
-> For the latest version, please visit: **[Marketing Intelligence Tools](https://cbrowser.ai/docs/Tools-Marketing-Intelligence)**
-
----
-
-# Marketing Intelligence Tools
-
-**Stop guessing which messages work. Start measuring influence.**
-
-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.
-
----
-
-## When to Use These Tools
-
-- **You're optimizing conversion** and want to know which messaging resonates with each audience
-- **You have A/B test fatigue** from inconclusive results because you're testing at the population level, not segment level
-- **You want competitive intelligence** on why competitor sites convert better
-- **You need to prove ROI** on UX investments with actual persona-by-persona data
-
----
-
-## Tools
-
-### `marketing_personas_list`
-
-**What it does**: List available marketing-specific personas with their influence susceptibilities.
-
-**Why you'd use it**: See which audience segments you can test against and what motivates each one.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `category` | string | No | Filter: `b2b`, `consumer`, `all`. Default: `all` |
-
-**Returns**: Personas with descriptions, effective influence patterns, and ineffective patterns.
-
-### Marketing Personas
-
-| Persona | Category | Effective Patterns | Ineffective Patterns |
-|---------|----------|-------------------|---------------------|
-| `enterprise-buyer` | B2B | Authority, Social Proof, Default Bias | Scarcity, Reciprocity |
-| `startup-founder` | B2B | Scarcity, Commitment, Reciprocity | Authority, Default Bias |
-| `procurement-manager` | B2B | Authority, Social Proof, Default Bias | Scarcity, Reciprocity |
-| `technical-evaluator` | B2B | Commitment, Reciprocity | Social Proof, Scarcity |
-| `impulse-shopper` | Consumer | Scarcity, Anchoring, Social Proof | Authority, Commitment |
-| `price-researcher` | Consumer | Anchoring, Scarcity, Social Proof | Authority, Unity |
-| `loyal-customer` | Consumer | Unity, Reciprocity, Default Bias | Scarcity, Novelty |
-| `skeptical-first-timer` | Consumer | Social Proof, Authority, Default Bias | Scarcity, Commitment |
-
----
-
-### `marketing_campaign_create`
-
-**What it does**: Create a multi-variant campaign that tests different page versions across multiple personas.
-
-**Why you'd use it**: Set up structured testing to understand which variations work for which audiences.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `name` | string | Yes | Campaign name |
-| `variants` | array | Yes | URLs or descriptions of variants to test |
-| `personas` | array | Yes | Persona IDs to test with |
-| `goal` | string | Yes | What success looks like |
-| `metrics` | array | No | Custom metrics to track |
-
-**Example**:
-```json
-{
-  "name": "Pricing Page Optimization",
-  "variants": [
-    { "name": "Control", "url": "https://example.com/pricing" },
-    { "name": "Social Proof", "url": "https://example.com/pricing-v2" },
-    { "name": "Scarcity", "url": "https://example.com/pricing-v3" }
-  ],
-  "personas": ["enterprise-buyer", "startup-founder", "impulse-shopper"],
-  "goal": "Click 'Start Free Trial' button"
-}
-```
-
-**Returns**: Campaign ID, test matrix (variants × personas), ready for execution.
-
----
-
-### `marketing_campaign_report_result`
-
-**What it does**: Report the result of a journey back to a campaign for aggregation.
-
-**Why you'd use it**: After running a cognitive journey for a campaign, log whether it succeeded and what friction was encountered.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `campaignId` | string | Yes | Campaign ID |
-| `variantIndex` | number | Yes | Which variant was tested |
-| `persona` | string | Yes | Persona that ran the journey |
-| `success` | boolean | Yes | Did the persona achieve the goal? |
-| `friction` | array | No | Friction points encountered |
-| `timeToGoal` | number | No | Seconds to achieve goal (if successful) |
-| `abandonmentReason` | string | No | Why they gave up (if unsuccessful) |
-
----
-
-### `marketing_campaign_run` 🔒 Enterprise
-
-**What it does**: Execute a full campaign automatically — runs cognitive journeys for every variant × persona combination.
-
-**Why you'd use it**: Hands-off campaign execution that produces complete results without manual orchestration.
-
-> **Enterprise Feature** — Requires CBrowser Enterprise.
-> Executes multiple autonomous journeys, consuming significant compute and API resources.
-> [Learn about Enterprise →](/docs/Marketing-Suite/)
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `campaignId` | string | Yes | Campaign to run |
-| `variantIndex` | number | No | Run only specific variant |
-| `personaFilter` | array | No | Run only specific personas |
-
----
-
-### `marketing_influence_matrix` 🔒 Enterprise
-
-**What it does**: Generate a matrix showing which influence patterns work for which personas based on campaign results.
-
-**Why you'd use it**: Visualize pattern effectiveness at a glance. Know exactly what works for enterprise buyers vs impulse shoppers.
-
-> **Enterprise Feature** — Requires CBrowser Enterprise.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `campaignId` | string | Yes | Campaign to analyze |
-
-**Returns**: Matrix with personas on one axis, influence patterns on the other, with effectiveness scores.
-
----
-
-### `marketing_lever_analysis` 🔒 Enterprise
-
-**What it does**: Deep analysis of which psychological levers (scarcity, authority, social proof, etc.) drove behavior for each persona.
-
-**Why you'd use it**: Understand *why* certain variants worked, not just *that* they worked.
-
-> **Enterprise Feature** — Requires CBrowser Enterprise.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `campaignId` | string | Yes | Campaign to analyze |
-
-**Returns**: Lever-by-lever breakdown with evidence from journey traces.
-
----
-
-### `marketing_funnel_analyze` 🔒 Enterprise
-
-**What it does**: Compare conversion funnels across variants — where do people drop off, what's different between successful and failed journeys?
-
-**Why you'd use it**: Find the specific step where each persona type struggles.
-
-> **Enterprise Feature** — Requires CBrowser Enterprise.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `campaignId` | string | Yes | Campaign to analyze |
-
-**Returns**: Funnel visualization per variant, drop-off points, comparison between personas.
-
----
-
-### `marketing_compete` 🔒 Enterprise
-
-**What it does**: Run the same personas through your site and a competitor's site, then compare conversion effectiveness.
-
-**Why you'd use it**: Understand why competitors might be converting better for specific audience segments.
-
-> **Enterprise Feature** — Requires CBrowser Enterprise.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `yourUrl` | string | Yes | Your site URL |
-| `competitorUrl` | string | Yes | Competitor site URL |
-| `goal` | string | Yes | Goal to compare (e.g., "Sign up for trial") |
-| `personas` | array | No | Which personas to use |
-
----
-
-### `marketing_audience_discover` 🔒 Enterprise
-
-**What it does**: Discover who your site is optimized for by running randomized personas and seeing which ones convert best.
-
-**Why you'd use it**: Find out if your site accidentally favors one audience over another.
-
-> **Enterprise Feature** — Requires CBrowser Enterprise.
-> Runs many autonomous journeys to build statistical significance.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `url` | string | Yes | URL to analyze |
-| `goal` | string | Yes | Conversion goal |
-| `samples` | number | No | Number of randomized personas. Default: 50 |
-| `maxConcurrency` | number | No | Parallel journey limit. Default: 5 |
-
-**Returns**: Job ID for async polling.
-
----
-
-### `marketing_discover_status` 🔒 Enterprise
-
-**What it does**: Check status of an audience discovery job.
-
-**Why you'd use it**: Poll for completion of long-running audience discovery.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `jobId` | string | Yes | Job ID from `marketing_audience_discover` |
-
----
-
-### `competitive_benchmark`
-
-**What it does**: Compare UX metrics across competitor sites — form friction, cognitive load, navigation clarity, trust signals.
-
-**Why you'd use it**: Understand how your UX stacks up against competitors without running full campaigns.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `urls` | array | Yes | URLs to benchmark (your site + competitors) |
-| `metrics` | array | No | Specific metrics to compare |
-
-**Example**:
-```json
-{
-  "urls": [
-    "https://example.com/signup",
-    "https://competitor1.com/signup",
-    "https://competitor2.com/signup"
-  ]
-}
-```
-
-**Returns**: Ranking, metric scores, specific recommendations.
-
----
-
-## Demo vs Enterprise for Marketing
-
-| Capability | Demo | Enterprise |
-|------------|------|------------|
-| List marketing personas | ✅ | ✅ |
-| Create campaigns | ✅ | ✅ |
-| Report journey results | ✅ | ✅ |
-| Run campaigns automatically | ❌ | ✅ |
-| Influence matrix analysis | ❌ | ✅ |
-| Lever analysis | ❌ | ✅ |
-| Funnel analysis | ❌ | ✅ |
-| Competitive analysis | ❌ | ✅ |
-| Audience discovery | ❌ | ✅ |
-
-**Demo gives you the framework** — create campaigns, run journeys manually with Claude, report results.
-**Enterprise gives you the insights** — automated execution and deep analysis.
-
----
-
-## Related Documentation
-
-- [Marketing Suite](/docs/Marketing-Suite/) — Full marketing capabilities overview
-- [Values Framework](/docs/Values-Framework/) — Schwartz values and motivation
-- [Persona System](/docs/Tools-Persona-System/) — Creating custom personas
-
----
-
-*Last updated: v17.6.0*

package/docs/Tools-Overview.md

@@ -1,162 +0,0 @@
-> **This documentation is no longer maintained here.**
->
-> For the latest version, please visit: **[Tools Reference](https://cbrowser.ai/docs/Tools-Overview)**
-
----
-
-# Tools Reference
-
-**Stop writing brittle test scripts. Start having conversations with your browser.**
-
-CBrowser provides 91 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.
-
----
-
-## The Problem We Solve
-
-Traditional browser automation breaks constantly:
-- **Selectors drift** — A developer changes a CSS class and your entire test suite fails
-- **Timing issues** — Pages load at different speeds, tests randomly fail
-- **Maintenance burden** — You spend more time fixing tests than writing features
-- **No user insight** — Tests tell you if buttons click, not if humans can use your product
-
-CBrowser fixes this with AI-powered automation that:
-- **Self-heals** when the DOM changes
-- **Waits intelligently** for content, not arbitrary timeouts
-- **Simulates real users** with patience, frustration, and abandonment
-- **Works through conversation** — describe intent, not implementation
-
----
-
-## Tool Tiers
-
-| Tier | Tools | Access | Best For |
-|------|-------|--------|----------|
-| **Demo** | 108 tools (rate-limited) | Free at `demo.cbrowser.ai/mcp` | Evaluation, small projects, learning |
-| **Enterprise** | 108 tools (all real, unlimited) | Self-hosted or authenticated | Production use, marketing intelligence, stealth testing |
-
-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.
-
----
-
-## Tools by Capability
-
-### [Browser Automation](/docs/Tools-Browser-Automation/)
-**12 tools** — Navigate, click, fill forms, extract data. The foundation of everything else.
-
-*"Click the blue login button"* works better than `document.querySelector('.btn-primary.auth-action.mt-4')`.
-
-### [Cognitive Journeys](/docs/Tools-Cognitive-Journeys/)
-**6 tools** — Simulate real users with patience thresholds, frustration tracking, and abandonment detection.
-
-Find out where users give up *before* they actually do. A frustrated-first-timer abandons faster than a patient-power-user.
-
-### [Persona System](/docs/Tools-Persona-System/)
-**15 tools** — Create and customize personas backed by 25 research-validated cognitive traits.
-
-Test as an elderly user with low tech confidence. Or an ADHD user who skims and clicks fast. Or your exact target demographic.
-
-### [Testing & Quality](/docs/Tools-Testing-Quality/)
-**7 tools** — Write tests in plain English, auto-repair broken selectors, detect flaky tests, map coverage.
-
-*"Go to the checkout page, add a product, verify the cart updates"* — that's a test. No code required.
-
-### [Visual & Performance](/docs/Tools-Visual-Performance/)
-**10 tools** — Catch visual regressions, performance degradations, cross-browser issues, and responsive breakage.
-
-Know when your staging deploy breaks the hero image on mobile Safari before your users tell you.
-
-### [Marketing Intelligence](/docs/Tools-Marketing-Intelligence/)
-**11 tools** — Test which psychological influence patterns work on which audience segments.
-
-Does scarcity messaging work on enterprise buyers? (No.) Does social proof work on skeptical first-timers? (Yes.) Now you can measure it.
-
-### [Accessibility](/docs/Tools-Accessibility/)
-**1 flagship tool** — Simulate disabilities (motor tremor, low vision, ADHD, color blindness) with WCAG remediation.
-
-Stop guessing if your site is accessible. Experience it through the eyes of someone who can't use a mouse.
-
-### [Session & State](/docs/Tools-Session-State/)
-**14 tools** — Save sessions, manage browser state, handle Cloudflare challenges (Enterprise), enable stealth mode (Enterprise).
-
-Stay logged in across test runs. Bypass bot detection on sites you're authorized to test.
-
-### [Utilities](/docs/Tools-Utilities/)
-**6 tools** — Diagnostics, health checks, API key management (Enterprise), agent-readiness audits.
-
-Is your site ready for AI agents to navigate it? Get a score and specific recommendations.
-
----
-
-## Quick Start
-
-**1. Connect to the Demo MCP** (free, rate-limited):
-```
-URL: https://demo.cbrowser.ai/mcp
-```
-
-**2. Or run locally** (no rate limits):
-```bash
-npx cbrowser mcp-server
-```
-
-**3. Start automating**:
-```
-Navigate to https://example.com
-Click the "Get Started" button
-Fill the email field with "test@example.com"
-Take a screenshot
-```
-
-That's it. No setup, no configuration, no selectors.
-
----
-
-## Enterprise Features
-
-Enterprise adds capabilities that require either:
-- **API credits** (autonomous AI journeys that make decisions)
-- **Security attestation** (stealth/Cloudflare bypass requires domain authorization)
-- **Compute resources** (marketing campaigns that run hundreds of journeys)
-
-| Feature | Why It's Enterprise |
-|---------|---------------------|
-| Autonomous Journeys | AI makes decisions, consumes API credits |
-| Marketing Execution | Runs campaigns with real cognitive journeys |
-| Marketing Analysis | Influence matrices, lever analysis, funnel comparison |
-| Stealth Mode | Constitutional bypass requires signed authorization |
-| Cloudflare Handling | Challenge bypass for authorized domains only |
-
-### Enterprise-Only Tools (19 total)
-
-These tools return "Enterprise feature" stubs in Demo and work fully in Enterprise:
-
-| Category | Tools | Why Enterprise |
-|----------|-------|----------------|
-| **API Key Management** (4) | `set_api_key`, `clear_api_key`, `api_key_status`, `get_api_key_prompt` | Manages Anthropic API credentials for server-side AI |
-| **Autonomous Journey** (1) | `cognitive_journey_autonomous` | AI drives browser without human orchestration |
-| **Marketing Execution** (5) | `marketing_campaign_run`, `marketing_influence_matrix`, `marketing_lever_analysis`, `marketing_funnel_analyze`, `marketing_compete` | Runs campaigns with real cognitive journeys |
-| **Marketing Discovery** (2) | `marketing_audience_discover`, `marketing_discover_status` | Long-running audience discovery jobs |
-| **Stealth Mode** (5) | `stealth_status`, `stealth_enable`, `stealth_check`, `stealth_disable`, `stealth_diagnose` | Bot detection bypass requires authorization |
-| **Cloudflare Handling** (2) | `cloudflare_detect`, `cloudflare_wait` | Challenge bypass for authorized domains |
-
-**Demo users can still:**
-- Set up marketing campaigns and report results manually
-- Run cognitive journeys with Claude orchestrating (no server-side autonomy)
-- Use all 72 core automation, testing, and persona tools
-
-[Contact for Enterprise →](mailto:alexandria.shai.eden@gmail.com)
-
----
-
-## Related Documentation
-
-- [Getting Started](/docs/Getting-Started/) — Installation and first steps
-- [MCP Server](/docs/MCP-Server/) — Claude Desktop integration
-- [Remote MCP Server](/docs/Remote-MCP-Server/) — claude.ai integration
-- [Examples](/docs/Examples/) — Real-world usage patterns
-- [CLI Reference](/docs/CLI-Reference/) — Command-line usage
-
----
-
-*Last updated: v18.22.0*