{"id":31807905,"url":"https://github.com/andrefelipebarros/furiabot-telegram","last_synced_at":"2025-10-11T04:38:52.550Z","repository":{"id":291340123,"uuid":"973365203","full_name":"andrefelipebarros/FuriaBot-Telegram","owner":"andrefelipebarros","description":"FURIA Telegram Bot é um chatbot interativo para fãs de CS:GO da FURIA, desenvolvido no Challenge #1: Experiência Conversacional. Permite acompanhar partidas ao vivo, consultar resultados, estatísticas e interagir na comunidade.","archived":false,"fork":false,"pushed_at":"2025-09-02T18:07:58.000Z","size":24,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-02T20:18:02.002Z","etag":null,"topics":["bot","bot-development","bot-telegram","bot-telegram-python","python"],"latest_commit_sha":null,"homepage":"https://t.me/FuriaEsports_bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andrefelipebarros.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-26T20:37:51.000Z","updated_at":"2025-09-02T18:08:01.000Z","dependencies_parsed_at":"2025-05-04T01:34:50.649Z","dependency_job_id":null,"html_url":"https://github.com/andrefelipebarros/FuriaBot-Telegram","commit_stats":null,"previous_names":["andrefelipebarros/furiabot-telegram"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/andrefelipebarros/FuriaBot-Telegram","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrefelipebarros%2FFuriaBot-Telegram","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrefelipebarros%2FFuriaBot-Telegram/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrefelipebarros%2FFuriaBot-Telegram/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrefelipebarros%2FFuriaBot-Telegram/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andrefelipebarros","download_url":"https://codeload.github.com/andrefelipebarros/FuriaBot-Telegram/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andrefelipebarros%2FFuriaBot-Telegram/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006244,"owners_count":26084061,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","bot-development","bot-telegram","bot-telegram-python","python"],"created_at":"2025-10-11T04:38:48.096Z","updated_at":"2025-10-11T04:38:52.543Z","avatar_url":"https://github.com/andrefelipebarros.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![FURIA Logo](https://upload.wikimedia.org/wikipedia/pt/f/f9/Furia_Esports_logo.png?20221021154128)\n\n\n# 🚀 FURIA Telegram Bot\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)  [![Python Version](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://www.python.org/)  [![Telegram Bot](https://img.shields.io/badge/Telegram-Bot-green.svg)](https://telegram.org/)\n\n---\n\n## 🌐 Idiomas / Languages\n- 🇧🇷 **Português**\n- 🇺🇸 **English**\n\n---\n\n## 🇧🇷 Versão em Português\n\n### 🎮 Descrição\n**FURIA Telegram Bot** é um chatbot interativo para fãs de CS:GO da FURIA, desenvolvido no **Challenge #1: Experiência Conversacional**. Permite acompanhar partidas ao vivo, consultar resultados, estatísticas e interagir na comunidade.\n\n### ✨ Funcionalidades\n- 📱 **Menu Interativo**: Navegação por botões inline.\n- 🔴 **Status de Partidas ao Vivo**: Atualizações automáticas via PandaScore API.\n- ⏭️ **Próxima Partida**: Data, horário, adversário e liga.\n- 🏆 **Último Resultado**: Evento, placar e desfecho obtidos do Liquipedia.\n- 📊 **Estatísticas do Jogo**: MVP, kills, deaths, assists, ADR e pontuação.\n- 📋 **Enquete de Torcida**: Vote no jogador que vai brilhar.\n- 🔄 **Alternar Line**: Troca entre as equipes masculina e feminina.\n- 🔗 **Menu de Redes Sociais**: Links oficiais das duas equipes.\n\n### 🏗️ Arquitetura\n```mermaid\nsequenceDiagram\n    participant Usuário\n    participant Telegram\n    participant Bot\n    participant Serviços\n    participant APIs\n\n    Usuário-\u003e\u003eTelegram: /start, /live, botões\n    Telegram-\u003e\u003eBot: Recebe Update\n    Bot-\u003e\u003eServiços: fetch_live_match, fetch_next_match, scrape, get_scoreboard\n    Serviços-\u003e\u003eAPIs: PandaScore, Liquipedia, BO3.gg\n    APIs--\u003e\u003eServiços: JSON/HTML\n    Serviços--\u003e\u003eBot: Dados processados\n    Bot--\u003e\u003eTelegram: send/edit messages\n    Telegram--\u003e\u003eUsuário: Exibe respostas\n```\n\n\u003e Os **serviços externos** utilizados são:\n\u003e - 🔹 **PandaScore**: status de partidas e estatísticas ao vivo (services `pandascore.py`, `live_status.py`)\n\u003e - 🔹 **Liquipedia**: scraping de resultados e informações de eventos (service `result_matcher.py`)\n\u003e - 🔹 **BO3.gg**: dados de confrontos e placares detalhados (service `last_scoreboard.py`)\n\n### 🛠️ Tech Stack\n- **Linguagem**: Python 3.9+\n- **Framework**: python-telegram-bot v20+\n- **HTTP**: httpx (async) \u0026 requests\n- **Parsing HTML**: BeautifulSoup4\n- **APIs**: PandaScore, Liquipedia\n- **Env Management**: python-dotenv\n\n### 📂 Estrutura do Projeto\n```text\nfuria-telegram-bot/\n├── bot.py                  # Bot entrypoint\n├── handlers.py             # Command \u0026 callback handlers\n├── markups.py              # InlineKeyboard definitions\n├── services/               # External integrations\n│   ├── pandascore.py       # Próxima partida via PandaScore API\n│   ├── live_status.py      # Status de partidas ao vivo via PandaScore API\n│   ├── last_scoreboard.py  # Scoreboard scraping via BO3.gg\n│   ├── result_matcher.py   # Extração de dados do Liquipedia\n│   └── roster_service.py   # Busca do roster atual\n├── assets/                 # Logos e imagens\n├── .env                    # Variáveis de ambiente\n└── README.md               # Documentação\n```\n\n### ⚙️ Instalação\n```bash\ngit clone https://github.com/seu-usuario/furia-telegram-bot.git\ncd furia-telegram-bot\npython3 -m venv .venv\n# Linux/MacOS\nsource .venv/bin/activate\n# Windows\n.\\.venv\\Scripts\\activate\npip install -r requirements.txt\ncp .env.example .env\n# Edite .env com BOT_TOKEN e PANDASCORE_TOKEN\n```\n\n### ▶️ Uso\n```bash\npython bot.py\n```\n\n**Principais Comandos**\n| Comando     | Descrição                                         |\n|-------------|---------------------------------------------------|\n| `/start`    | Exibe menu principal                              |\n| `/help`     | Mostra ajuda                                      |\n| `/live`     | Inicia monitoramento de partidas ao vivo (a cada 45s) |\n| `/stoplive` | Encerra monitoramento                             |\n\n### 🚀 Roadmap (Futuras Melhorias)\n- ⏰ Notificações pré-jogo (10 minutos antes)\n- 🤖 Chatbot com IA para responder FAQs\n- 📅 Agenda semanal de partidas com exportação de calendário\n- 🌐 Suporte multilíngue (EN, ES, PT)\n- 📈 Histórico de interações de fãs\n\n### 🤝 Contribuição\n1. Abra uma _issue_ para discutir ideias\n2. Faça um fork e crie uma branch\n3. Envie um Pull Request\n\n### 📄 Licença\nEste projeto está licenciado sob a licença MIT.\n\n---\n\n## 🇺🇸 English Version\n\n### 🎮 Description\n**FURIA Telegram Bot** is an interactive chatbot for CS:GO FURIA fans, built as part of **Challenge #1: Conversational Experience**. It lets users follow live matches, view results and stats, and engage with the community.\n\n### ✨ Features\n- 📱 **Interactive Menu**: Inline button navigation.\n- 🔴 **Live Match Status**: Automatic updates via PandaScore API.\n- ⏭️ **Next Match**: Date, time, opponent, and league info.\n- 🏆 **Last Result**: Event, score, and outcome scraped from Liquipedia.\n- 📊 **Match Statistics**: MVP, kills, deaths, assists, ADR, and score.\n- 📋 **Fan Poll**: Vote for the player to watch.\n- 🔄 **Line Toggle**: Switch between men’s and women’s rosters.\n- 🔗 **Social Links**: Official channels.\n\n### 🏗️ Architecture\n```mermaid\nsequenceDiagram\n    participant User\n    participant Telegram\n    participant Bot\n    participant Services\n    participant APIs\n\n    User-\u003e\u003eTelegram: /start, /live, buttons\n    Telegram-\u003e\u003eBot: Receives update\n    Bot-\u003e\u003eServices: fetch_live_match, fetch_next_match, scrape, get_scoreboard\n    Services-\u003e\u003eAPIs: PandaScore, Liquipedia, BO3.gg\n    APIs--\u003e\u003eServices: JSON/HTML\n    Services--\u003e\u003eBot: Processed data\n    Bot--\u003e\u003eTelegram: send/edit messages\n    Telegram--\u003e\u003eUser: Displays interactive replies\n```\n\n\u003e The **external services** used are:\n\u003e - 🔹 **PandaScore**: next match \u0026 live match status and stats (services `pandascore.py`, `live_status.py`)\n\u003e - 🔹 **Liquipedia**: scraping results and event data (service `result_matcher.py`)\n\u003e - 🔹 **BO3.gg**: match details and detailed scoreboard (service `last_scoreboard.py`)\n\n### 🛠️ Tech Stack\n- **Language**: Python 3.9+\n- **Framework**: python-telegram-bot v20+\n- **HTTP Clients**: httpx (async) \u0026 requests\n- **HTML Parsing**: BeautifulSoup4\n- **APIs**: PandaScore, Liquipedia\n- **Environment**: python-dotenv\n\n### 📂 Project Structure\n```text\nfuria-telegram-bot/\n├── bot.py                  # Bot entrypoint\n├── handlers.py             # Command \u0026 callback handlers\n├── markups.py              # InlineKeyboard definitions\n├── services/               # External integrations\n│   ├── pandascore.py       # Next match via PandaScore API\n│   ├── live_status.py      # Live match status via PandaScore API\n│   ├── last_scoreboard.py  # Scoreboard scraping via BO3.gg\n│   ├── result_matcher.py   # Liquipedia data extraction\n│   └── roster_service.py   # Current roster fetcher\n├── assets/                 # Logos and images\n├── .env                    # Environment variables\n└── README.md               # Documentation\n```\n\n### ⚙️ Installation\n```bash\ngit clone https://github.com/your-username/furia-telegram-bot.git\ncd furia-telegram-bot\npython3 -m venv .venv\n# macOS/Linux\nsource .venv/bin/activate\n# Windows\n.\\.venv\\Scripts\\activate\npip install -r requirements.txt\ncp .env.example .env\n# Set BOT_TOKEN and PANDASCORE_TOKEN in .env\n```\n\n### ▶️ Usage\n```bash\npython bot.py\n```\n\n**Main Commands**\n| Command     | Description                                  |\n|-------------|----------------------------------------------|\n| `/start`    | Opens main menu                              |\n| `/help`     | Shows help                                   |\n| `/live`     | Starts live monitoring (45s interval)        |\n| `/stoplive` | Stops live monitoring                        |\n\n### 🚀 Roadmap (Future Improvements)\n- ⏰ Pre-game notifications (10 minutes before)\n- 🤖 AI chatbot for FAQs\n- 📅 Weekly schedule with calendar export\n- 🌐 Multilingual support (EN, ES, PT)\n- 📈 Fan interaction history\n\n### 🤝 Contributing\n1. Open an issue to discuss ideas\n2. Fork and create a branch\n3. Submit a Pull Request\n\n### 📄 License\nThis project is licensed under the MIT License.  © 2025 FURIA Esports","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrefelipebarros%2Ffuriabot-telegram","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandrefelipebarros%2Ffuriabot-telegram","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandrefelipebarros%2Ffuriabot-telegram/lists"}