Skip to content

denniskeefe/radioscout

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 

Repository files navigation

Static Badge

Ham Radio Callsign Lookup Tool

A lightweight automation script that opens multiple amateur radio databases simultaneously in your default browser to retrieve profile information, license data, and signal reports for a specific callsign.

Features

  • Multi-Source Search: Queries 8 major databases, including QRZ.com, HamQTH, and PSKreporter.

  • Safety First: Uses strict Regex validation (^[A-Z0-9]{3,7}$) and URL encoding to prevent injection attacks or malformed requests.

  • Anti-Bot Detection:

  • Randomization: Shuffles the order of websites visited.

  • Human-like Delays: Implements a random wait time ( to seconds) between requests to mimic manual browsing.

  • Cross-Platform: Uses the webbrowser module to ensure compatibility across Windows, macOS, and Linux.


Getting Started

Prerequisites

  • Python 3.x installed.
  • An active internet connection.
  • A default web browser configured.

Installation

  1. Clone this repository or save the script as lookup.py.
  2. No external libraries (like requests or selenium) are required; the script uses Python's standard library.

Usage

Run the script from your terminal:

python lookup.py

When prompted, enter the callsign (e.g., W1AW). The script will then begin opening tabs in your browser.


Supported Databases

Site Description
QRZ.com The primary global database for amateur radio operators.
HamQTH A free, open alternative to QRZ.
PSKreporter Real-time digital mode reception reports and mapping.
RadioReference Comprehensive FCC data and radio frequency info.
eQSL.cc Digital QSL card exchange profiles.
LCWO Learn CW Online profile stats.

Privacy & Security Notice

Important

This tool interacts with public web servers. Your public IP address will be logged by these websites.

  • IP Anonymity: This script does not mask your IP. For true operational security (OPSEC), ensure you have a VPN active or have your default browser set to the Tor Browser before running.
  • Terms of Service: Frequent or rapid automated queries can lead to temporary IP bans. This script uses delays to mitigate this, but use it responsibly.
  • Local Execution: All processing happens locally on your machine; no data is sent to a third-party API managed by this script.

License

This project is open-source. Please check with individual database providers (like QRZ) regarding their specific data usage policies.

About

Ham Radio user search

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages