Neo4j Find Business by NameInstall

Overview

This node performs a fuzzy search for business entities in a Neo4j graph database based on a partial or full business name. It connects to a Neo4j instance using provided credentials, executes a Cypher query to find businesses whose names contain the specified search term, and returns matching business records.

Common scenarios:

• Finding business nodes in a Neo4j database when only part of the business name is known.
• Enriching workflows with business data retrieved by name matching.
• Integrating Neo4j-based business directories or CRM systems into automation pipelines.

Practical example:
If you want to find all businesses with names containing "Coffee", you provide "Coffee" as the search term. The node queries Neo4j and returns all matching business nodes, enabling further processing or filtering downstream.

Properties

Output

The node outputs an array of JSON objects, each representing a matched business node from Neo4j. Each output item has a json field structured as follows:

{
  "business": {
    "...": "all properties of the business node",
    "business_id": "the unique identifier of the business"
  }
}

• The business object contains all properties of the matched business node.
• The business_id is explicitly included for convenience.
• If errors occur per item and "Continue On Fail" is enabled, the output includes error details alongside the original input data.

The node does not output binary data.

Dependencies

• Requires a Neo4j database accessible via network.
• Needs credentials including host, port, username, password, and optionally database name.
• The node uses the official Neo4j driver library to connect and run Cypher queries.
• Proper configuration of these credentials in n8n is mandatory for successful execution.

Troubleshooting

• Missing or incomplete credentials:
  Error message: "Neo4j credentials are not fully configured or missing required fields (host, port, username, password)."
  Resolution: Ensure all required credential fields are filled correctly.

• Connection failures:
  Errors during driver connection or session opening indicate network issues, wrong credentials, or unreachable database.
  Resolution: Verify Neo4j server availability, credentials, and network access.

• Cypher query errors:
  Malformed queries or invalid parameters may cause errors.
  Resolution: Confirm the search term is a valid string and that the database schema includes Business nodes with a name property.

• Session closure errors:
  Errors closing the session or driver are logged but do not stop execution.
  Resolution: Usually safe to ignore; ensure proper resource cleanup.

• Handling multiple input items:
  Each input item is processed independently. If one fails and "Continue On Fail" is off, the entire execution stops.

Links and References

• Neo4j Official Documentation
• Cypher Query Language Reference
• Neo4j JavaScript Driver
• n8n Documentation - Creating Nodes