{
  "markdown": "# BotSee Plugin for Claude Code\n\n> Monitor your brand's AI visibility across ChatGPT, Claude, Perplexity, and Gemini.\n\n**Version:** 0.3.0\n\nBotSee 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 and other AI coding platforms.\n\n- Find competitors as AI search engines see them\n- Measure share of voice vs competitors\n- Identify which sources AI cites for your category\n- Uncover exact search queries AI runs for your space\n- Generate AI-optimized content from analysis data\n- Track visibility over time with historical analysis\n\n## Installation\n\n### Claude Code Plugin (recommended — auto-updates)\n\n```\n/install-plugin https://github.com/RivalSee/botsee\n```\n\n### Direct CLI (Codex, Cursor, any platform)\n\n```bash\ngit clone https://github.com/RivalSee/botsee-skill.git\npython3 botsee-skill/skills/botsee/botsee.py status\n```\n\n## Requirements\n\n- Python 3 (pre-installed on macOS)\n- Claude Code, Codex, or any AI coding agent\n\n## Quick Start (Credit Card)\n\n```bash\n# Step 1: Get signup URL (credit card flow)\n/botsee signup\n\n# Step 2: Visit the URL in browser, complete signup\n\n# Step 3: Paste your API key in the chat\n# Claude will automatically save it\n\n# Step 4: Create site and generate content\n/botsee create-site https://example.com\n\n# Optional: Customize generation counts\n/botsee create-site https://example.com --types 3 --personas 2 --questions 10\n\n# Run analysis (~660 credits)\n/botsee analyze\n\n# Generate blog post (15 credits)\n/botsee content\n\n# Check status and balance\n/botsee\n```\n\n## Quick Start (USDC on Base)\n\n```bash\n# Step 1: Create signup token for USDC flow\n/botsee signup --crypto\n\n# Step 2: Initiate USDC payment on Base\n/botsee signup-pay-usdc --amount-cents 250 --from-address 0xYOUR_WALLET\n\n# Step 3: Check completion and save API key when ready\n/botsee signup-status\n\n# Step 4: Create site and generate content\n/botsee create-site https://example.com\n\n# Optional: Customize generation counts\n/botsee create-site https://example.com --types 3 --personas 2 --questions 10\n\n# Run analysis (~660 credits)\n/botsee analyze\n\n# Generate blog post (15 credits)\n/botsee content\n\n# Check status and balance\n/botsee\n\n# Optional: Top up credits later with USDC\n/botsee topup-usdc --amount-cents 5000 --from-address 0xYOUR_WALLET\n```\n\n## Example Conversational Workflow\n\nUse these natural language prompts to guide Claude through the complete BotSee workflow:\n\n### Prompt 1: Install & Signup\n```\nInstall the BotSee plugin: /install-plugin https://github.com/RivalSee/botsee. Then sign me up for BotSee using my email user@example.com so I can analyze how AI search engines see my product.\n```\n\n### Prompt 2: Create Site with Structure\n```\nCreate a BotSee site for https://myproduct.com with 1 customer type, 2 personas, and 5 questions per persona. Set it up so I can run a competitive analysis.\n```\n\n### Prompt 3: Analyze & Show Competitors\n```\nRun a competitive analysis and show me the full list of competitors mentioned by AI search engines, including their mention percentages and what contexts they appear in.\n```\n\n### Prompt 4: Show Keywords\n```\nShow me all the keywords that AI search engines associate with my product category, sorted by frequency.\n```\n\n### Prompt 5: Generate Blog Titles\n```\nBased on those keywords and competitor insights, give me 5 compelling blog post titles that would help us compete better in AI search results.\n```\n\n### Prompt 6: Write Blog Post\n```\nWrite a full blog post for the first title, including our competitive position, opportunities, threats, and recommended actions based on the analysis data.\n```\n\n**Total cost:** ~725 credits ($7.25 at $0.01/credit) | **Time:** ~15 minutes\n**Output:** Competitor rankings with percentages, keyword frequency analysis, and strategic blog content\n\n## Commands\n\n### Workflow Commands\n\n#### `/botsee`\nShows current status, balance, and available commands.\n\n```\n🤖 BotSee\n━━━━━━━━━━━━━━━\n💰 Credits: 1,250\n🌐 Sites: 1\n🔑 Key: bts_live_abc123...\n```\n\n#### `/botsee signup`\nSignup for BotSee and get your API key.\nDefault behavior is **Signup with Credit Card** (Stripe web flow).\n\n**New user (no API key):**\n```bash\n# Step 1: Get signup URL\n/botsee signup\n\n# Step 2: Visit the URL, complete signup, and paste your API key in the chat\n# Claude will automatically save it for you\n\n# Step 3: Create your site\n/botsee create-site https://example.com\n```\n\nThe signup flow:\n1. Run `/botsee signup` to get your unique signup URL\n2. Visit the URL in your browser and complete signup\n3. Paste your API key in the chat (e.g., \"My API key is bts_live_abc123\")\n4. Claude automatically saves it - you can then run `/botsee create-site`\n\n**Optional contact info:**\n```bash\n/botsee signup --email you@example.com --name \"Your Name\" --company \"Your Company\"\n```\n\nContact fields are optional - the API will use defaults if not provided.\n\n**Existing user (has API key):**\n```bash\n/botsee signup --api-key bts_live_YOUR_KEY\n```\n\nValidates and saves your existing API key.\n\n**Cost:** Free (signup doesn't consume credits)\n\n**Signup with USDC (Base):**\n```bash\n# Create signup token with USDC payment method\n/botsee signup --crypto\n\n# Start USDC payment (Base mainnet)\n/botsee signup-pay-usdc --amount-cents 250 --from-address 0xYOUR_WALLET\n\n# Poll signup status (saves API key on completion)\n/botsee signup-status\n```\n\nNetwork:\n- `base-mainnet` (Chain ID 8453, production)\n\n#### `/botsee signup-pay-usdc`\nInitiate USDC payment for a signup token (`POST /api/v1/signup/:token/pay-usdc`).\n\n```bash\n/botsee signup-pay-usdc --token <setup_token> --amount-cents 5000 --from-address 0xYOUR_WALLET\n```\n\nOptional:\n- `--payment <proof>` x402 `payment` header value when retrying after HTTP 402\n- `--tx-hash 0x...` build transaction-based x402 payload (`txHash`) automatically\n- `--asset USDC` asset value for tx-hash payload (default: `USDC`)\n\nTransaction-hash example:\n```bash\n/botsee signup-pay-usdc --token <setup_token> --amount-cents 5000 --from-address 0xYOUR_WALLET --tx-hash 0xYOUR_TX_HASH\n```\n\n#### `/botsee signup-status`\nCheck signup status and automatically save API key when completed.\n\n```bash\n/botsee signup-status\n/botsee signup-status --token <setup_token>\n```\n\n#### `/botsee topup-usdc`\nAdd credits via USDC on Base (`POST /api/v1/billing/topups/usdc`).\n\n```bash\n/botsee topup-usdc --amount-cents 5000 --from-address 0xYOUR_WALLET\n```\n\nOptional:\n- `--payment <proof>` x402 `payment` header value when retrying after HTTP 402\n- `--tx-hash 0x...` build transaction-based x402 payload (`txHash`) automatically\n- `--asset USDC` asset value for tx-hash payload (default: `USDC`)\n\nTransaction-hash example:\n```bash\n/botsee topup-usdc --amount-cents 5000 --from-address 0xYOUR_WALLET --tx-hash 0xYOUR_TX_HASH\n```\n\n#### `/botsee create-site <domain>`\nCreate site and generate content.\n\n**Requires:** API key from `/botsee signup`\n\n```bash\n/botsee create-site https://example.com\n```\n\nThe create-site command will:\n1. Create a site for the domain\n2. Generate customer types, personas, and questions\n3. Save configuration to workspace and user config\n\n**Customize generation counts:**\n```bash\n/botsee create-site https://example.com --types 3 --personas 2 --questions 10\n```\n\n**Cost:** ~75 credits with defaults (2 types, 2 personas/type, 5 questions/persona)\n- Site creation: 5 credits\n- Customer types: 5 credits per type\n- Personas: 5 credits per persona\n- Questions: 10 credits flat per persona\n\n#### `/botsee create-site <domain>`\nSave custom configuration for later use with setup.\n\n```bash\n# With defaults (2/2/5)\n/botsee create-site https://example.com\n\n# With custom values\n/botsee create-site https://example.com --types 3 --personas 3 --questions 10\n```\n\nSaves to `.context/botsee-config.json`. Setup reads this config automatically.\n\n#### `/botsee config-show`\nDisplay saved workspace configuration.\n\n```\n📋 BotSee Configuration\n━━━━━━━━━━━━━━━━━━━━━\nDomain: https://example.com\nCustomer Types: 2\nPersonas per Type: 2\nQuestions per Persona: 5\n\nReady to run: /botsee setup <domain>\n```\n\n#### `/botsee analyze`\nRuns competitive analysis. Starts the analysis, polls until complete, then displays competitors, keywords, and cited sources.\n\n```\n📊 Top Competitors:\n  1. competitor.com - 45 mentions\n  2. rival.com - 32 mentions\n\n🔑 Top Keywords:\n  • \"best email marketing\" (12x)\n  • \"affordable crm software\" (8x)\n\n📄 Top Sources:\n  • techcrunch.com (5x) ⭐\n  • g2.com (3x)\n\n💰 Remaining: 265 credits\n```\n\n**Cost:** ~660 credits per run (varies by question count and models)\n\n#### `/botsee content`\nGenerates blog post from latest analysis. Auto-saves to `botsee-YYYYMMDD-HHMMSS.md`.\n\n**Cost:** 15 credits\n\n---\n\n### Sites Management\n\n#### `/botsee list-sites`\nList all sites in your account.\n\n```bash\n/botsee list-sites\n```\n\n#### `/botsee get-site [uuid]`\nView details of a specific site. If uuid is omitted, shows the current site from config.\n\n```bash\n/botsee get-site\n/botsee get-site abc-def-123\n```\n\n#### `/botsee create-site <domain>`\nCreate a new site. Saves the new site UUID to config.\n\n```bash\n/botsee create-site https://example.com\n```\n\n**Cost:** 5 credits (auto-generates product_name and value_proposition)\n\n#### `/botsee archive-site [uuid]`\nArchive a site. If uuid is omitted, archives the current site.\n\n```bash\n/botsee archive-site\n/botsee archive-site abc-def-123\n```\n\n---\n\n### Customer Types Management\n\n#### `/botsee list-types`\nList all customer types for the current site.\n\n```bash\n/botsee list-types\n```\n\n#### `/botsee get-type <uuid>`\nView details of a specific customer type.\n\n```bash\n/botsee get-type type-uuid-123\n```\n\n#### `/botsee create-type <name> [description]`\nCreate a new customer type manually.\n\n```bash\n/botsee create-type \"Enterprise Buyers\" \"Large companies seeking solutions\"\n```\n\n**Cost:** 5 credits\n\n#### `/botsee generate-types [count]`\nGenerate customer types using AI. Defaults to 2.\n\n```bash\n/botsee generate-types\n/botsee generate-types 3\n```\n\n**Cost:** 5 credits per type\n\n#### `/botsee update-type <uuid> [--name NAME] [--description DESC]`\nUpdate a customer type.\n\n```bash\n/botsee update-type type-uuid-123 --name \"Enterprise Decision Makers\"\n/botsee update-type type-uuid-123 --description \"C-level executives\"\n```\n\n#### `/botsee archive-type <uuid>`\nArchive a customer type.\n\n```bash\n/botsee archive-type type-uuid-123\n```\n\n---\n\n### Personas Management\n\n#### `/botsee list-personas [type_uuid]`\nList personas. Show all or filter by customer type.\n\n```bash\n/botsee list-personas\n/botsee list-personas type-uuid-123\n```\n\n#### `/botsee get-persona <uuid>`\nView details of a specific persona.\n\n```bash\n/botsee get-persona persona-uuid-456\n```\n\n#### `/botsee create-persona <type_uuid> <name> [description]`\nCreate a new persona manually.\n\n```bash\n/botsee create-persona type-uuid-123 \"Sarah Chen\" \"VP of Marketing at mid-sized SaaS\"\n```\n\n**Cost:** 5 credits\n\n#### `/botsee generate-personas <type_uuid> [count]`\nGenerate personas for a customer type using AI. Defaults to 2.\n\n```bash\n/botsee generate-personas type-uuid-123\n/botsee generate-personas type-uuid-123 3\n```\n\n**Cost:** 5 credits per persona\n\n#### `/botsee update-persona <uuid> [--name NAME] [--description DESC]`\nUpdate a persona.\n\n```bash\n/botsee update-persona persona-uuid-456 --name \"Sarah Chen (CMO)\"\n/botsee update-persona persona-uuid-456 --description \"Chief Marketing Officer\"\n```\n\n#### `/botsee archive-persona <uuid>`\nArchive a persona.\n\n```bash\n/botsee archive-persona persona-uuid-456\n```\n\n---\n\n### Questions Management\n\n#### `/botsee list-questions [persona_uuid]`\nList questions. Show all or filter by persona.\n\n```bash\n/botsee list-questions\n/botsee list-questions persona-uuid-456\n```\n\n#### `/botsee get-question <uuid>`\nView details of a specific question.\n\n```bash\n/botsee get-question question-uuid-789\n```\n\n#### `/botsee create-question <persona_uuid> <question_text>`\nCreate a new question manually.\n\n```bash\n/botsee create-question persona-uuid-456 \"What are the best email marketing tools?\"\n```\n\n#### `/botsee generate-questions <persona_uuid> [count]`\nGenerate questions for a persona using AI. Defaults to 5.\n\n```bash\n/botsee generate-questions persona-uuid-456\n/botsee generate-questions persona-uuid-456 10\n```\n\n**Cost:** 10 credits per generation call (not per question)\n\n#### `/botsee update-question <uuid> <question_text>`\nUpdate a question's text.\n\n```bash\n/botsee update-question question-uuid-789 \"What are the best affordable email marketing tools?\"\n```\n\n#### `/botsee delete-question <uuid>`\nDelete a question permanently.\n\n```bash\n/botsee delete-question question-uuid-789\n```\n\n---\n\n### Results Commands\n\n#### `/botsee results-competitors`\nView competitor analysis results from the latest analysis.\n\n```bash\n/botsee results-competitors\n```\n\n#### `/botsee results-keywords`\nView keyword analysis results from the latest analysis.\n\n```bash\n/botsee results-keywords\n```\n\n#### `/botsee results-sources`\nView source analysis results (which websites cited your site/competitors).\n\n```bash\n/botsee results-sources\n```\n\n#### `/botsee results-responses`\nView all raw AI responses from the latest analysis.\n\n```bash\n/botsee results-responses\n```\n\n#### `/botsee results-keyword-opportunities <analysis_uuid>`\nQuestions where your brand is missing or ranks poorly, with per-provider breakdown showing mention rates, rank positions, and exact keywords each AI used.\n\n```bash\n/botsee results-keyword-opportunities <analysis_uuid>\n/botsee results-keyword-opportunities <analysis_uuid> --threshold 0.8\n/botsee results-keyword-opportunities <analysis_uuid> --rank-threshold 3\n```\n\n- `--threshold` (0.0–1.0, default 1.0): include questions where brand mention rate is below this value\n- `--rank-threshold` (integer): also flag questions where brand appeared but at a rank worse than this\n\n#### `/botsee results-source-opportunities <analysis_uuid>`\nSources AI cited in responses where your brand was NOT mentioned — ideal targets for content and link-building.\n\n```bash\n/botsee results-source-opportunities <analysis_uuid>\n```\n\n## Full CRUD Operations\n\nBotSee skill provides complete CRUD (Create, Read, Update, Delete) operations for all resources:\n\n**Sites:** List, view, create, and archive sites\n**Customer Types:** List, view, create, generate (AI), update, and archive types\n**Personas:** List, view, create, generate (AI), update, and archive personas\n**Questions:** List, view, create, generate (AI), update, and delete questions\n\nYou can:\n- Use the high-level `/botsee setup` command for automatic setup\n- Or manually build your structure using individual CRUD commands\n- View and edit any resource at any time\n- Generate additional resources as needed\n- Customize your analysis by adding/removing questions\n\n## Configuration\n\n**Workspace Config** (`.context/botsee-config.json`):\nSaved by `/botsee create-site`, used by `/botsee setup`:\n```json\n{\n  \"domain\": \"https://example.com\",\n  \"types\": 2,\n  \"personas_per_type\": 2,\n  \"questions_per_persona\": 5\n}\n```\n\n**User Config** (`~/.botsee/config.json`):\nSaved by `/botsee setup` with secure permissions (600):\n```json\n{\n  \"api_key\": \"bts_live_...\",\n  \"site_uuid\": \"...\"\n}\n```\n\n## Example Workflows\n\n### New User Setup\n```bash\n/botsee setup https://www.example.com\n\n# Output:\n🤖 BotSee Setup\n\n📋 Complete signup to get your API key:\n\n   https://botsee.io/setup/abc123...\n\n⏳ Waiting for signup completion...\n✅ Signup complete!\n\nUsing: 2 types, 2 personas/type, 5 questions/persona\n\n⏳ Creating site: https://www.example.com\n✅ Site created: abc-def-123\n\n⏳ Generating 2 customer type(s)...\n📋 Customer Types:\n  • Small Business Owners\n  • Marketing Managers\n\n⏳ Generating personas (2 per type)...\n  ✓ Small Business Owners: 2 persona(s)\n  ✓ Marketing Managers: 2 persona(s)\n✅ Generated 4 persona(s)\n\n⏳ Generating questions (5 per persona)...\n✅ Generated 20 question(s)\n\n✅ Setup complete!\n\nGenerated:\n  • 2 customer type(s)\n  • 4 persona(s)\n  • 20 question(s)\n\n💰 Remaining: 925 credits\n\nNext: /botsee analyze\n```\n\n### Custom Setup\n```bash\n/botsee create-site https://www.example.com --types 3 --personas 3 --questions 10\n/botsee config-show\n/botsee setup https://www.example.com --api-key bts_live_abc123...\n```\n\n### Run Analysis and Generate Content\n```bash\n/botsee analyze\n/botsee content\n```\n\n### View and Edit Personas\n```bash\n# List all personas\n/botsee list-personas\n\n# View specific persona\n/botsee get-persona persona-uuid-456\n\n# Update persona description\n/botsee update-persona persona-uuid-456 --description \"Chief Marketing Officer at enterprise SaaS\"\n\n# List questions for this persona\n/botsee list-questions persona-uuid-456\n\n# Add a new question\n/botsee create-question persona-uuid-456 \"What are the best alternatives to HubSpot?\"\n```\n\n### Manage Customer Types\n```bash\n# List all customer types\n/botsee list-types\n\n# Add a new customer type manually\n/botsee create-type \"Startup Founders\" \"Early-stage founders bootstrapping their companies\"\n\n# Generate personas for the new type\n/botsee generate-personas type-uuid-new 3\n\n# Generate questions for each persona\n/botsee list-personas type-uuid-new\n/botsee generate-questions persona-uuid-1 10\n/botsee generate-questions persona-uuid-2 10\n/botsee generate-questions persona-uuid-3 10\n```\n\n### View Results\n```bash\n# After running analysis, view different result types\n/botsee results-competitors\n/botsee results-keywords\n/botsee results-sources\n/botsee results-responses\n```\n\n### AI Visibility Audit (Full Workflow)\n\nRun a complete AI visibility audit — analyze how AI search engines see a site, identify terminology gaps, and make surgical landing page copy changes.\n\n```bash\n# 1. Create site with customer types, personas, questions\n/botsee create-site https://example.com\n\n# 2. Review and refine auto-generated questions\n/botsee list-questions <persona_uuid>\n/botsee delete-question <question_uuid>\n/botsee create-question <persona_uuid> \"What tools help with AI search optimization?\"\n\n# 3. Run analysis (~660 credits)\n/botsee analyze\n\n# 4. Pull keyword and source opportunities\n/botsee results-keyword-opportunities <analysis_uuid>\n/botsee results-source-opportunities <analysis_uuid>\n\n# 5. Compare opportunities against live homepage copy\n# 6. Make surgical text changes to close terminology gaps\n# 7. Compile, verify, and ship\n```\n\n**Total cost:** ~735 credits (75 setup + 660 analysis) | **Time:** ~25 min\n\nThe `/ai-visibility-audit` skill automates this entire workflow. Install the plugin to use it.\n\n## Configuration Management\n\n### Config Files\n\n**User Config** (`~/.botsee/config.json`)\n- **Purpose:** Stores API key and site UUID\n- **Permissions:** 0o600 (owner read/write only)\n- **Created by:** `/botsee setup` command\n- **Contents:**\n  ```json\n  {\n    \"api_key\": \"bts_live_...\",\n    \"site_uuid\": \"abc-def-123\"\n  }\n  ```\n\n**Workspace Config** (`.context/botsee-config.json`)\n- **Purpose:** Stores generation defaults (types/personas/questions)\n- **Permissions:** Standard file permissions\n- **Created by:** `/botsee create-site` command (optional)\n- **Contents:**\n  ```json\n  {\n    \"domain\": \"https://example.com\",\n    \"types\": 2,\n    \"personas_per_type\": 2,\n    \"questions_per_persona\": 5\n  }\n  ```\n\n### Managing Configs\n\n**View current configuration:**\n```bash\n/botsee                    # Show status + API key suffix\n/botsee config-show        # Show workspace config\n```\n\n**Edit configuration:**\n```bash\n# Workspace config (generation counts)\n/botsee create-site <domain> --types 3 --personas 3 --questions 10\n\n# User config (API key + site)\n/botsee setup <domain> --api-key <new_key>\n```\n\n**Manual editing:**\n- User config: Edit `~/.botsee/config.json` (must maintain 0o600 permissions)\n- Workspace config: Edit `.context/botsee-config.json`\n\n**Reset configuration:**\n```bash\nrm ~/.botsee/config.json        # Remove user config\nrm .context/botsee-config.json  # Remove workspace config\n/botsee setup <domain>          # Start fresh\n```\n\n---\n\n## Troubleshooting\n\n### Authentication Issues\n\n**\"Invalid API key\"**\n- **Cause:** API key expired or incorrect\n- **Solution:** Run `/botsee setup <domain>` to create new account or use `--api-key` with valid key\n- **Check:** API key should start with `bts_live_` or `bts_test_`\n\n**\"No BotSee config found\"**\n- **Cause:** Missing `~/.botsee/config.json` file\n- **Solution:** Run `/botsee setup <domain>` to initialize configuration\n\n### Credit Issues\n\n**\"Insufficient credits\"**\n- **Cause:** Account balance too low\n- **Solution:** Use `/botsee topup-usdc --amount-cents 250 --from-address 0x...` or add credits at https://botsee.io/billing\n- **Check:** Run `/botsee` to view current balance\n\n**Analysis uses more credits than expected**\n- **Cause:** More questions generated than planned\n- **Check:** Run `/botsee list-questions` to count total questions\n- **Solution:** Reduce question count or delete unnecessary questions\n\n**\"HTTP 402 Payment required\"**\n- **Cause:** Endpoint requires x402 payment proof or account has insufficient credits\n- **Solution:** Top up with `/botsee topup-usdc ...` and retry\n- **Optional:** Retry USDC payment endpoints with `--payment <proof>` to send x402 `payment` header\n\n### Connection Issues\n\n**\"Connection error\"**\n- **Cause:** Network connectivity or API downtime\n- **Solution:**\n  - Check internet connection\n  - Verify https://botsee.io is accessible\n  - API calls timeout after 30 seconds - retry for transient errors\n\n**\"SSL certificate verification failed\"**\n- **Cause:** Corporate proxy or outdated CA certificates\n- **Solution:** Update system certificates or check proxy settings\n\n### Setup Issues\n\n**Signup times out**\n- **Cause:** Didn't complete browser signup within 5 minutes\n- **Solution:** Run `/botsee setup <domain>` again to get new signup URL\n\n**\"Site creation failed\"**\n- **Cause:** Invalid domain format or duplicate site\n- **Solution:**\n  - Ensure domain starts with `https://`\n  - Check `/botsee list-sites` for existing sites\n  - Domain may already be registered to another account\n\n### Analysis Issues\n\n**Analysis takes too long**\n- **Normal:** Analysis can take 5-10 minutes depending on question count\n- **Timeout:** Commands timeout after 10 minutes\n- **Solution:** Reduce number of questions if analysis consistently times out\n\n**\"No analysis found\"**\n- **Cause:** Haven't run `/botsee analyze` yet\n- **Solution:** Run analysis first, then generate content\n\n**Missing analysis UUID**\n- **Cause:** Analysis UUID not captured from analyze command output\n- **Where to find:** Look for line `📊 Analysis started: abc-def-123`\n- **Solution:** Re-run `/botsee analyze` and copy the UUID from output\n\n## Credits & Costs\n\n**Credit rate:** 1 credit = $0.01 USD | **Minimum purchase:** $20 (2,000 credits) | All CRUD operations are free\n\n### Setup (one-time with defaults)\n- Site creation: **5 credits**\n- Generate 2 customer types: **10 credits** (5 each)\n- Generate 4 personas: **20 credits** (5 each)\n- Generate questions (4 calls): **40 credits** (10 per call, not per question)\n- **Total:** ~75 credits\n\n### Individual Operations\n\n**Sites:**\n- **Create site:** 5 credits (auto-generates product_name/value_proposition)\n\n**Customer Types:**\n- **Create customer type (manual):** 5 credits\n- **Generate customer types (AI):** 5 credits **per type** generated\n\n**Personas:**\n- **Create persona (manual):** 5 credits\n- **Generate personas (AI):** 5 credits **per persona** generated\n\n**Questions:**\n- **Create question (manual):** Free\n- **Generate questions (AI):** 10 credits **per API call**\n  - Each call generates multiple questions (default: 5)\n  - Cost is per generation call, **not** per question\n  - Example: Generating 5 questions = 10 credits (one call)\n  - Example: Generating 10 questions for 4 personas = 40 credits (4 calls, one per persona)\n\n**Analysis & Content:**\n- **Analysis (per run):** ~660 credits (varies by question count and AI models used)\n- **Content generation:** 15 credits\n\n### Credit Cost Clarification\n\n**\"Per type\" vs \"Per call\":**\n- **Per type/persona:** Each individual resource costs credits\n  - Generate 3 types = 15 credits (3 × 5)\n  - Generate 4 personas = 20 credits (4 × 5)\n\n- **Per call (questions only):** Cost is for the API call, not individual questions\n  - One call generates multiple questions (you specify count: 3-10)\n  - Cost: 10 credits regardless of how many questions generated in that call\n  - Setup calls generate-questions once per persona, so 4 personas = 40 credits (4 calls)\n\n### Example Workflows\n- **First complete workflow** (setup + analysis + content): ~750 credits\n- **Add new customer type with 3 personas (10 questions each):**\n  - Create type: 5 credits\n  - Generate 3 personas: 15 credits\n  - Generate questions (3 calls): 30 credits\n  - **Total:** 50 credits\n\n## License\n\nMIT License - see LICENSE file\n\n## Support\n\n- Documentation: https://botsee.io/docs\n- Issues: https://github.com/rivalsee/botsee-skill/issues\n",
  "bytes": 24855,
  "sha": "42c0742f721184effaa7b7861620fcd6ce5906e9653e8954c7f0c5a6f2c1e54c",
  "repo_slug": "rivalsee/botsee-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_rivalsee_botsee_skill_botsee_skill_bfe73025/readme"
}