IPSearch

Обнаруживайте информацию о целевых активах с IPSearch. Выполняйте офлайн IP Whois-запросы и поиск по ключевым словам, интегрировано с ИИ через MCP. Чистый Go, кроссплатформенность и высокая производительность.

Разработка API Инструменты разработчика Безопасность и тестирование ★ 29 GitHub (29 ★)

IPSearch — это офлайн-инструмент для Whois-поиска по IP, предназначенный для выявления и сбора информации о целевых активах. Он позволяет запрашивать сегменты IPv4-адресов и их Whois-детали, а также выполнять обратный поиск по ключевым словам для поиска связанных диапазонов IP. В этой версии реализована поддержка протокола MCP, что позволяет беспрепятственно использовать IPSearch в качестве MCP-сервера для AI-клиентов и автоматизации рабочих процессов, делая его мощным инструментом для специалистов по кибербезопасности для автоматизации обнаружения IP-сегментов и разведки.

Ключевые особенности

01Чистая реализация на Go для простой кросскомпиляции и развертывания на различных платформах.

02Работает как MCP Server для интеграции с AI-клиентами и автоматизированными рабочими процессами.

0329 звезд на GitHub

04Офлайн Whois-поиск по IPv4 с предоставлением подробной информации о сегменте IP.

05Поиск диапазонов IP по ключевым словам с поддержкой множества ключевых слов и сопоставления полей описания/имени сети.

06Использует офлайн SQLite-базу данных для высокопроизводительных запросов без необходимости подключения к интернету.

Варианты использования

01Автоматическое обнаружение IP-сегментов, связанных с конкретными организациями или сущностями, на основе ключевых слов.

02Интеграция в рабочие процессы киберразведки и сбора активов для получения информации об IP.

03Расширение возможностей AI-клиентов за счет предоставления структурированных функций Whois-поиска по IP и поиска по ключевым словам через протокол MCP.

IPSearch-MCP

离线IP Whois查询工具，现已支持MCP协议集成。

原项目： https://github.com/SleepingBag945/IPSearch

原项目原理：https://www.freebuf.com/articles/sectool/358230.html

可根据关键词反向查询关联IP，收集目标资产。使用AI输入目标系统名称自动化反查IP段。

使用golang编写，纯Go实现支持交叉编译，一次编译到处运行。可以很方便的集成至师傅们的工作流中。

主要功能

1. IP查询（ip_lookup）

根据IPv4地址查询所属IP段以及IPWhois信息，包括：

IP段范围（inetnum）
网络名称（netname）
归属国家（country）
详细描述（descr）
状态信息（status）
最后修改时间（last-modified）

MCP

2. 关键词查询（keyword_lookup）

根据IPWhois登记信息关键字搜索IP段，支持：

多关键��组合查询（逗号分隔）
同时匹配descr和netname字段
最多返回2000条结果

MCP

参考提示词

  - 若用户提供 IPv4 地址，请调用 ip_lookup 工具查询 IP Whois 信息，并返回包含 IP 段、名称、描述、国家、状态、最后修改等字段的结果。确保在调用前对 IP 做基础校验，非合法 IPv4 要提示用户重新输入。        
  - 若用户提供单位名称，请先判断所属地区、机构类型及关键名词，然后构造多组关键词多次调用 keyword_lookup 工具，具体规则（禁止使用单独的高匹配度关键词，如zhejiang,这会导致返回大量结果无法处理）：                                                                                     
      - 第一次：提取单位中文名称拼音首字母，示例：浙江第一人民医院 → zjdyrmyy。
      - 第二次：提取单位英文分词组合：示例：浙江第二人民医院 → zhejiang,second,hospital                                                                                                                 
      - 第三次：提取单位中文拼音分词组合，示例：浙江第一人民医院 → zhejiang,diyi,yiyuan                                                                   
      - 第三次：格式为“地区英文 + 公司主要拼音”，示例：吉林混论机械股份有限公司 → jilin,kunlun
      - 第四次：格式为“地区英文 + 公司主要英文”，示例：浙江酒股份有限公司 → zhejiang,wine,ltd  
  - 依次尝试上述关键词组合，即使前一个返回了结果，依旧需要走完所有规则。确保每次搜索的关键词字符串去除多余空格，必要时可以组合多个关键词一起查询（例如 zhejiang,hospital,first 与 zhejiang,hospital,zjdyrmyy）。       
  - 返回搜索结果时，请将IP段修改为CIDR的格式，并提供IP段归属为该公司的原因
    - 例子：
      1. 111.111.111.0/24 | IP段描述/名称原文 | 中文翻译
      2. 111.111.222.0/24 | IP段描述/名称原文 | 中文翻译因

技术特性

MCP协议支持：作为MCP Server运行，可集成到支持MCP的AI客户端中
纯Go实现：使用 github.com/glebarez/go-sqlite 驱动，支持完整交叉编译
离线数据库：基于SQLite的IP.db数据库，无需网络连接
高性能查询：优化的SQL查询和索引设计

