A Python script to check a website for broken links, also known as link rot or reference rot.

How To Install It

Install using:

pip3 install refrot

How To Use It

By default refrot checks all internal links, no matter how many levels, and a single level of external links.

refrot <url>


-h --help                   Show help.
-i --ignore-external-links  Ignore external hyperlinks.
-u --user-agent             Send custom user agent string.
-v --version                Show version number.


URLs with status codes other than OK (200) and Temporary Redirect (302) are displayed in the post-run summary.


MIT license.

Contact Me

Send bug reports and patches to