{"id":23383341,"url":"https://github.com/CyberScoper/telegram_bot_ip","last_synced_at":"2025-08-24T04:30:59.222Z","repository":{"id":221074067,"uuid":"622726341","full_name":"CyberScopeToday/telegram_bot_ip","owner":"CyberScopeToday","description":"This is a simple Telegram bot that provides geolocation information for IP addresses. The bot supports multiple languages, including English, Russian, and Slovak.","archived":false,"fork":false,"pushed_at":"2024-11-30T15:00:45.000Z","size":18,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-30T15:37:22.649Z","etag":null,"topics":["adress","ip","osint","osint-tool","python3","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/GeoIPInfo_bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/CyberScopeToday.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2023-04-02T23:42:54.000Z","updated_at":"2024-11-30T14:59:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"1b0f7636-705f-4cf5-8641-46ed93b8ad9d","html_url":"https://github.com/CyberScopeToday/telegram_bot_ip","commit_stats":null,"previous_names":["grandechuvash/telegram_bot_ip","cyberscopetoday/telegram_bot_ip"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberScopeToday%2Ftelegram_bot_ip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberScopeToday%2Ftelegram_bot_ip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberScopeToday%2Ftelegram_bot_ip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CyberScopeToday%2Ftelegram_bot_ip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CyberScopeToday","download_url":"https://codeload.github.com/CyberScopeToday/telegram_bot_ip/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230773650,"owners_count":18278133,"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","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":["adress","ip","osint","osint-tool","python3","telegram-bot"],"created_at":"2024-12-21T22:20:00.642Z","updated_at":"2025-08-24T04:30:59.216Z","avatar_url":"https://github.com/CyberScopeToday.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌍 Telegram IP Geolocation Bot\n\n[![CodeFactor](https://www.codefactor.io/repository/github/CyberScoper/telegram_bot_ip/badge)](https://www.codefactor.io/repository/github/CyberScoper/telegram_bot_ip)\n\nThis is a simple Telegram bot that provides geolocation information for IP addresses. The bot supports multiple languages, including English, Russian, and Slovak.\n\n## ✨ Features\n\n- 🌐 Language selection support for English, Russian, and Slovak.\n- 📍 Provides detailed geolocation information for a given IP address.\n- 🛰️ Uses [ip-api.com](http://ip-api.com) to retrieve geolocation data.\n- 🗺️ Displays information such as country, region, city, postal code, latitude, longitude, ASN, and organization.\n\n## 📋 Prerequisites\n\n- 🐍 Python 3.7 or higher\n- 🤖 [python-telegram-bot](https://python-telegram-bot.readthedocs.io/) library (version 20.0 or higher)\n- 🌐 Requests library for making HTTP requests\n\n## 🚀 Installation\n\n1. 📥 Clone the repository:\n   ```\n   git clone https://github.com/CyberScoper/telegram_bot_ip.git\n   cd telegram_bot_ip\n   ```\n\n2. 🐳 Create a virtual environment:\n   ```\n   python -m venv venv\n   ```\n\n3. 🔄 Activate the virtual environment:\n   - On Windows:\n     ```\n     venv\\Scripts\\activate\n     ```\n   - On macOS/Linux:\n     ```\n     source venv/bin/activate\n     ```\n\n4. 📦 Install the required Python libraries:\n   ```\n   pip install -r requirements.txt\n   ```\n\n5. 🔑 Replace `'api key bot father'` with your own Telegram bot token, which you can obtain from [BotFather](https://t.me/BotFather).\n\n## 📜 Requirements\n\nAdd the following to `requirements.txt`:\n```\npython-telegram-bot\u003e=20.0\nrequests\n```\n\n## 📚 Usage\n\n1. ▶️ Start the bot by running:\n   ```\n   python bot_ip-.py\n   ```\n\n2. 🤖 Start a conversation with your bot in Telegram by typing `/start`.\n\n3. 🌍 Select your preferred language (English, Russian, or Slovak).\n\n4. 📨 Send an IP address to the bot, and it will provide geolocation information.\n\n## 🛠️ Code Overview\n\nThe bot consists of the following main components:\n\n- **🌐 Language Selection**: Users can select their preferred language when they start the bot.\n- **📍 Geolocation Retrieval**: When a user sends an IP address, the bot retrieves geolocation data from [ip-api.com](http://ip-api.com).\n- **📝 Command Handlers**: Handlers are used to manage user interactions and to process messages.\n\n## 💡 Example\n\nAfter starting the bot and selecting your language, send an IP address like `8.8.8.8`. The bot will respond with geolocation information, such as:\n\n```\nCountry: United States\nRegion: California\nCity: Mountain View\nPostal Code: 94035\nLatitude: 37.386\nLongitude: -122.0838\nASN: AS15169\nOrganization: Google LLC\n```\n\n## 📝 Logging\n\nThe bot uses Python's built-in logging library to log important events, such as user interactions and errors.\n\n## 🤝 Contribution\n\nFeel free to contribute by submitting issues or pull requests. Please make sure to follow the existing code style and include relevant tests where applicable.\n\n## 📄 License\n\nThis project is licensed under the MIT License.\n\n## ⚠️ Disclaimer\n\nThis bot uses third-party services (ip-api.com) for geolocation data. Please review their terms of use before using the bot for commercial purposes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCyberScoper%2Ftelegram_bot_ip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FCyberScoper%2Ftelegram_bot_ip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FCyberScoper%2Ftelegram_bot_ip/lists"}