n8n-nodes-friendlycaptcha-solver

This repository contains the n8n community node Friendly Captcha Solver.

This node implements an optimized algorithm based on BLAKE2b to solve Friendly Captcha Proof-of-Work (PoW) puzzles. It allows you to automate workflows that interact with forms or endpoints protected by Friendly Captcha.

Friendly Captcha is a privacy-first, GDPR-compliant anti-bot solution provided by Friendly Captcha GmbH (Germany). Instead of tracking users or asking them to identify objects, it generates a crypto puzzle that the client must solve.

n8n is a fair-code licensed workflow automation platform.

⚠️ Disclaimer & Legal Notice

This project is an independent community contribution and is NOT affiliated with, endorsed by, or connected to Friendly Captcha GmbH.

The logic implemented in this node is a custom, JavaScript-optimized re-implementation of the puzzle-solving algorithm publicly documented and used client-side by Friendly Captcha. It is intended for legitimate automation testing and educational purposes. All trademarks remain the property of their respective owners.

For official information, please refer to the Friendly Captcha Imprint and their Official Source Code.

• Installation
• Compatibility
• Features
• Usage
• Examples
• Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Compatibility

This node has been developed for modern versions of n8n. It requires an environment that supports Node.js execution.

Features

• Optimized BLAKE2b Implementation: Uses a custom, unrolled implementation of the hashing algorithm for high performance in JavaScript environments.
• Multi-Threading Support: Can utilize Node.js Worker Threads to calculate solutions faster by parallelizing the workload.
• Binary Pass-through: Any binary data (e.g., files, images) entering the node is passed through unchanged.

Usage

Input

The node requires the Puzzle String provided by the Friendly Captcha API (often retrieved from the target website's HTML or an API response, e.g. https://eu-api.friendlycaptcha.eu/api/v1/puzzle).

Parameters

• Puzzle String: The complete puzzle string.
• Use Multi-Threading: Enable this option to speed up the calculation of complex puzzles.
  • CPU Threads: Specify the number of parallel threads to use (1-32). Defaults to 4.
• Set Max Iterations: Override the default maximum number of attempts per puzzle segment.
  • Max Iterations: Default is 10 million.
• Set Max Puzzle Segments: Override the default maximum number of puzzle segments allowed.
  • Max Puzzle Segments: Default is 100.
• Ignore Errors: If set to true, the node will output success: false instead of throwing an error and stopping the workflow when a puzzle cannot be solved.

Output

The node returns a JSON object containing the solution and status. Input binary data is forwarded to the output item unchanged.

Key output properties:

• success: true if the puzzle was solved successfully, false otherwise.
• solution: The calculated solution string required to bypass the captcha (only present if successful).
• error: An error message explaining why the calculation failed (only present if success is false).

Examples

Example #1 – Successfully Solved

Input was a valid puzzle string. The node returns the solution key which can be sent in a POST request payload (usually as the solution field).

{
  "success": true,
  "solution": "P0.123abc... (truncated solution string)"
}

Example #2 – Execution Error (with Ignore Errors enabled)

If the puzzle string is invalid or empty, and "Ignore Errors" is enabled, the node returns:

{
  "success": false,
  "error": "Puzzle string is empty"
}

Resources

• n8n community nodes documentation
• Friendly Captcha Documentation
• Friendly Captcha GitHub