Действительно ли эти скрипты бесплатны в использовании?

Да — каждый скрипт, обращающийся к нашему API, делает это анонимно, в рамках бесплатного анонимного бюджета на IP в сутки; три чисто локальных рецепта вообще не делают сетевых запросов. Ни для одного из них не нужна регистрация или API-ключ.

Нужно ли что-то устанавливать, чтобы их запустить?

Нет — каждый Python-скрипт использует только стандартную библиотеку (Python 3.8+, pip install не нужен), а каждый JavaScript-скрипт — только встроенные возможности Node.js 18+ (npm install и package.json не нужны).

Можно ли использовать эти скрипты в своём коммерческом проекте?

Да — каждый скрипт распространяется по лицензии MIT, которая разрешает коммерческое использование, изменение и распространение без требования указывать авторство.

Почему этот раздел отдельный от интерактивных страниц /tools/ и /tools/dev/?

Те разделы — интерактивные инструменты в браузере с формой и живым результатом; этот раздел — документация с полным, скачиваемым, копируемым кодом — другой формат контента для другого сценария (запуск в своём окружении, а не во вкладке браузера).

Чем это отличается от собственных примеров кода в документации API?

Документация API (/docs/) показывает короткие иллюстративные фрагменты кода рядом со справочником каждого эндпоинта; эти рецепты — полные, исполняемые, скачиваемые файлы, решающие одну конкретную реальную задачу целиком — рецепты дополняют документацию, а не дублируют её.

С какого рецепта лучше начать?

Если вы просто хотите увидеть корректный вызов API — asn-lookup (показан и на Python, и на JavaScript) самый короткий; если у вас уже есть реальный файл для обработки — bulk-enrich.py или proxy-filter.py самые сразу полезные.

Бесплатные рецепты скриптов для API

На этой странице перечислены восемь самодостаточных, скачиваемых Python- и JavaScript/Node-скриптов, каждый решает одну реальную сетевую/IP-задачу — массовое обогащение CSV с адресами, агрегация access-лога по странам, фильтрация списка по прокси, проверка принадлежности подсети, схлопывание списка CIDR, валидация geofeed, поиск ASN или отслеживание новых срабатываний в threat-фидах — в основном через прямой вызов бесплатного API ip.xakki.pro, без каких-либо дополнительных установок для запуска любого из них.

Все скрипты распространяются по лицензии MIT (заголовок SPDX-License-Identifier: MIT прямо в файле) — копируйте, адаптируйте и распространяйте свободно, указывать авторство не обязательно.

Рецепты в этом разделе

Массовое обогащение и анализ логов

Скрипт массового обогащения IP (Python) Обогащение CSV с IP-адресами страной/ASN/признаками прокси/угроз, со встроенными повторами и обработкой лимитов.
Скрипт агрегации IP из access-лога (Python) Извлечение IP из лога nginx/Apache и ранжирование стран/ASN по числу запросов.

Фильтрация

Скрипт фильтрации прокси/VPN/Tor (Python) Разбиение списка IP на clean.txt/flagged.txt по признакам прокси, VPN, Tor и хостинга.

Локальные вычисления офлайн — без обращения к API

Скрипт проверки принадлежности подсети (JavaScript) Проверка принадлежности адреса IPv4/IPv6 списку CIDR-блоков, чистая математика на BigInt.
Скрипт агрегации списка CIDR (Python) Схлопывание списка CIDR-блоков в минимальный эквивалентный набор.
Скрипт разбора geofeed по RFC 8805 (Python) Разбор и валидация самостоятельно опубликованного CSV geofeed с указанием строк ошибок.

Поиск и мониторинг

Функция поиска ASN (Python + JavaScript) Единая функция asn_lookup(ip), оборачивающая API, показана и на Python, и на JavaScript/Node.
Скрипт мониторинга threat-фидов (Python) Скрипт для cron, оповещающий о переходе отслеживаемого IP из чистого в помеченный как вредоносный.

