Skip to main content

A tool for obtaining information about ASes and routes via WHOIS / Инструмент для получения информации об AS и маршрутах через WHOIS

Project description

GETAS Logo

GETAS

Python Version Release Python Version License

Your AS Insights at the CLI
A lightweight tool to retrieve Autonomous System information and BGP routes.


▸ Demo

GETAS 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

getas-1.1.1-py3-none-any.whl (13.7 kB view details)

Uploaded Python 3

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

Hashes for getas-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f0d9a068f3ce19ee90ea0d5b96d697b881998c1eca91032f92c18f067c7f3718
MD5 0e3193caf62e478d08a7c8cd094d5705
BLAKE2b-256 79d1f52991a27b551cc9e403f482d276c9009f1780ea454cf64f9b8dc659c120

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page