RapidDNS CLI

中文文档

Uma interface de linha de comando poderosa para interagir com a API RapidDNS. Esta ferramenta permite realizar pesquisas DNS, consultas avançadas e exportações de dados em larga escala diretamente do seu terminal.

Recursos

• Pesquisa DNS: Pesquisa por domínio, IP ou CIDR.
• Consulta Avançada: Use sintaxe de consulta poderosa (ex.: domain:example ADN tld:com AND type:A).
• Exportação de Dados: Gerencie automaticamente tarefas de exportação: iniciar, verificar status, baixar e descompactar.
• Extração de Dados:
  • Extrair e deduplicar Subdomínios em uma lista.
  • Extrair e deduplicar IPs em uma lista.
  • Gerar Estatísticas de Segmentos de IP (contagens de sub-redes).
• Saída Flexível: Salve resultados nos formatos JSON, CSV ou Texto.
• Suporte a Pipeline: Separação limpa entre stdout/stderr para encadeamento com outras ferramentas.
• Configuração: Gerenciamento fácil de chave de API.

Instalação

Via go install

Requisitos: Go 1.16+

Você pode instalar a versão mais recente diretamente com:

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

Após a instalação, certifique-se de que $GOPATH/bin (ou o diretório bin do Go para a sua configuração) está no seu PATH, então você pode executar:

rapiddns-cli --help

Compilar a partir do Código Fonte

Requisitos: Go 1.16+

1. Clone o repositório:

   root@kitploit:~

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

2. Compile para sua 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
   

Configuração

Para usar todos os recursos do RapidDNS (especialmente Exportação e Pesquisa ilimitada), você precisa de uma Chave de API.

1. Obtenha sua Chave de API no Perfil RapidDNS.
2. Configure-a na CLI:

rapiddns-cli config set-key <YOUR_API_KEY>

Verifique a chave atual:

rapiddns-cli config get-key

Nota: Sem uma Chave de API, os resultados da pesquisa podem ser limitados e a funcionalidade de exportação será desabilitada.

Uso

1. Pesquisa Básica

Pesquise por um domínio, IP ou CIDR.

rapiddns-cli search tesla.com

Opções:

• --page: Número da página (padrão 1).
• --type: Filtrar por tipo (subdomain, same_domain, ip, ip_segment, advanced).
• -o, --output: Formato de saída (json, csv, text). Padrão: json.
• -f, --file: Salvar saída em um arquivo específico.
• --column: Saída apenas de uma coluna específica para o console (subdomain, , , ).

Exemplos:

# Salvar como CSV
rapiddns-cli search tesla.com -o csv -f results.csv

# Buscar automaticamente até 1000 registros
rapiddns-cli search tesla.com --max 1000

# Extrair apenas subdomínios
rapiddns-cli search tesla.com --extract-subdomains

# Extrair apenas IPs e estatísticas
rapiddns-cli search tesla.com --extract-ips

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

2. Pipeline e Saída do Console

Projetado para hackers e automação. A saída padrão (stdout) são dados limpos, enquanto status/erros vão para stderr.

Saída apenas de subdomínios (lista de texto):

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

Saída:

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

Saída apenas de IPs (array JSON):

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

Saída:

[
  "1.2.3.4",
  "5.6.7.8"
]

Modo silencioso (apenas extrair para arquivos):

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

3. Consulta Avançada

Realize consultas complexas usando a sintaxe do RapidDNS com o comando search e --type advanced.

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

4. Exportação de Dados (Recomendado para Grandes Volumes)

O comando export lida com todo o fluxo de trabalho: solicitar a exportação, aguardar a conclusão, baixar o arquivo e processá-lo.

rapiddns-cli export start tesla.com

Opções:

• --type: Tipo de pesquisa (subdomain, sameip, ip_segment, advanced). Use advanced para sintaxe de consulta.
• --max: Número máximo de registros para exportar (0 significa todos, padrão 0).
• --compress: Comprimir resultado como ZIP (padrão true).
• --extract-subdomains: Extrair subdomínios do CSV baixado.
• --extract-ips: Extrair IPs e gerar estatísticas de sub-rede a partir do CSV baixado.

Exemplo de Fluxo Completo:

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

Exemplo de Exportação Avançada:

Para usar sintaxe de consulta avançada para exportação, defina --type advanced:

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

Este comando irá:

1. Iniciar uma tarefa de exportação para tesla.com.
2. Aguardar o processamento do servidor.
3. Baixar o arquivo ZIP para o diretório result/.
4. Descompactar o conteúdo.
5. Gerar tesla.com_subdomains.txt (lista de subdomínios).
6. Gerar tesla.com_ips.txt (lista de IPs únicos).
7. Gerar tesla.com_ip_stats.txt (estatísticas de sub-rede de IP).

Estrutura de Saída

Todos os resultados são salvos por padrão no diretório result/.

• {keyword}_subdomains.txt: Lista limpa de subdomínios únicos.
• {keyword}_ips.txt: Lista limpa de endereços IP únicos.
• {keyword}_ip_stats.txt: Estatísticas de contagens de IP por sub-rede (IPv4 /24, IPv6 /64).
• rapiddns_export_{keyword}_{date}.csv: Dados exportados brutos.

Ajuda

Execute qualquer comando com --help para ver mais detalhes.

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