Unified Telegram bot with MCP (Model Context Protocol) for information collection and RAG assistant
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"telegram-mcp-bot-2","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# 🤖 Unified Telegram MCP Bot **Умный Telegram-бот с поддержкой Model Context Protocol (MCP) для сбора информации и персонального RAG-ассистента.** ## 🎯 Особенности ### 🔄 Единая архитектура с маршрутизацией сообщений - **Групповые чаты** → Коллектор информации (обрабатывает ссылки, сохраняет в базу) - **Личные сообщения** → RAG-ассистент (поиск по базе + умные ответы) ### 🧠 Интеллектуальные возможности - **Автоматическая обработка ссылок** через MCP Playwright - **RAG (Retrieval-Augmented Generation)** с автоматическим поиском - **Контекстная память** с автоматическим сжатием диалогов - **Прямое подключение к ChromaDB** (минуя ненадежный MCP ChromaDB) ### 🚀 Режимы развертывания - **Development** (polling) - для демонстрации и разработки - **Production** (webhook) - для продакшн-серверов ## 📋 Быстрый старт ### 1. Установка зависимостей ```bash # Клонируйте репозиторий git clone <your-repo-url> cd telegram-mcp-bot # Установите uv (если еще нет) curl -LsSf https://astral.sh/uv/install.sh | sh # Установите зависимости Python uv sync # Установите MCP Playwright npx playwright install chromium ``` ### 2. Настройка окружения ```bash # Скопируйте пример конфигурации cp .env.example .env # Отредактируйте .env своими данными: # - TELEGRAM_TOKEN (получите у @BotFather) # - LLM_PROXY_API_KEY (ваш API ключ) # - другие настройки по необходимости ``` ### 3. Запуск для демонстрации ```bash # Режим разработки (polling) uv run python unified_bot.py ``` Бот готов! Добавьте его в групповой чат и напишите в личные сообщения. ## 🎮 Использование ### Командные интерфейсы #### В групповых чатах: - Просто отправляйте ссылки - бот автоматически их обработает - `/status` - статистика работы бота - `/stats` - детальная статистика обработки #### В личных сообщениях: - Любой вопрос - бот найдет информацию в базе и ответит - `/start` - приветствие и инструкции - `/clear` - очистить контекст диалога - `/context` - показать текущий контекст ### Автоматические функции ##…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.