Глоссарий

Рецепт: Термин этого раздела для самодостаточного скрипта, решающего одну реальную задачу — скачайте, запустите как показано, никакой настройки сверх флагов CLI, описанных на его собственной странице.
Только стандартная библиотека: Каждый рецепт на Python использует только модули, идущие в комплекте с самим Python; каждый рецепт на JavaScript использует только встроенные возможности Node.js 18+ — во всём разделе нет ни pip install, ни npm install, ни package.json.
Лимит по уникальному IP в сутки: Модель лимитов API, которую соблюдает каждый обращающийся к сети рецепт этого раздела: повторный запрос того же целевого IP в те же сутки UTC бесплатен, в суточный бюджет засчитывается только реально новый адрес.
Лицензия MIT: Разрешительная лицензия с открытым исходным кодом, под которой распространяется каждый скрипт раздела — свободно копируйте, изменяйте и распространяйте, указывать авторство не обязательно, включает явный отказ от гарантий.
Локальный рецепт: Рецепт, вообще не делающий сетевых запросов (subnet-membership.js, cidr-aggregate.py, geofeed-parse.py) — чистая арифметика или разбор уже имеющихся данных, включён намеренно как честный контрпример рецептам, обращающимся к сети.
Мягкое придерживание: Реакция API на превышение бюджета для группы обогащения: HTTP 200 с группой, названной в "limited", вместо заполненной — каждый обращающийся к сети рецепт здесь обрабатывает это явно, никогда как тихий пустой/null результат.

Аналог в API

Большинство из восьми рецептов выше И ЕСТЬ пример работы с API — сам скрипт является парой запрос/ответ, а не отдельным дублирующим блоком curl. Три рецепта (subnet-membership.js, cidr-aggregate.py, geofeed-parse.py) вообще не делают сетевых запросов — см. на странице каждого причину. Полную схему ответа и все параметры смотрите по ссылке, которую даёт каждая страница рецепта:

Читать документацию API

Все бесплатные инструменты (сеть и IP, плюс утилиты для разработчиков)

Часто задаваемые вопросы

Действительно ли эти скрипты бесплатны в использовании?: Да — каждый скрипт, обращающийся к нашему API, делает это анонимно, в рамках бесплатного анонимного бюджета на IP в сутки; три чисто локальных рецепта вообще не делают сетевых запросов. Ни для одного из них не нужна регистрация или API-ключ.
Нужно ли что-то устанавливать, чтобы их запустить?: Нет — каждый Python-скрипт использует только стандартную библиотеку (Python 3.8+, pip install не нужен), а каждый JavaScript-скрипт — только встроенные возможности Node.js 18+ (npm install и package.json не нужны).
Можно ли использовать эти скрипты в своём коммерческом проекте?: Да — каждый скрипт распространяется по лицензии MIT, которая разрешает коммерческое использование, изменение и распространение без требования указывать авторство.
Почему этот раздел отдельный от интерактивных страниц /tools/ и /tools/dev/?: Те разделы — интерактивные инструменты в браузере с формой и живым результатом; этот раздел — документация с полным, скачиваемым, копируемым кодом — другой формат контента для другого сценария (запуск в своём окружении, а не во вкладке браузера).
Чем это отличается от собственных примеров кода в документации API?: Документация API (/docs/) показывает короткие иллюстративные фрагменты кода рядом со справочником каждого эндпоинта; эти рецепты — полные, исполняемые, скачиваемые файлы, решающие одну конкретную реальную задачу целиком — рецепты дополняют документацию, а не дублируют её.
С какого рецепта лучше начать?: Если вы просто хотите увидеть корректный вызов API — asn-lookup (показан и на Python, и на JavaScript) самый короткий; если у вас уже есть реальный файл для обработки — bulk-enrich.py или proxy-filter.py самые сразу полезные.

Рецепты скриптов