Перейти к содержанию

Как это работает

Общая идея

На сервере работает настоящий аккаунт Telegram. Когда ты отправляешь запрос через API, происходит следующее:

  1. API проверяет что у тебя есть доступ (по токену)
  2. Telegram аккаунт пишет сообщение OSINT-боту (как если бы ты сам написал)
  3. Бот отвечает кнопками — API автоматически нажимает нужную
  4. Бот присылает результат (текст и файлы)
  5. Всё собирается в один ответ и отправляется тебе

Автоматическое нажатие кнопок

Telegram боты работают через кнопки. Например, когда ищешь по номеру телефона, бот сначала спрашивает "в каком направлении искать":

  • "Базовый поиск"
  • "Telegram"
  • "ВК"

Vektor API автоматически нажимает "Базовый поиск" и собирает полный ответ. Тебе не нужно делать это вручную.

Если хочешь получить только список кнопок без автоматического нажатия — передай auto_click: false в запросе.

Два режима

REST API (порт 10000) — обычные HTTP запросы. Для интеграции в программы, боты, сайты.

MCP сервер (порт 9000) — специальный протокол для AI ассистентов. Позволяет подключить Vektor к Claude, ChatGPT и другим. AI сам будет вызывать нужные инструменты.

Скорость и ограничения

  • Среднее время ответа: 10-20 секунд (зависит от скорости Telegram бота)
  • Максимальный размер ответа: 100 000 символов (если больше — обрезается)
  • Если бот не ответил за 60 секунд — возвращается ошибка таймаута