IP.db为SQLite格式的IP数据库，若此工具不满足要求可用此库自己实现。

使用方法

编译

# 克隆代码
git clone <repository-url>
cd IPSearch

# 编译当前平台
go build -o IPSearch

# 交叉编译示例
# Linux AMD64
GOOS=linux GOARCH=amd64 go build -o IPSearch-linux-amd64

# macOS AMD64
GOOS=darwin GOARCH=amd64 go build -o IPSearch-darwin-amd64

# macOS ARM64 (M1/M2)
GOOS=darwin GOARCH=arm64 go build -o IPSearch-darwin-arm64

# Windows AMD64
GOOS=windows GOARCH=amd64 go build -o IPSearch-windows-amd64.exe

运行

下载源码编译或者在Release下载适合自己系统的IPSearch
下载IP.zip，解压后把IP.db放在IPSearch同目录下
在cherrystudio配置对应的MCP服务器
工具将通过标准输入输出与MCP客户端通信

MCP工具说明

ip_lookup

参数：ip (string, 必需) - 待查询的IPv4地址
返回：IP段及完整的IPWhois信息

keyword_lookup

参数：keywords (string, 必需) - 逗号分隔的关键字列表
返回：匹配的IP段列表（最多2000条）

依赖说明

Go 1.23.0+
github.com/glebarez/go-sqlite - 纯Go SQLite驱动，支持交叉编译
github.com/mark3labs/mcp-go - MCP协议实现

IPSearch-MCP — офлайн-поиск IP и Whois через MCP

IPSearch — это инструмент на Go для offline-поиска IP-Whois-информации и обратного поиска IP-диапазонов по ключевым словам. Проект адаптирован для работы как MCP-сервер (Model Context Protocol), что позволяет интегрировать его в AI-клиенты (например, Cherry Studio) и автоматизировать сбор данных о сетевых активах.

Основан на оригинальном проекте IPSearch (описание принципов — статья на FreeBuf).

Основные возможности

ip_lookup — поиск по IPv4-адресу: определение принадлежащего IP-диапазона (inetnum), сетевого имени (netname), страны (country), описания (descr), статуса и даты последней модификации.
keyword_lookup — поиск IP-диапазонов по ключевым словам (по полям descr и netname). Поддерживает комбинации из нескольких слов через запятую, до 2000 результатов.

Технические особенности

Полностью на Go — используется github.com/glebarez/go-sqlite (pure-Go драйвер), возможна кросскомпиляция под любые платформы.
Офлайн-база — данные хранятся в SQLite-файле IP.db, не требуется доступ в интернет.
MCP-совместимость — общение с AI-клиентами через stdin/stdout по протоколу MCP (github.com/mark3labs/mcp-go).

Установка и запуск

Скачайте исходный код или готовый бинарник из релизов.
Скачайте архив IP.zip, извлеките IP.db в папку с исполняемым файлом.
Настройте MCP-сервер в клиенте (например, в Cherry Studio) — путь к бинарнику.

Компиляция из исходников

git clone <repository-url>
cd IPSearch
go build -o IPSearch                    # для текущей ОС

# примеры кросс-компиляции
GOOS=linux GOARCH=amd64 go build -o IPSearch-linux-amd64
GOOS=darwin GOARCH=arm64 go build -o IPSearch-darwin-arm64
GOOS=windows GOARCH=amd64 go build -o IPSearch-windows-amd64.exe

MCP-инструменты

Инструмент	Параметры	Описание
`ip_lookup`	`ip` (string, обязательный) — IPv4-адрес	Возвращает полную Whois-информацию.
`keyword_lookup`	`keywords` (string, обязательный) — ключевые слова через запятую	Возвращает до 2000 совпадающих IP-диапазонов.

Примеры использования в AI-ассистенте (подсказки)

При запросе IPv4-адреса вызывать ip_lookup и возвращать данные с переводом полей. Перед вызовом проверять корректность адреса.
При запросе по названию организации (например, «ООО Ромашка») последовательно генерировать несколько вариантов ключей и вызывать keyword_lookup для каждого:
- пиньинь-аббревиатура (romashka → rmsk, но не zhejiang — слишком широко);
- английские слова из названия;
- латинская транслитерация китайских слов;
- комбинация региона + основное слово.
Всегда обрабатывать все варианты, даже если первый уже дал результаты.
В ответе приводить IP-диапазоны в формате CIDR и пояснять, почему они относятся к искомой организации.

Пример вывода:

1. 111.111.111.0/24 | Network Name / Description | перевод
2. 111.111.222.0/24 | Network Name / Description | перевод

Зависимости

Go 1.23.0+
github.com/glebarez/go-sqlite
github.com/mark3labs/mcp-go

Источник: https://mcpmarket.com/server/ipsearch