Skip to content

IP Finder Bot is a Telegram bot πŸ€– that provides detailed information about IP addresses 🌍, including geographical location πŸ“

Notifications You must be signed in to change notification settings

thejan64go/IP-Finder-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

31 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌐 IP Finder Bot for Telegram πŸ€–

πŸ“œ Introduction

IP Finder Bot is a Telegram bot πŸ€– that provides detailed information about IP addresses 🌍, including geographical location πŸ“, Internet Service Provider (ISP), and more. It supports both IPv4 and IPv6 addresses and offers functionalities through direct messages πŸ’¬ and inline queries πŸ”.

πŸ–Ό Sample Output

IP Finder Bot Sample

✨ Features

  • IP Address Lookup: Enter an IP address to get detailed information πŸ”Ž.
  • IPv4 and IPv6 Support: Handles both IPv4 and IPv6 address formats πŸ”„.
  • Geographical Information: Provides details like country 🏳️, city πŸ™, region, and postal code πŸ“¬.
  • ISP Information: Retrieves the Internet Service Provider associated with the IP 🌐.
  • Interactive Map: Shares a static map pinpointing the IP address location πŸ—Ί, generated using the LocationIQ Maps API.
  • Inline Query Support: Use the bot in any conversation through inline queries πŸ”.
  • Privacy Focused: Does not store user queries πŸ›‘.

πŸ—Ί Utilizing LocationIQ Maps API for Map Images

The bot generates map images for IP locations using the LocationIQ Maps API:

πŸš€ Getting Started with LocationIQ Maps API

  1. Obtain an API key by signing up for a free LocationIQ account πŸ”‘.
  2. Use the Static Map service by constructing a URL with the location's latitude and longitude, and your API key πŸ“.

πŸ“Œ Example API Request

https://maps.locationiq.com/v3/staticmap?key=YOUR_LOCATIONIQ_API_KEY&center=LATITUDE,LONGITUDE&zoom=16&size=600x600&markers=icon:large-blue-cutout|LATITUDE,LONGITUDE

Replace YOUR_LOCATIONIQ_API_KEY, LATITUDE, and LONGITUDE with your LocationIQ API key and the geographical coordinates.

πŸš€ Deployment

Set Environmentals variable before deploy. - Instructions

Deploy with heroku Deploy to Netlify Deploy to Render

βš™οΈ Installation

To use this bot, you need to have Python installed on your machine along with some specific libraries. Follow the steps below to set up and run the bot:

πŸ“‹ Prerequisites

  • Python 3.6 or newer 🐍
  • A Telegram Bot Token πŸ€– (obtained from BotFather)
  • An IPinfo API token πŸ”‘ (obtain from IPinfo)

πŸ“š Required Libraries

  • pyrogram - A modern, elegant, and asynchronous Telegram MTProto API framework πŸš€.
  • ipinfo - For fetching IP details 🌍.
  • requests - For making HTTP requests 🌐.

πŸ”§ Installation Steps

  1. Clone this repository or download the script πŸ“.
  2. Install the required Python libraries using pip:
    pip install pyrogram ipinfo requests
    
  3. Create a config.py file in the same directory as the script with the following content, replacing YOUR_API_ID, YOUR_API_HASH, YOUR_BOT_TOKEN, and YOUR_IPINFO_ACCESS_TOKEN with your actual details:
    class con:
        API_ID = 'YOUR_API_ID'  # Your API ID (as a string) πŸ†”
        API_HASH = 'YOUR_API_HASH'  # Your API Hash (as a string) πŸ”
        BOT_TOKEN = 'YOUR_BOT_TOKEN'  # Your Bot Token (as a string) πŸ€–
        IP_API = 'YOUR_IPINFO_ACCESS_TOKEN'  # Your IPinfo Access Token (as a string) πŸ”‘
  4. Run the bot πŸƒβ€β™‚οΈ:
    python main.py
    

πŸ“– How to use bOT

  • Start the Bot: Send /start to see the welcome message πŸš€.
  • Find IP Information: Send any IP address πŸ“§.
  • Inline Query: Type @YourBotUsername IP_ADDRESS in any chat πŸ”.

πŸš€ Original Bot

Access the original bot here.


About

IP Finder Bot is a Telegram bot πŸ€– that provides detailed information about IP addresses 🌍, including geographical location πŸ“

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published