TenderScope AI

Автономный тендерный департамент — AI-агент для автоматизации работы с госзакупками.

🎯 Проблема

Ручной мониторинг госзакупок трудозатратен: высокий риск пропуска сроков и ошибок в оценке релевантности ТЗ.

💡 Решение

AI-агент на базе LLM (Cloud.ru Qwen) + MCP-сервер с 7 инструментами:

Инструмент	Описание
search_tenders	Поиск тендеров по ключевым словам, бюджету, региону
get_tender_details	Детальная информация о тендере
get_tender_documents	Документы тендера (ТЗ, контракт)
score_tender	Скоринг тендера на основе базы знаний компании
compare_tenders	Сравнение нескольких тендеров
get_company_history	История участия компании в тендерах
send_alert	Отправка уведомления в Telegram

📊 Бизнес-ценность

• Экономия 2-3 часа/день на мониторинге
• Снижение пропущенных тендеров с 15-20% до <5%
• Автоматическая оценка релевантности

---

🚀 Быстрый старт

1. Клонирование и установка

git clone <repo>
cd ai_devtools_hack

# Установка зависимостей через uv
uv sync

2. Настройка окружения

# Копируем пример конфига
cp .env.example .env

# Редактируем .env — добавляем API ключ Cloud.ru
# LLM_API_KEY=ваш_ключ_от_cloud_ru

3. Запуск AI-агента (интерактивный режим)

uv run python agent.py

Примеры запросов:

👤 Вы: Найди тендеры на разработку ПО от 3 млн
👤 Вы: Покажи историю компании по тендерам
👤 Вы: Сравни тендеры: CRM за 8 млн и мобильное приложение за 12 млн

4. Запуск демо-сценария

uv run python demo_showcase.py

---

🐳 Docker (MCP-сервер для Cloud.ru)

# Сборка образа
docker build -t tenderscope-mcp .

# Запуск локально
docker run -p 8080:8080 --env-file .env tenderscope-mcp

# Или через docker-compose
docker-compose up -d

MCP-сервер будет доступен по адресу: http://localhost:8080/mcp

---

🔧 Переменные окружения

Переменная	Описание	Обязательно
LLM_API_KEY	API ключ Cloud.ru Foundation Models	✅
LLM_MODEL_NAME	Модель LLM (default: Qwen/Qwen3-235B-A22B-Instruct-2507)	❌
USE_REAL_API	Использовать реальный API ГосПлан (default: true)	❌
TELEGRAM_BOT_TOKEN	Токен Telegram бота (для уведомлений)	❌
TELEGRAM_CHAT_ID	ID чата для уведомлений	❌

---

🌐 Источники данных

API ГосПлан (gosplan.info) — доступ к данным ЕИС Закупки (zakupki.gov.ru):

• 44-ФЗ — госзакупки
• 223-ФЗ — закупки госкомпаний

API бесплатный до 01.07.2026, регистрация не требуется.

---

🧪 Тесты

# Все тесты
uv run pytest tests/ -v

# Конкретный модуль
uv run pytest tests/test_procurement.py -v

---

📁 Структура проекта

ai_devtools_hack/
├── agent.py              # AI-агент (интерактивный режим)
├── demo_showcase.py      # Демо-сценарий для презентации
├── main.py               # MCP-сервер для Cloud.ru
├── src/
│   ├── common/           # Модели, утилиты, LLM-клиент
│   ├── servers/
│   │   ├── procurement/  # Поиск тендеров
│   │   ├── rag/          # Скоринг и аналитика
│   │   └── biz_ops/      # Telegram уведомления
│   ├── orchestrator/     # Координация агентов
│   └── tools_direct.py   # Прямые вызовы инструментов
├── tests/                # Тесты
├── docs/                 # Документация
└── data/                 # Данные и база знаний

---

🎬 Демо

Интерактивный режим

uv run python agent.py

Автоматический сценарий

uv run python demo_showcase.py

MCP-сервер (для интеграции с IDE)

uv run python main.py

---

📄 Лицензия

MIT