BotSights Documentation
Welcome to BotSights — track how AI chatbots, search engines, and social platforms interact with your website.
What is BotSights?
BotSights gives you visibility into the bots and AI agents visiting your website. Understand which AI models cite your content, which search engines crawl your pages, and how your content is shared on social platforms.
Key Features
- AI & LLM Citation Tracking — See when ChatGPT, Claude, Perplexity, and other AI chatbots cite your content
- AI Click Tracking — Track human visitors clicking through from AI platforms to your site
- Search Engine Crawler Monitoring — Monitor Googlebot, Bingbot, and other search crawlers
- Social Share Detection — Track shares on WhatsApp, LinkedIn, Facebook, and more
- Real-time Dashboard — Live feed of all bot activity on your website
- Bot & Page Detail Views — Drill down into individual bot or page activity
- CSV & JSON Export — Download your data for custom analysis
Getting Started
- Create an account and set up your first project
- Install one of our integrations (see below)
- Visit your website and check the dashboard — data appears within seconds
Integrations
Connect your website using the integration that matches your stack:
Platform / Edge
| Integration | Best for | Setup time |
|---|---|---|
| WordPress | WordPress sites | 2 minutes |
| Cloudflare Worker | Any site on Cloudflare (all plans) | 5 minutes |
| Cloudflare Logpush | Cloudflare Enterprise | 10 minutes |
Backend
| Integration | Best for | Setup time |
|---|---|---|
| Node.js | Express, Next.js, Fastify | 2 minutes |
| Python | Django, Flask, FastAPI | 2 minutes |
| PHP | Laravel, plain PHP | 2 minutes |
All integrations are server-side — they capture every visitor including bots that don’t execute JavaScript. No cookies are set, no client-side code is loaded.
Dashboard
Once connected, your dashboard provides:
- Overview — Hero metrics, category breakdown, bot activity over time
- AI & LLM — AI citations, clicks from AI platforms, training crawlers
- Search Engines — Crawl patterns, top crawled pages, crawler trends
- Social — Shares and clicks per platform
- Export — Download data as CSV or JSON
Need Help?
Check the guides in the sidebar or contact us at hello@botsights.com.