Workflows

BotSee Recipes

Step-by-step workflows for the most common BotSee use cases. Copy the steps, run them with your agent, and ship faster.

01 · Quick Start 02 · AI Visibility Blog Content 03 · Persona & ICP Generation 04 · Competitor Discovery
01

Quick Start

~5 min

Install BotSee and run your first AI visibility analysis in plain English — no API calls needed. Run on Claude Code, Codex or OpenClaw.

1

Install the BotSee plugin

Copy this and paste it to your agent (Claude Code, Codex, OpenClaw, Cursor, etc.): 
# Claude Code
/install-plugin https://github.com/RivalSee/botsee and then run signup

# Other platforms (Codex, OpenClaw, Cursor, etc.)
Go to https://github.com/RivalSee/botsee-skill.git and install the BotSee plugin
2

"Botsee, analyze this site for AI visibility: granola.ai"

You say

Botsee, analyze this site for AI visibility: granola.ai

BotSee responds

AI Visibility Score: 34/100 — granola.ai appears in 12 of 60 queries across ChatGPT, Claude, Perplexity, and Gemini.

ChatGPT 4 / 15 responses
Claude 2 / 15 responses
Perplexity 5 / 15 responses
Gemini 1 / 15 responses

Appearing on: "AI meeting notes app", "meeting recorder with transcription"

Missing from: "best AI notetaker for Zoom", "automatic meeting summary tool", "meeting notes for remote teams"

3

"Botsee, how does our brand compare against competitors?"

You say

Botsee, how does our brand compare against competitors?

BotSee responds

Share of voice — AI meeting tools category (60 queries):

Brand Share of voice Queries
Otter.ai 82% 49/60
Fireflies.ai 71% 43/60
Notion AI 48% 29/60
granola.ai ← you 20% 12/60
Read.ai 18% 11/60

You're most competitive on Perplexity. Weakest on Gemini — Fireflies.ai also drops off there, which is an opening.

4

"Botsee, what are your recommendations to improve AI visibility?"

You say

Botsee, what are your recommendations to improve AI visibility?

BotSee responds

1. Target "best AI notetaker for Mac" — high-volume query, no dominant result yet. Granola's native Mac app is a natural fit.
2. Get cited by The Verge, TechCrunch, and Product Hunt — these are the top 3 sources AI references in this category.
3. Publish "Granola vs. Otter.ai" — positions you on head-to-head comparison queries where Otter currently wins unopposed.
4. Create content around "AI meeting notes + action items" — clear gap in current AI answers, no strong source cited.
5

"Botsee, write content that can improve my site's AI visibility"

You say

Botsee, write content that can improve my site's AI visibility

BotSee responds

Here's a draft targeting your top visibility gap:

"The Best AI Meeting Notetaker for Mac in 2025"

Granola is the only AI meeting notes app built natively for Mac — no browser extension, no cloud upload, no third-party bot joining your calls...

Sections to include:

→ How Granola works vs. cloud-based recorders (local privacy angle)

→ Comparison: Granola vs. Otter.ai vs. Fireflies

→ Action items and follow-ups walkthrough

This post targets 3 of your top 5 visibility gaps. Publish and re-run analysis in 2 weeks to measure lift.

02

AI Visibility Blog Content

~15 min

Generate blog posts that target gaps in your AI search visibility — based on what keywords and sources actually appear in AI answers for your category.

What you'll end up with

  • → Keywords AI associates with your product category (ranked by frequency)
  • → A list of sources AI cites — your editorial targets
  • → Draft blog posts your agent can generate from those insights
1

Sign up and get your API key

Visit /docs and follow the setup guide. Complete payment via Stripe. Your API key arrives via webhook (or from the dashboard once logged in).
2

Create a site for your domain

curl -X POST https://botsee.io/api/v1/sites \
  -H "Authorization: Bearer bts_live_..." \
  -d '{"domain":"acme.com","product_name":"Acme CRM"}'
3

Generate 2 personas

# Save site_uuid from step 2 response
curl -X POST https://botsee.io/api/v1/sites/$SITE_UUID/customer-types/generate \
  -H "Authorization: Bearer bts_live_..."

# Use customer_type_uuid from above response
curl -X POST https://botsee.io/api/v1/customer-types/$CT_UUID/personas/generate \
  -H "Authorization: Bearer bts_live_..." \
  -d '{"count":2,"questions_per_persona":3}'
4

Run analysis across all LLMs

curl -X POST https://botsee.io/api/v1/analysis \
  -H "Authorization: Bearer bts_live_..." \
  -d '{"site_uuid":"...","scope":"site"}'

Analysis runs async. Poll GET /api/v1/analysis/:uuid until status: "completed" (typically 30s–5min).

5

Harvest keywords and sources

