Skip to main content

​
Overview

This guide will walk you through setting up OpenSight and monitoring your first brand across AI search engines. By the end, you’ll have:
  • Created an OpenSight account
  • Added your first brand
  • Configured monitoring prompts
  • Set up competitor tracking
  • Viewed your first AI visibility dashboard
Prefer to self-host? Check out our installation guide for Docker deployment instructions.

​
Step 1: Create Your Account

1

Sign up

Visit opensight.dev and click Get Started to create your account.You can sign up with:
  • Email and password
  • GitHub OAuth
  • Google OAuth
2

Verify your email

Check your inbox for the verification email and click the confirmation link.

​
Step 2: Add Your First Brand

Once logged in, you’ll be guided through the onboarding flow to create your first brand.
1

Enter brand details

Provide your brand information:
  • Brand Name: Your company or product name
  • Website URL: Your primary website (must be a valid URL)
  • Industry: Select your industry from the dropdown (optional)
// Example brand data
{
  name: "Acme Corp",
  website_url: "https://acme.com",
  industry: "saas"
}
2

Select analysis prompts

Choose from 20+ pre-generated prompts or add your own custom prompts. These are the questions OpenSight will ask AI engines about your brand.Example prompts:
  • “What are the best project management tools for remote teams?”
  • “How does [Your Brand] compare to competitors?”
  • “What are customers saying about [Your Brand]?”
Start with 5-10 prompts that represent the most common questions your potential customers ask.
3

Add competitors (optional)

Add up to 5 competitors to track alongside your brand:
  • Competitor name
  • Website URL
You can skip this step and add competitors later from the dashboard.
4

Review and confirm

Review your setup and click Start Analysis to begin monitoring.OpenSight will immediately start:
  • Querying AI engines with your prompts
  • Analyzing sentiment and positioning
  • Building your visibility baseline
Initial analysis typically completes within 5-10 minutes. You’ll receive a notification when your first results are ready.

​
Step 3: Explore Your Dashboard

Once the initial analysis completes, you’ll see your AI visibility dashboard.

​
Overview Metrics

Your dashboard displays four key metrics:
  • Overall Score: Aggregate visibility score (0-100%)
  • Total Mentions: Number of times AI engines mentioned your brand
  • Positive Sentiment: Percentage of positive mentions
  • Active Prompts: Number of prompts being monitored
// Dashboard data structure
{
  overallScore: 85.4,
  totalMentions: 142,
  sentimentBreakdown: {
    positive: 78.5,
    neutral: 15.3,
    negative: 6.2
  },
  totalPromptsChecked: 10
}

​
Engine Performance

See how your brand performs across each AI engine:
  • ChatGPT: GPT-4 responses
  • Perplexity: Real-time search results
  • Google AI: AI Overview appearances

​
Visibility Timeline

Track your visibility trends over time with interactive charts showing:
  • Daily mention frequency
  • Sentiment shifts
  • Competitor comparisons

​
Step 4: Monitor Competitors

If you added competitors during onboarding, navigate to Dashboard > Competitors to see:

Side-by-Side Comparison

Compare mention frequency, sentiment, and visibility scores with competitors.

Position Tracking

See where you rank in AI responses compared to competitors.

Feature Mentions

Track which features AI engines mention most for each competitor.

Trend Analysis

Identify when competitors gain or lose visibility relative to your brand.

​
Step 5: Set Up Alerts

Stay informed about important changes with automated alerts.
1

Navigate to Settings

Go to Settings > Notifications to configure alert preferences.
2

Enable alert types

Choose which events trigger notifications:
  • Visibility Drop: Alert when your mention frequency decreases
  • Sentiment Shift: Notify on significant sentiment changes
  • New Competitor: Alert when a new competitor appears in responses
  • New Mention: Notify on every new brand mention (high volume)
3

Configure delivery

Set how you receive alerts:
  • Email Frequency: Instant, Daily Digest, or Weekly Summary
  • Webhook URL: Send alerts to your preferred tools (Slack, Discord, etc.)
Webhook integration requires a Growth plan or higher.

​
Step 6: Analyze Content Performance

Use the Content Scoring feature to optimize specific pages for AI visibility.
1

Navigate to Content Score

Go to Dashboard > Content Score in the sidebar.
2

Submit a URL

Enter a URL from your website to analyze:
// Example: Analyze your homepage
url: "https://acme.com"
3

Review your score

OpenSight analyzes your content and provides:
  • Overall Score: 0-100 rating
  • Dimension Breakdown: Scores for relevance, authority, clarity, etc.
  • Recommendations: Prioritized actions to improve AI visibility
{
  "totalScore": 78,
  "dimensions": [
    { "name": "Relevance", "score": 85 },
    { "name": "Authority", "score": 72 },
    { "name": "Clarity", "score": 80 },
    { "name": "Structure", "score": 75 }
  ],
  "recommendations": [
    {
      "dimension": "Authority",
      "action": "Add more authoritative backlinks",
      "severity": "high"
    }
  ]
}
4

Implement recommendations

Follow the actionable recommendations to improve your score. Track improvements by re-analyzing the URL after changes.

​
Step 7: Access the API (Optional)

Integrate OpenSight data into your existing workflows with our REST API.
1

Generate an API key

Go to Settings > API Keys and click Create API Key.
API keys are only shown once. Store your key securely.
2

Make your first request

Use your API key to fetch brand data:
curl -X GET "http://localhost:4000/api/brands" \
  -H "Authorization: Bearer YOUR_API_KEY"
Example response:
[
  {
    "id": "brand_123",
    "name": "Acme Corp",
    "website_url": "https://acme.com",
    "industry": "saas",
    "created_at": "2026-03-03T10:00:00Z"
  }
]
3

Explore API endpoints

Check out the API Reference for complete documentation of all available endpoints.

​
What’s Next?

Now that you’ve set up your first brand, explore these advanced features:

Advanced Prompts

Create sophisticated monitoring prompts with tags and categories.

Team Collaboration

Invite team members and manage permissions.

Webhook Integration

Connect OpenSight to Slack, Discord, or custom webhooks.

Notifications

Configure alerts and email notifications.

​
Troubleshooting

Initial analysis can take 5-10 minutes depending on the number of prompts. If it takes longer:
  • Check the status indicator in the dashboard
  • Ensure your prompts are clearly worded
  • Contact support if stuck for more than 15 minutes
This could mean:
  • Your brand is new and not yet indexed by AI engines
  • Your prompts aren’t relevant to your brand
  • Try broader prompts or industry-specific questions
  • Add more context to your brand profile
Use the brand selector in the top navigation bar to switch between brands. Your dashboard will update to show the selected brand’s data.
Yes! Go to Dashboard > Prompts to add, edit, or delete monitoring prompts at any time.

​
Need Help?

Documentation

Explore detailed feature documentation.

GitHub Issues

Report bugs or request features.

Build docs developers (and LLMs) love

Get started for freeTalk to us