Skip to main content

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
Botnadzor helps users identify these accounts by analyzing suspicious patterns and providing transparency about account registration dates and activity.

​
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. 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.

​
Open Source

Botnadzor is open source under the BSD-3-Clause license. The source code is available on GitHub, and contributions are welcome. Learn more about the Botnadzor project at botnadzor.org/docs.