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 05 · AI Visibility Audit
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

05

AI Visibility Audit

~25 min

Run a full audit of how AI search engines see a site, identify terminology gaps vs. competitors, and make surgical landing page copy changes to close them.

What you'll end up with

  • → A gap table of terms AI engines use that your site doesn't
  • → Keyword opportunities where your brand is missing or ranks poorly
  • → Source opportunities — sites AI cites when it doesn't mention you
  • → Surgical copy changes to your landing page with before/after diffs
1

Create site and generate structure

# Creates site with customer types, personas, and questions
/botsee create-site https://example.com

Generates 2 customer types, 4 personas, and 20 questions (~75 credits).

2

Review and replace questions

Auto-generated questions are often too generic. Replace them with questions that match how real customers ask AI engines. 

# List questions per persona
/botsee list-questions <persona_uuid>

# Delete generic ones, add targeted ones
/botsee delete-question <question_uuid>
/botsee create-question <persona_uuid> "What tools help with AI search optimization?"
3

Run analysis across all AI engines

    /botsee analyze

Queries ChatGPT, Claude, Perplexity, and Gemini (~660 credits). Capture the analysis UUID from output.

4

Pull keyword and source opportunities

# Queries where your brand is missing or ranks poorly
/botsee results-keyword-opportunities <analysis_uuid>

# Sites AI cites when it doesn't mention you
/botsee results-source-opportunities <analysis_uuid>
5

Compare against live homepage

Agent prompt

"Fetch the live homepage at https://example.com. Compare the language against the keyword opportunities from step 4. Build a gap table showing terms AI engines use that the page doesn't mention — industry acronyms, category names, competitor phrases, audience segments, and integration keywords."

6

Make surgical copy changes

Edit only text strings — no layout changes. Target the title, meta description, hero headline, feature descriptions, and section headers. Insert missing keywords into existing copy rather than rewriting.

Agent prompt

"Using the gap table, make minimal text edits to the landing page template to close terminology gaps. Only change text strings — no structural or layout changes. Show me the proposed changes before editing."

7

Verify and ship

Compile to check for syntax errors, then commit and push when approved.

BotSee Skill shortcut

With the skill installed, run /ai-visibility-audit to execute this entire workflow automatically.

Total cost

~735 credits (~$7.35) — 75 setup + 660 analysis

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