Discover keyword-matching domains for SEO research

Python example: SEO

Requires Python 3.9 or later. Uses the standard library only, processes local files, and makes no network requests. Save the script beside your downloaded inputs, or provide full paths.

Download seo.py

Run the example

python3 seo.py new.txt.gz --keywords cloud hosting

Results are printed to the terminal. Redirect standard output to a file if you want to save the report. For the SQLite example, the database is saved at the path you specify.

Complete script

import argparse
import csv
import gzip
import sys


def domains(path):
    with gzip.open(path, "rt", encoding="utf-8") as source:
        for line in source:
            domain = line.strip().lower().rstrip(".")
            if domain:
                yield domain

parser = argparse.ArgumentParser(description="Find domain names matching topic keywords")
parser.add_argument("file")
parser.add_argument("--keywords", nargs="+", required=True)
args = parser.parse_args()
writer = csv.writer(sys.stdout)
writer.writerow(["domain", "topic_matches"])
for domain in domains(args.file):
    name = domain.rsplit(".", 1)[0]
    matches = [word for word in args.keywords if word.lower() in name]
    if matches:
        writer.writerow([domain, ";".join(matches)])

To automate input downloads, follow the API documentation for tokens, supported endpoints, and historical dates. Keep API tokens out of shared scripts.