RapidDNS CLI

中文文档

Una interfaz de línea de comandos potente para interactuar con la API de RapidDNS. Esta herramienta te permite realizar búsquedas DNS, consultas avanzadas y exportaciones de datos a gran escala directamente desde tu terminal.

Características

• Búsqueda DNS: Buscar por dominio, IP o CIDR.
• Consulta avanzada: Usa una sintaxis de consulta potente (ej. domain:example AND tld:com AND type:A).
• Exportación de datos: Gestiona automáticamente tareas de exportación: iniciar, sondear estado, descargar y descomprimir.
• Extracción de datos:
  • Extraer y deduplicar Subdominios en una lista.
  • Extraer y deduplicar IPs en una lista.
  • Generar Estadísticas de segmentos IP (conteos de subred).
• Salida flexible: Guarda resultados en formatos JSON, CSV o Texto.
• Soporte para tuberías: Separación limpia de stdout/stderr para encadenar con otras herramientas.
• Configuración: Gestión sencilla de claves API.

Instalación

Mediante go install

Requisitos: Go 1.16+

Puedes instalar la última versión directamente con:

go install github.com/rapiddns/rapiddns-cli@latest

Después de la instalación, asegúrate de que $GOPATH/bin (o el directorio bin de Go para tu configuración) esté en tu PATH, luego puedes invocar:

rapiddns-cli --help

Compilar desde el código fuente

Requisitos: Go 1.16+

1. Clona el repositorio:

   root@kitploit:~

   git clone https://github.com/rapiddns/rapiddns-cli.git
   cd rapiddns-cli
   

2. Compila para tu plataforma:

   Windows:

   root@kitploit:~

   go build -o rapiddns-cli
   

   Linux:

   root@kitploit:~

   GOOS=linux GOARCH=amd64 go build -o rapiddns-cli
   

   macOS (Intel):

   root@kitploit:~

   GOOS=darwin GOARCH=amd64 go build -o rapiddns-cli
   

   macOS (Apple Silicon/M1/M2):

   root@kitploit:~

   GOOS=darwin GOARCH=arm64 go build -o rapiddns-cli
   

Configuración

Para usar todas las funcionalidades de RapidDNS (especialmente Exportación y Búsqueda ilimitada), necesitas una Clave API.

1. Obtén tu Clave API desde Perfil de RapidDNS.
2. Configúrala en la CLI:

rapiddns-cli config set-key <TU_CLAVE_API>

Verifica la clave actual:

rapiddns-cli config get-key

Nota: Sin una Clave API, los resultados de búsqueda pueden ser limitados y la funcionalidad de exportación estará deshabilitada.

Uso

1. Búsqueda básica

Busca un dominio, IP o CIDR.

rapiddns-cli search tesla.com

Opciones:

• --page: Número de página (por defecto 1).
• --type: Filtrar por tipo (subdomain, same_domain, ip, ip_segment, advanced).
• -o, --output: Formato de salida (json, csv, text). Por defecto: json.
• -f, --file: Guardar la salida en un archivo específico.
• --column: Mostrar solo una columna específica en consola (subdomain, , , ).

Ejemplos:

# Guardar como CSV
rapiddns-cli search tesla.com -o csv -f resultados.csv

# Obtener hasta 1000 registros automáticamente
rapiddns-cli search tesla.com --max 1000

# Extraer solo subdominios
rapiddns-cli search tesla.com --extract-subdomains

# Extraer solo IPs y estadísticas
rapiddns-cli search tesla.com --extract-ips

# Extraer AMBOS
rapiddns-cli search tesla.com --extract-subdomains --extract-ips

2. Tuberías y salida en consola

Diseñado para hackers y automatización. La salida estándar (stdout) son datos limpios, mientras que el estado/errores van a stderr.

Mostrar solo subdominios (lista de texto):

rapiddns-cli search tesla.com --column subdomain -o text

Salida:

api.tesla.com
www.tesla.com
...

Mostrar solo IPs (array JSON):

rapiddns-cli search tesla.com --column ip -o json

Salida:

[
  "1.2.3.4",
  "5.6.7.8"
]

Modo silencioso (solo extraer a archivos):

rapiddns-cli search tesla.com --extract-subdomains --silent

3. Consulta avanzada

Realiza consultas complejas usando la sintaxis de RapidDNS con el comando search y --type advanced.

rapiddns-cli search "domain:apple.com AND type:A" --type advanced

4. Exportación de datos (Recomendado para grandes volúmenes)

El comando export maneja todo el flujo de trabajo: solicitar la exportación, esperar a que se complete, descargar el archivo y procesarlo.

rapiddns-cli export start tesla.com

Opciones:

• --type: Tipo de búsqueda (subdomain, sameip, ip_segment, advanced). Usa advanced para sintaxis de consulta.
• --max: Número máximo de registros a exportar (0 significa todos, por defecto 0).
• --compress: Comprimir resultado como ZIP (por defecto true).
• --extract-subdomains: Extraer subdominios del CSV descargado.
• --extract-ips: Extraer IPs y generar estadísticas de subred del CSV descargado.

Ejemplo de flujo de trabajo completo:

rapiddns-cli export start tesla.com --max 10000 --extract-subdomains --extract-ips

Ejemplo de exportación avanzada:

Para usar sintaxis de consulta avanzada en exportación, establece --type advanced:

rapiddns-cli export start "domain:apple AND type:A" --type advanced

Este comando:

1. Iniciará una tarea de exportación para tesla.com.
2. Esperará a que el servidor la procese.
3. Descargará el archivo ZIP en el directorio result/.
4. Descomprimirá el contenido.
5. Generará tesla.com_subdomains.txt (lista de subdominios).
6. Generará tesla.com_ips.txt (lista de IPs únicas).
7. Generará tesla.com_ip_stats.txt (estadísticas de subred IP).

Estructura de salida

Todos los resultados se guardan por defecto en el directorio result/.

• {palabra_clave}_subdomains.txt: Lista limpia de subdominios únicos.
• {palabra_clave}_ips.txt: Lista limpia de direcciones IP únicas.
• {palabra_clave}_ip_stats.txt: Estadísticas de conteos de IP por subred (IPv4 /24, IPv6 /64).
• rapiddns_export_{palabra_clave}_{fecha}.csv: Datos exportados en bruto.

Ayuda

Ejecuta cualquier comando con --help para ver más detalles.

rapiddns-cli --help
rapiddns-cli search --help
rapiddns-cli export --help