linkchecker

library10.6.0pypypiunverified

LinkChecker is a free, GPL-licensed website validator that checks links in web documents or full websites. It supports recursive and multithreaded checking, various output formats (text, HTML, SQL, CSV, XML), proxy support, and honors the robots.txt exclusion protocol. The current version is 10.6.0 and it is actively maintained with frequent releases, often multiple times a year.

testing http-networking web-framework

pip install linkchecker

github ↗package ↗homepage ↗changelog ↗

INSTALL

IMPORT

SIG · LINKCHECKER

linkchecker

testingpythonv10.6.0

Install

2.7s avg

Import

—

Disk

25MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v10.6.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

installs and imports cleanly · install 0.0s · import 0.000s · 26.6MB

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 2.7s · import 0.000s · 27MB

25MB installed

● package 25MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

linkchecker

✓ This is primarily a command-line tool. Direct programmatic import of the main 'linkchecker' utility is not the standard usage pattern. Instead, execute it as a shell command.

✗ import linkchecker

The 'linkchecker' package itself is typically used as a standalone command-line executable, not as a Python library for direct function calls. Trying to `import linkchecker` will likely result in a `ModuleNotFoundError` or expose an internal API not intended for public use.

To check a website for broken links, execute the `linkchecker` command followed by the URL in your terminal. This command will recursively validate pages starting from the given URL and check external links without recursing into them.

linkchecker https://www.example.com

linkchecker --version

Debug

Known issues

breakingLinkChecker transitioned from Python 2 to Python 3 with version 10.0.0. Older versions (pre-10.0.0) are incompatible with Python 3 environments.

fix

Ensure you are running Python 3.9+ and install LinkChecker version 10.0.0 or later.

affects: <10.0.0

breakingThe minimum required Python version has progressively increased. LinkChecker 10.4.0 and later requires Python 3.9+. Earlier versions had lower requirements (e.g., 3.7 for v10.2.0, 3.8 for v10.3.0).

fix

Upgrade your Python environment to 3.9 or newer before installing LinkChecker.

affects: <10.4.0

deprecatedSupport for checking NNTP and Telnet links was removed in version 10.3.0.

fix

If you rely on NNTP or Telnet link checking, you will need to use an older version of LinkChecker or find an alternative solution for these protocols.

affects: >=10.3.0

gotchaPrior to version 10.6.0, LinkChecker did not verify the SSL/TLS certificate of the HTTPS connection when an HTTP URL redirected to HTTPS. This could lead to security vulnerabilities.

fix

Upgrade to LinkChecker 10.6.0 or later to ensure proper HTTPS certificate verification for redirected links.

affects: <10.6.0

gotchaLinkChecker often reports HTTP 301 (Moved Permanently) redirects as warnings by default, which can result in verbose output.

fix

To suppress these warnings, use the `--ignore-warnings=http-redirected` command-line option or configure `ignorewarningsforurls` in your `.linkcheckerrc` configuration file (available since v10.5.0).

affects: All versions

gotchaWhen checking slow or under-development sites, LinkChecker may report many timeouts.

fix

Increase the default timeout duration using the `--timeout=SECONDS` command-line option (e.g., `--timeout=300` for 5 minutes).

affects: All versions

Upgrade

Version history

10.6.0latest on PyPI · released Jul 28, 2025

Audit

Dependencies

PythonrequiredRequires Python 3.9 or later.

BeautifulSoup4requiredUsed for parsing HTML; minimum version 4.8.1 required since v10.0.1.

Agent activity

13 hits · last 30 days

node

Resources

githubhttps://github.com/linkchecker/linkchecker ↗

packagehttps://pypi.org/project/linkchecker/ ↗

homepagehttps://linkchecker.github.io/linkchecker/ ↗

changeloghttps://github.com/linkchecker/linkchecker/blob/master/doc/changelog.txt ↗