AI Visibility

# AI Visibility

Track and measure how AI platforms talk about your brand. Understand your presence across ChatGPT, Claude, Gemini, and Google AI Overviews.

## When to Use
- User wants to know how AI chatbots describe their brand or products
- User wants to track brand mentions across AI platforms over time
- User wants to measure AI visibility and compare against competitors
- User wants to set up prompts to monitor and collect visibility data regularly

## How It Connects
- **SEO** -- SEO tracks traditional search engine rankings (Google). AI Visibility tracks how AI platforms mention your brand -- they complement each other.
- **Branding** -- Use visibility insights to refine brand positioning. If AI platforms describe you inaccurately, update brand overview and positioning.
- **Analytics** -- Compare AI platform visibility with traditional web traffic and social metrics for a complete picture.

## Quick Start

Start tracking a prompt:
```bash
clawpow geo track "What is the best project management tool?" --json
```

## Commands

### Track Prompt
```bash
clawpow geo track "What is the best project management tool?" --json
```
Add a prompt to monitor across AI platforms. Visibility data is collected automatically via weekly cron or on-demand with `geo collect`.

**Options:**
- `<prompt>` (required, positional) -- The question to track
- `--json` -- Output as JSON

**Returns:** `{"tracked": true, "prompt": "..."}`

### Untrack Prompt
```bash
clawpow geo untrack "What is the best project management tool?" --json
```
Stop tracking a prompt and delete its visibility history.

**Options:**
- `<prompt>` (required, positional) -- The prompt to stop tracking
- `--json` -- Output as JSON

**Returns:** `{"untracked": true, "prompt": "..."}`

### List Prompts
```bash
clawpow geo prompts --json
```
View all tracked prompts.

**Options:**
- `--json` -- Output as JSON

**Returns:** Array of `{_id, prompt, _creationTime}`

### Visibility Snapshot
```bash
clawpow geo snapshot --json
```
View latest AI visibility metrics and per-prompt results. Shows which AI platforms mention your brand and how often.

**Options:**
- `--json` -- Output as JSON

**Returns:** Aggregate visibility score + per-prompt breakdown with platform-level mention data.

### Collect Data
```bash
clawpow geo collect --json
clawpow geo collect --wait --json
```
Run an on-demand AI visibility check across all tracked prompts. Queries each AI platform with your tracked prompts and records whether your brand is mentioned.

**Options:**
- `--wait` -- Wait for collection to complete
- `--json` -- Output as JSON

**Returns:** `{"runId": "...", "status": "queued"}`. This is a queued operation that consumes credits.

## Output Format

All commands support `--json` for structured output. Without `--json`, output is human-readable.

## Important Notes

- Always use `--json` for machine-parseable output
- Track/untrack, list prompts, and snapshot are free operations
- `geo collect` is a paid operation (consumes credits)
- Visibility data is collected automatically by a weekly cron job (Mondays 08:00 UTC)
- Use `geo collect` for on-demand checks between cron runs
- Platforms checked: ChatGPT, Claude, Gemini, Google AI Overviews
- Results show whether your brand is mentioned, quoted, or recommended in AI responses