Documentation Index
Fetch the complete documentation index at: https://mintlify.com/botnadzor/extension/llms.txt
Use this file to discover all available pages before exploring further.
Introduction
Botnadzor is a browser extension that highlights bots and fake accounts on vk.com and VK-related sites. The name “Ботнадзор” (Botnadzor) combines “бот” (bot) and “надзор” (supervision), reflecting its mission to help users identify suspicious accounts and bot activity on VK. The extension provides real-time bot detection and account analysis tools to help users recognize and report fake accounts, making VK communities safer and more authentic.What Problem Does It Solve?
VK, like many social platforms, faces challenges with bot accounts and fake profiles that:- Spread misinformation and spam
- Manipulate discussions with coordinated activity
- Create false engagement on posts and comments
- Impersonate real users
Key Features
Bot Highlighting
Automatically highlights known bots and suspicious accounts directly on VK pages, making them immediately visible in comments, posts, and discussions.
Account Inspector
Built-in inspector tool that allows you to examine suspicious account activity patterns, helping you identify potential bots yourself.
Registration Date Lookup
Quickly check when any VK account was created. Newly created accounts engaging in suspicious activity are often bots.
Bot Card Insertion
Simplifies inserting bot information cards in reply to bot comments, helping inform other users about fake accounts.
Report Suspicious Accounts
Submit suspicious accounts directly to Botnadzor administrators for verification and analysis.
Multi-Site Support
Works across all VK platforms and even on archived pages for historical bot analysis.
Supported Platforms
Botnadzor works on the following sites:- vk.com (desktop and mobile versions: m.vk.com)
- vk.ru (desktop and mobile versions: m.vk.ru)
- vkvideo.ru (desktop and mobile versions: m.vkvideo.ru)
- web.archive.org (for analyzing historical VK pages)
Technology Stack
The extension is built with modern web technologies:- WXT - Browser extension framework
- React - UI framework with React Compiler
- TypeScript - Type-safe JavaScript
- TailwindCSS - Utility-first CSS framework
- Shadcn UI and Radix UI - UI component libraries
- Zod - Schema validation
- Dexie - IndexedDB wrapper for data storage
- ORPC - Type-safe RPC communication
Architecture Overview
The extension has three main entry points:Background Service Worker
Registers services, manages extension data, and handles configuration. Acts as the central hub for communication between different parts of the extension.Content Script
Modifies the DOM on VK pages through an insertion system - modular DOM modifications with automatic cleanup. This is what highlights bots and adds UI elements to VK pages.Popup
Displays the extension menu with settings, announcements, and statistics about detected bots. Communication between these components is handled through the@webext-core/proxy-service library, enabling type-safe service proxying.