n8n-nodes-link-checker

n8n community node for the Siemens Link Checker Service — a self-hosted, cached broken-link checker. This node lets your n8n workflows check whether URLs are broken and pull link-checker statistics, without exposing your backend to direct outbound requests.

This node wraps a self-hosted service. You need a running instance of link-checker-service (e.g. via its docker-compose up or the published ghcr.io/siemens/link-checker-service image) — this package does not include or bundle the service itself.

Installation

In n8n: Settings → Community Nodes → Install → enter n8n-nodes-link-checker.

Or via CLI, in your n8n installation:

npm install n8n-nodes-link-checker

Credentials

Credential type: Link Checker Service API

| Field | Description | |---|---| | Base URL | Address of your running link-checker-service instance (e.g. http://localhost:8080) | | Authentication | None or Bearer Token — matches whether the service instance has JWT validation enabled (see the service's auth docs) | | Token | JWT bearer token, only shown/sent when Authentication is Bearer Token |

The credential's "Test" button calls GET /version to confirm the base URL is reachable.

Resources & Operations

URL

| Operation | API call | Notes | |---|---|---| | Check | POST /checkUrls | Checks a single URL per node execution (one item in → one HTTP call). To check many URLs, feed multiple items into the node (e.g. via Split Out / a loop) and let n8n's normal per-item execution fan them out. |

Fields:

• URL (required) — the URL to check
• Context (optional) — opaque value echoed back by the service, useful for correlating results
• Simplify (default on) — when on, returns just { url, context, status, http_status, error, timestamp }; when off, returns the full response including check_trace, body_patterns_found, elapsed_ms, and remote_addr

Stats

| Operation | API call | |---|---| | Get | GET /stats — aggregated counters (incoming requests, cache hits/misses, checks ok/broken/errored, etc.) | | Get Domains | GET /stats/domains — per-domain breakdown of the same |

Service

| Operation | API call | Notes | |---|---|---| | Get Version | GET /version | The endpoint returns plain text; this node wraps it as { version: "..." } | | Get Health | GET /readyz | Returns { status: "UP" } |

About the underlying service

Siemens Link Checker Service is a Go-based, self-hosted web service that runs optimized, cached broken-link checks and returns results for a batch of URLs at once (or streamed via /checkUrls/stream, not used by this node). It supports optional JWT-based authentication, per-domain blacklisting, rate limiting, and configurable URL-check plugins (with/without proxy, PAC script support). See its README for deployment and configuration details (Docker, config file, environment variables).

License

MIT