botsee

# BotSee Skill

Monitor your brand's AI visibility (AI SEO/GEO) across ChatGPT, Claude, Perplexity, and Gemini. Provided by botsee.io, the AI Visibility tool for Claude Code and agents.

Commands:

**Workflow:**
- /botsee                                  - Quick status and help
- /botsee signup [--email EMAIL] [--name NAME] [--company COMPANY] [--api-key KEY] - Signup with credit card
- /botsee signup-usdc [--email EMAIL] [--name NAME] [--company COMPANY] [--no-email] - Signup with USDC on Base
- /botsee signup-pay-usdc --amount-cents N [--token TOKEN] [--payment PROOF] - Pay for USDC signup via x402
- /botsee signup-status [--token TOKEN]    - Check signup completion and save API key
- /botsee topup-usdc --amount-cents N [--payment PROOF] - Add credits with USDC on Base via x402
- /botsee create-site <domain> [--types N]   - Save custom config
- /botsee config-show                      - Display saved config
- /botsee analyze                          - Run competitive analysis
- /botsee content                          - Generate blog post from analysis

**Sites:**
- /botsee list-sites             - List all sites
- /botsee get-site [uuid]        - View site details
- /botsee create-site <domain>   - Create a new site
- /botsee archive-site [uuid]    - Archive a site

**Customer Types:**
- /botsee list-types             - List customer types
- /botsee get-type <uuid>        - View type details
- /botsee create-type <name> [desc] - Create customer type
- /botsee generate-types [count] - Generate customer types
- /botsee update-type <uuid> [name] [desc] - Update customer type
- /botsee archive-type <uuid>    - Archive customer type

**Personas:**
- /botsee list-personas [type]   - List personas (all or by type)
- /botsee get-persona <uuid>     - View persona details
- /botsee create-persona <type> <name> [desc] - Create persona
- /botsee generate-personas <type> [count] - Generate personas for type
- /botsee update-persona <uuid> [name] [desc] - Update persona
- /bot...

# BotSee Skill for Claude Code

> Monitor your brand's AI visibility across ChatGPT, Claude, Perplexity, and Gemini.

**Version:** 0.2.4

BotSee is an agent-first API that delivers structured data from every major AI search engine — competitors, keywords, sources, and raw responses — programmatically, from Claude Code.

- Find competitors as AI search engines see them
- Measure share of voice vs competitors
- Identify which sources AI cites for your category
- Uncover exact search queries AI runs for your space
- Generate AI-optimized content from analysis data
- Track visibility over time with historical analysis

## Installation

Copy the entire skill directory to Claude Code:
```bash
# macOS/Linux
cp -r . ~/.claude/skills/botsee
```

Restart Claude Code or reload skills.

## Requirements

- Claude Code
- Python 3 (pre-installed on macOS)

## Quick Start (Credit Card)

```bash
# Step 1: Get signup URL (credit card flow)
/botsee signup

# Step 2: Visit the URL in browser, complete signup

# Step 3: Paste your API key in the chat
# Claude will automatically save it

# Step 4: Create site and generate content
/botsee create-site https://example.com

# Optional: Customize generation counts
/botsee create-site https://example.com --types 3 --personas 2 --questions 10

# Run analysis (~660 credits)
/botsee analyze

# Generate blog post (15 credits)
/botsee content

# Check status and balance
/botsee
```

## Quick Start (USDC on Base)

```bash
# Step 1: Create signup token for USDC flow
/botsee signup --crypto

# Step 2: Initiate USDC payment on Base
/botsee signup-pay-usdc --amount-cents 250 --from-address 0xYOUR_WALLET

# Step 3: Check completion and save API key when ready
/botsee signup-status

# Step 4: Create site and generate content
/botsee create-site https://example.com

# Optional: Customize generation counts
/botsee create-site https://example.com --types 3 --personas 2 --questions 10

# Run analysis (~660 credits)
/botsee analyze

# Generate blog post (15 cr...