# Keywords AI associates with your category
curl https://botsee.io/api/v1/analysis/:uuid/keywords \
  -H "Authorization: Bearer bts_live_..."

# Sources AI cites (your editorial targets)
curl https://botsee.io/api/v1/analysis/:uuid/sources \
  -H "Authorization: Bearer bts_live_..."
6

Generate blog posts with your agent

Feed the keywords and sources to your writing agent:

Agent prompt

"Write a 1,200-word blog post targeting these AI visibility keywords: [paste keywords]. Reference these sources as authority signals: [paste sources]. The post should position [YOUR_PRODUCT] as the answer to the primary question AI uses to trigger competitor mentions."

See the full content workflow guide in Docs → Skill Workflows → Content.

03

Persona & ICP Generation

~10 min

Auto-generate structured ICP personas and customer types for any company — your own or a competitor's. Export them as full write-ups in minutes.

What you'll end up with

  • → AI-generated ICP customer types (demographics, industry, company size)
  • → Detailed persona write-ups with pain points, buying triggers, and objections
  • → Structured JSON you can feed to downstream agents or export to your CRM
1

Sign up and get your API key

Visit /docs to complete setup. You can use BotSee for any domain — including competitor domains.
2

Create a site for any domain

curl -X POST https://botsee.io/api/v1/sites \
  -H "Authorization: Bearer bts_live_..." \
  -d '{"domain":"competitor.com"}'

Works for any domain. BotSee infers the product and company context automatically.

3

Generate customer types

curl -X POST https://botsee.io/api/v1/sites/$SITE_UUID/customer-types/generate \
  -H "Authorization: Bearer bts_live_..." \
  -d '{"count":3}'
4

Generate personas with questions

curl -X POST https://botsee.io/api/v1/customer-types/$CT_UUID/personas/generate \
  -H "Authorization: Bearer bts_live_..." \
  -d '{"count":3,"questions_per_persona":3}'

Use the customer_type_uuid from step 3's response.

5

List and view personas

# Use customer_type_uuid from step 3 response
curl https://botsee.io/api/v1/customer-types/$CT_UUID/personas \
  -H "Authorization: Bearer bts_live_..."

Returns all personas for this customer type.

6

Expand with your agent

Feed the structured persona data to your agent:

Agent prompt

"Expand this persona into a full ICP write-up: [paste persona JSON]. Include demographics, psychographics, top 3 pain points, buying triggers, key objections, and preferred channels. Format as a structured marketing brief."

BotSee Skill shortcut

If you have the BotSee skill installed: /botsee setup competitor.com then /botsee personas

04

Competitor Discovery

~20 min

Find every company AI recommends instead of you — ranked by how often they appear across ChatGPT, Claude, Perplexity, and Gemini.

What you'll end up with

  • → A ranked list of competitors with mention counts per LLM
  • → Whether your own brand appeared in AI responses
  • → A competitive landscape summary your agent can write from the data
1

Sign up and get your API key

Visit /docs to complete setup and get your API key.
2

Create a site and generate customer types

# Create the site
curl -X POST https://botsee.io/api/v1/sites \
  -H "Authorization: Bearer bts_live_..." \
  -d '{"domain":"acme.com"}'

# Auto-generate customer types
curl -X POST https://botsee.io/api/v1/sites/$SITE_UUID/customer-types/generate \
  -H "Authorization: Bearer bts_live_..."
3

Run site-wide analysis

curl -X POST https://botsee.io/api/v1/analysis \
  -H "Authorization: Bearer bts_live_..." \
  -d '{"site_uuid":"...","scope":"site"}'

Queries ChatGPT, Claude, Perplexity, and Gemini in parallel. Wait for status: "completed" before fetching results.

4

Fetch competitor data

curl https://botsee.io/api/v1/analysis/:uuid/competitors \
  -H "Authorization: Bearer bts_live_..."
// Example response
{
  "by_customer_type": [
{
  "customer_type_name": "Enterprise IT Directors",
  "competitors": [
    {"name": "Salesforce", "mentions": 8, "appearance_percentage": 80.0},
    {"name": "HubSpot", "mentions": 5, "appearance_percentage": 50.0}
  ],
  "total_unique_competitors": 5
}
],
  "overall_summary": {
"total_unique_competitors": 15,
"own_company_mentioned": true,
"total_responses_analyzed": 50
}
}
5

Write a competitive landscape with your agent

Agent prompt

"Given this competitor data from AI search engines: [paste data from data["overall_summary"] and data["by_customer_type"]]. Write a competitive landscape summary. Flag any companies with more than 5 mentions that we haven't analyzed yet. Suggest which competitors to add to our battlecard first."

BotSee Skill shortcut

With the skill installed: /botsee analyze then /botsee competitors

Ready to run your first recipe?

All recipes work with the REST API or the BotSee Claude/Cursor skill. Start with the docs.

Read the Docs View API Reference