一、工具安装

首先，您需要在本机设备上安装并配置好Python环境。
然后，广大研究人员可以通过以下命令将项目源码克隆至本地仓库：git clone https://github.com/yourusername/projectname.git

接下来，运行下列命令安装该项目所需的依赖组件：pip install -r requirements.txt
除此之外，您还需要一个API密钥！

二、工具使用

该工具采用命令行接口设计，操作十分便捷。下面详细介绍如何执行查询：

1. 传递您的API密钥：
   - '-k' 或 '--key': 通过stdin方式传入密钥
   - '-kf' 或 '--key-file': 从指定文件中读取密钥
   - '-sc' 或 '--shodan-cli': 从Shodan命令行工具获取密钥

2. 执行查询：
   a) 查询特定URL的IP地址：
      - '-d' 或 '--domain': 指定目标Web地址，如 -d yourdomain.com
   b) 查询特定域名下的所有CNAME记录：
      - '-c' 或 '--cname': 指定查询域名，如 -c yourdomain.com

3. 输出结果：
   您可以指定数据输出文件和格式，例如csv、json等。使用'-o'或'--output'参数：
   - '-o' 或 '--output': 指定输出文件的保存路径，如-o output.csv

三、工具使用示例

以下是几个常见的命令使用场景：

1. 查询特定URL的IP地址：
   python yourscript.py -d yourdomain.com -sc your_api_key
2. 查询特定域名下的所有CNAME记录：
   python yourscript.py -c yourdomain.com -sc your_api_key
3. 将查询结果保存到csv文件中：
   python yourscript.py -d yourdomain.com -o output.csv

四、作为模块导入使用

如果您希望将本工具集成到其他Python脚本中，可以将其作为模块导入。下面是一个使用示例：

from yourmodule import QueryTool

# 设置配置项
tool = QueryTool(api_key='your_api_key')

# 查询特定URL的IP地址
ip_address = tool.query_ip('https://www.example.com')
print(ip_address)

# 查询特定域名下的所有CNAME记录
cname_list = tool.query_cnames('example.com')
for cname in cname_list:
    print(cname)