A Python script that walks through your site and lists every broken link with the page it sits on

Example result

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  Folder: sales/2026-10, 9 files found
2026-11-02 09:14:03 INFO  shop-01.csv: 1,284 rows
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 rows
2026-11-02 09:14:04 WARN  shop-07.csv: 3 rows without a price skipped (lines 88, 412, 913)
2026-11-02 09:14:05 INFO  Done: 10,412 rows -> report-2026-10.xlsx (sheets "Sales" and "Totals")

[columns]
date = Date, Sale date, Day
product = Product, Item, Name
quantity = Qty, Quantity, Pcs
price = Price, Unit price

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """Reads one shop's file and gives it the report's column names."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: no column for '{name}' (looked for {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

About this service

Links that lead nowhere annoy visitors and make a site look neglected: old blog posts pointing to pages you removed, product links after a catalogue change, partner sites that closed. This Python script starts at your home page, follows your site's own links page by page and checks every link and, from Standard, every picture it finds. It saves a list of the broken ones with the error, the page where each sits and the link text, so you know what to fix and where. It reads only open pages, at a polite pace you set, and never logs in. Links that pages add with JavaScript after loading may be missed. It is meant for your own site. You run it on your computer and fix the links yourself.

What is included

• What you getA ZIP archive with the Python script, a README with step-by-step instructions and, from Standard, a settings file with the start page, limits and pace; the code is also shown on the order page.
• Where each link sitsThe page, the link text and the error
• Internal and outgoingLinks to your pages and to other sites
• Polite paceA pause between requests you set
• Open pages onlyNo logging in, no getting around protection
• Readable codeWith comments, easy to change limits later

How it works

1. 1
   TaskYou give the site address and what to check
2. 2
   CodeWe write the script and the guide to running it
3. 3
   Try itYou run it with a small page limit first, then on the whole site
4. 4
   ChangesYou ask for changes within your package and send any error message

What we need from you

The address of your site, roughly how many pages it has and any sections to leave out (search results, filters, the cart, admin pages). Whether to check pictures and links to other sites as well as your own pages. How fast it may go: one page a second is a polite default. The report format you prefer (CSV or Excel) and your system: Windows, macOS or Linux.

We will ask you:

• What is your site's address?
• What should it check?
• Anything to leave out?
• Where will it run?

Compare packages

Questions and answers

Did not find your answer? Ask us