link-checker

n8n community node for the Siemens Link Checker Service (broken link checking)

Package Information

Released: 1 mo ago
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: LPilic

Documentation

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

Discussion