dnsrobot 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 72ebf9c3d281d3fb88a6656aeeaeed5652deeb6e7d929f1e1cb6837413e3d8eb
+  data.tar.gz: 7098979fa75119443a1ab655b32051d72defac59d63eaddaa2770b9d8bcefa4f
+SHA512:
+  metadata.gz: 4fd11a1e081a23abc91c96be54a492428a610e3e8c5317f3f32b50acee3adf4f455abc44ec771c66175ee5087ce61cb09e43cd77ec4d9fed3e441f45b7da2723
+  data.tar.gz: c9ce6d5fee6e00facb84e2f945729655b47f358af9a8f3dabee358d1fee37d28a8ac4a169a76b903cb089e2477b8afd01140bcb8a9ee65c6c250baac6b6997ba

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DNS Robot (dnsrobot.net)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,62 @@
+# dnsrobot
+
+Ruby client for the [DNS Robot](https://dnsrobot.net) API — 53 free online DNS and network tools.
+
+No API key required. Zero external dependencies.
+
+## Install
+
+```bash
+gem install dnsrobot
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "dnsrobot"
+```
+
+## Quick Start
+
+```ruby
+require "dnsrobot"
+
+dr = DNSRobot.new
+
+# DNS lookup
+result = dr.dns_lookup("example.com")
+puts result["resolvedIPs"]
+
+# WHOIS lookup
+whois = dr.whois_lookup("example.com")
+puts whois["registrar"]["name"]
+
+# SSL certificate check
+ssl = dr.ssl_check("github.com")
+puts "Days left: #{ssl["leafCertificate"]["daysToExpire"]}"
+
+# Email authentication
+spf = dr.spf_check("gmail.com")
+puts "SPF Grade: #{spf["grade"]}"
+```
+
+## Available Methods
+
+| Method | Description | Tool Page |
+|--------|-------------|-----------|
+| `dns_lookup(domain)` | DNS record lookup | [DNS Lookup](https://dnsrobot.net/dns-lookup) |
+| `whois_lookup(domain)` | WHOIS registration data | [WHOIS Lookup](https://dnsrobot.net/whois-lookup) |
+| `ssl_check(domain)` | SSL/TLS certificate check | [SSL Checker](https://dnsrobot.net/ssl-checker) |
+| `spf_check(domain)` | SPF record validation | [SPF Checker](https://dnsrobot.net/spf-checker) |
+| `dkim_check(domain)` | DKIM record check | [DKIM Checker](https://dnsrobot.net/dkim-checker) |
+| `dmarc_check(domain)` | DMARC record validation | [DMARC Checker](https://dnsrobot.net/dmarc-checker) |
+| `mx_lookup(domain)` | MX record lookup | [MX Lookup](https://dnsrobot.net/mx-lookup) |
+| `ns_lookup(domain)` | Nameserver lookup | [NS Lookup](https://dnsrobot.net/ns-lookup) |
+| `ip_lookup(ip)` | IP geolocation | [IP Lookup](https://dnsrobot.net/ip-lookup) |
+| `http_headers(url)` | HTTP header analysis | [HTTP Headers](https://dnsrobot.net/http-headers) |
+| `port_check(host, port)` | TCP port check | [Port Checker](https://dnsrobot.net/port-checker) |
+
+## Links
+
+- **Homepage**: [dnsrobot.net](https://dnsrobot.net)
+- **All 53 Tools**: [dnsrobot.net/all-tools](https://dnsrobot.net/all-tools)

data/lib/dnsrobot.rb

@@ -0,0 +1,191 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+# Ruby client for the DNS Robot API (https://dnsrobot.net).
+#
+# Provides access to 11 DNS and network tools including DNS lookups,
+# WHOIS queries, SSL certificate checks, and email authentication
+# validation (SPF, DKIM, DMARC).
+#
+# No API key required. Zero external dependencies.
+#
+# @example
+#   dr = DNSRobot.new
+#   result = dr.dns_lookup("example.com")
+#   puts result["resolvedIPs"]
+#
+# @see https://dnsrobot.net DNS Robot - 53 free online DNS and network tools
+class DNSRobot
+  VERSION = "0.1.0"
+
+  # @param base_url [String] API base URL
+  # @param timeout [Integer] HTTP timeout in seconds
+  # @param user_agent [String] User-Agent header
+  def initialize(base_url: "https://dnsrobot.net/api", timeout: 30, user_agent: nil)
+    @base_url = base_url.chomp("/")
+    @timeout = timeout
+    @user_agent = user_agent || "dnsrobot-ruby/#{VERSION}"
+  end
+
+  # Perform a DNS lookup.
+  # @param domain [String] Domain name (required)
+  # @param record_type [String] Record type (default: "A")
+  # @param dns_server [String] DNS server (default: "8.8.8.8")
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/dns-lookup
+  def dns_lookup(domain, record_type: "A", dns_server: "8.8.8.8")
+    raise ArgumentError, "domain is required" if domain.nil? || domain.empty?
+
+    post("dns-query", {
+      domain: domain,
+      recordType: record_type,
+      dnsServer: dns_server
+    })
+  end
+
+  # Retrieve WHOIS registration data.
+  # @param domain [String] Domain name (required)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/whois-lookup
+  def whois_lookup(domain)
+    raise ArgumentError, "domain is required" if domain.nil? || domain.empty?
+
+    post("whois", { domain: domain })
+  end
+
+  # Check SSL/TLS certificate.
+  # @param domain [String] Domain name (required)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/ssl-checker
+  def ssl_check(domain)
+    raise ArgumentError, "domain is required" if domain.nil? || domain.empty?
+
+    post("ssl-certificate", { domain: domain })
+  end
+
+  # Validate SPF record.
+  # @param domain [String] Domain name (required)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/spf-checker
+  def spf_check(domain)
+    raise ArgumentError, "domain is required" if domain.nil? || domain.empty?
+
+    post("spf-checker", { domain: domain })
+  end
+
+  # Check DKIM record.
+  # @param domain [String] Domain name (required)
+  # @param selector [String, nil] DKIM selector (optional)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/dkim-checker
+  def dkim_check(domain, selector: nil)
+    raise ArgumentError, "domain is required" if domain.nil? || domain.empty?
+
+    payload = { domain: domain }
+    payload[:selector] = selector if selector
+    post("dkim-checker", payload)
+  end
+
+  # Validate DMARC record.
+  # @param domain [String] Domain name (required)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/dmarc-checker
+  def dmarc_check(domain)
+    raise ArgumentError, "domain is required" if domain.nil? || domain.empty?
+
+    post("dmarc-checker", { domain: domain })
+  end
+
+  # Retrieve MX records.
+  # @param domain [String] Domain name (required)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/mx-lookup
+  def mx_lookup(domain)
+    raise ArgumentError, "domain is required" if domain.nil? || domain.empty?
+
+    post("mx-lookup", { domain: domain })
+  end
+
+  # Retrieve nameserver records.
+  # @param domain [String] Domain name (required)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/ns-lookup
+  def ns_lookup(domain)
+    raise ArgumentError, "domain is required" if domain.nil? || domain.empty?
+
+    post("ns-lookup", { domain: domain })
+  end
+
+  # Look up IP geolocation data.
+  # @param ip [String] IP address (required)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/ip-lookup
+  def ip_lookup(ip)
+    raise ArgumentError, "ip is required" if ip.nil? || ip.empty?
+
+    post("ip-info", { ip: ip })
+  end
+
+  # Fetch and analyze HTTP response headers.
+  # @param url [String] URL to check (required, https:// added if missing)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/http-headers
+  def http_headers(url)
+    raise ArgumentError, "url is required" if url.nil? || url.empty?
+
+    url = "https://#{url}" unless url.start_with?("http://", "https://")
+    post("http-headers", { url: url })
+  end
+
+  # Check if a TCP port is open.
+  # @param host [String] Hostname or IP (required)
+  # @param port [Integer] Port number 1-65535 (required)
+  # @return [Hash] Parsed JSON response
+  # @see https://dnsrobot.net/port-checker
+  def port_check(host, port)
+    raise ArgumentError, "host is required" if host.nil? || host.empty?
+    raise ArgumentError, "port is required" if port.nil? || port.to_i <= 0
+
+    get("port-check", { host: host, port: port.to_s })
+  end
+
+  private
+
+  def post(endpoint, payload)
+    uri = URI("#{@base_url}/#{endpoint}")
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = uri.scheme == "https"
+    http.open_timeout = @timeout
+    http.read_timeout = @timeout
+
+    req = Net::HTTP::Post.new(uri)
+    req["Content-Type"] = "application/json"
+    req["User-Agent"] = @user_agent
+    req.body = JSON.generate(payload)
+
+    res = http.request(req)
+    raise "DNS Robot API error: HTTP #{res.code} from #{endpoint}: #{res.body}" unless res.is_a?(Net::HTTPSuccess)
+
+    JSON.parse(res.body)
+  end
+
+  def get(endpoint, params)
+    uri = URI("#{@base_url}/#{endpoint}")
+    uri.query = URI.encode_www_form(params)
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = uri.scheme == "https"
+    http.open_timeout = @timeout
+    http.read_timeout = @timeout
+
+    req = Net::HTTP::Get.new(uri)
+    req["User-Agent"] = @user_agent
+
+    res = http.request(req)
+    raise "DNS Robot API error: HTTP #{res.code} from #{endpoint}: #{res.body}" unless res.is_a?(Net::HTTPSuccess)
+
+    JSON.parse(res.body)
+  end
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: dnsrobot
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- DNS Robot
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-03-12 00:00:00.000000000 Z
+dependencies: []
+description: Ruby client for the DNS Robot API — DNS lookups, WHOIS, SSL checks, SPF/DKIM/DMARC
+  validation, and more. No API key required. Zero external dependencies.
+email:
+- rubygems@dnsrobot.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/dnsrobot.rb
+homepage: https://dnsrobot.net
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://dnsrobot.net
+  source_code_uri: https://github.com/dnsrobot/dns-robot-cli
+  bug_tracker_uri: https://github.com/dnsrobot/dns-robot-cli/issues
+  documentation_uri: https://dnsrobot.net/all-tools
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Ruby client for the DNS Robot API
+test_files: []