A tool for obtaining information about ASes and routes via WHOIS / Инструмент для получения информации об AS и маршрутах через WHOIS
Project description
GETAS
Your AS Insights at the CLI
A lightweight tool to retrieve Autonomous System information and BGP routes.
▸ Demo
✨ Features
- Fast AS Lookup: Get owner information by IP, Domain, or ASN.
- Route Aggregation: Automatically merges adjacent networks for a cleaner view (can be disabled).
- Smart Paging: Built-in terminal-aware pager that doesn't feel like a separate app.
- Zero Dependencies: Uses only Python standard libraries.
- Table Mode: Clean tabular output for better readability.
getas
Легкая и быстрая консольная утилита без внешних зависимостей для получения информации об Автономных Системах (AS) и маршрутах BGP напрямую из WHOIS-серверов (Cymru и RADB).
✨ Особенности
- Быстрый поиск: Получение информации о владельце по IP, домену или номеру AS.
- Агрегация маршрутов: Автоматическое объединение смежных сетей для удобства (можно отключить).
- Умный пейджер: Встроенная постраничная навигация, учитывающая высоту терминала.
- Без зависимостей: Использует только стандартную библиотеку Python.
- Табличный режим: Форматированный вывод данных для удобного чтения.
Usage / Использование
🔍 Basic Information / Основная информация
Get information about an IP address, domain, or AS number. Получение информации об IP-адресе, домене или номере AS.
# Get AS info for an IP / Инфо об AS для конкретного IP
getas 8.8.8.8 -w
# Get info for a domain / Инфо по домену
getas google.com -w
# Get info by AS number / Инфо по номеру автономной системы
getas AS15169 -w
🛣 Working with Routes / Работа с маршрутами
Retrieve and display BGP routes. Загрузка и отображение BGP маршрутов.
# Get all routes for an AS (Table mode)
# Все маршруты AS в виде таблицы
getas AS13335 -t
# Get routes for an IP's owner (Manual trigger)
# Загрузить маршруты владельца IP (флаг -r обязателен для IP/доменов)
getas 1.1.1.1 -r -t
# Filter by IP version (IPv4 or IPv6 only)
# Фильтрация по версии протокола (только IPv4 или IPv6)
getas AS15169 -t -4
getas AS15169 -t -6
Get multi ASes, IPs, NETs, Domains at once Получение информации о нескольких автономных системах, сетях или доменах одновременно
getas AS15169 AS13335 -t -4
⚙️ Advanced Options / Продвинутые опции
Fine-tune the output formatting. Тонкая настройка вывода.
# Disable route merging (show raw prefixes)
# Отключить объединение сетей (показать исходные префиксы)
getas AS13335 -t --no-merge
# Show IPv4 mask in decimal format (255.255.255.0 instead of /24)
# Показать маску в десятичном формате
getas AS13335 -t -m
# Force interface language (English or Russian)
# Принудительная смена языка (en или ru)
getas 8.8.8.8 --lang en
getas 8.8.8.8 --lang ru
# Disable built-in pager (useful for scripts)
# Отключить встроенный пейджер (полезно для перенаправления вывода)
getas AS13335 --no-pager > routes.txt
# Get result in JSON format / JSON формат
getas AS13335 --json
If domain is blocked / Если домен заблокирован
getas $(dig @8.8.8.8 example.com +short) -r -t
Examples / Примеры
| Task / Задача | Command / Команда |
|---|---|
| Simple lookup | getas 1.1.1.1 -w |
| Full table (EN) | getas AS13335 -t --lang en |
| All IPv6 routes | getas AS15169 -t -6 |
| Raw data export | getas AS13335 --no-merge --no-pager |
| JSON output | getas AS133 --json |
| Multi AS lookup | getas AS1333 AS13335 |
Options / Параметры
| Flag | Description | Описание |
|---|---|---|
-h |
Help | Справка |
-w |
Whois only (no routes) | Только информация о владельце |
-t |
Table output | Вывод в виде таблицы |
-m |
Show netmask (decimal) | Показать маску в десятичном виде |
-4 |
Show only IPv4 routes | Показывать только маршруты IPv4 |
-6 |
Show only IPv6 routes | Показывать только маршруты IPv6 |
--no-merge |
Disable route merging | Отключить объединение сетей |
--no-pager |
Disable pagination | Отключить разбивку на страницы |
--json |
Output in JSON format | Вывод в формате JSON |
--lang {ru, en} |
Language for output | Язык для вывода |
Installation / Установка
📦 Download Ready-to-Use Packages (Recommended)
You can download the latest pre-built packages for your distribution from the Releases page.
For Debian, Ubuntu, Astra Linux, Mint (.deb):
sudo dpkg -i getas_1.0.0_all.deb
# If there are missing dependencies:
sudo apt-get install -f
For ALT Linux, Fedora, CentOS, RedOS (.rpm):
# ALT Linux:
sudo apt-get install ./getas-1.0.0-1.noarch.rpm
# Fedora / CentOS:
sudo dnf install ./getas-1.0.0-1.noarch.rpm
Via Python PIP
pip install getas
# or
pipx install getas
Via Python Pip (Universal)
If you have Python installed, you can install the tool directly from the source:
git clone https://github.com/mnbarinov/getas.git
cd getas
pip install .
Note: This will create a getas command in your PATH.
Arch Linux (AUR)
If you are using Arch Linux, you can build the package using the provided PKGBUILD:
git clone https://github.com/mnbarinov/getas.git
cd getas
makepkg -si
Manual Installation (Single file)
If you just want the script without any package management:
sudo curl -L https://raw.githubusercontent.com/mnbarinov/getas/master/getas/main.py -o /usr/bin/getas
sudo chmod +x /usr/bin/getas
© 2026 Mikhail Barinov. Licensed under the MIT License.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file getas-1.1.1-py3-none-any.whl.
File metadata
- Download URL: getas-1.1.1-py3-none-any.whl
- Upload date:
- Size: 13.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f0d9a068f3ce19ee90ea0d5b96d697b881998c1eca91032f92c18f067c7f3718
|
|
| MD5 |
0e3193caf62e478d08a7c8cd094d5705
|
|
| BLAKE2b-256 |
79d1f52991a27b551cc9e403f482d276c9009f1780ea454cf64f9b8dc659c120
|