phoneinfoga

name	phoneinfoga
description	Auth/lab ref: Phone number OSINT tool - gather carrier, location, and online presence data for phone numbers.
license	MIT
compatibility	Go binary; Linux/macOS/Windows.
metadata	{"author":"AeonDave","version":"1.1"}

PhoneInfoga

Phone number reconnaissance — carrier, country, online presence, breach data.

Quick Start

# Download from GitHub releases
# Or Docker
docker run --rm sundowndev/phoneinfoga scan -n [phone]

# Scan a number (international format)
phoneinfoga scan -n [phone]

# Start web UI
phoneinfoga serve
# → http://localhost:5000

Core Commands

Command	Purpose
scan -n NUMBER	Full scan on number
serve	Launch web dashboard
--output json	JSON output

Information Retrieved

• Country, carrier, line type (mobile/landline/VoIP)
• Possible owner via reverse lookup
• Google dork results (social media, directories)
• NumVerify / Numinfo API data (if configured)
• Breach lookups (HaveIBeenPwned linked accounts)

Common Workflows

Quick scan:

phoneinfoga scan -n [phone]

Web dashboard for manual investigation:

phoneinfoga serve &
open http://localhost:5000

JSON output for automation:

phoneinfoga scan -n [phone] --output json > phone.json

Multiple numbers from file:

while read num; do
  phoneinfoga scan -n "$num" --output json >> all_results.json
done < numbers.txt

API Keys (Optional, Extend Results)

Configured in ~/.phoneinfoga/config.yaml:

numverify_api_key: "YOUR_KEY"    # numverify.com — validation + carrier
googlecse_api_key: "YOUR_KEY"    # Google Custom Search Engine
googlecse_cx: "YOUR_CX_ID"

Without keys: basic OSINT via Google dorks only. With NumVerify: carrier, line type, country validation.

Google Dork Expansion

PhoneInfoga auto-generates dorks. Run manually for deeper coverage:

"[phone]" site:linkedin.com
"[phone]" site:facebook.com
"[phone]" -site:yellowpages.com -site:whitepages.com
"[phone]" "resume" OR "contact" OR "WhatsApp"

Resources

File	When to load
references/api-setup.md	NumVerify setup, Google CSE config, alternative phone lookup sources