n8n

n8n is a workflow automation platform that lets you connect APIs, build agents, and automate tasks with a visual editor or code. The You.com community node brings real-time web search and content extraction directly into your n8n workflows, so you can ground AI agents in fresh web data or pipe search results into any downstream step.

The @youdotcom-oss/n8n-nodes-youdotcom package provides a single node with two operations: Search and Get Contents. It also works as an AI agent tool, so n8n’s built-in AI agents can call You.com search on demand.

Getting Started

Install the node

In your n8n instance, go to Settings > Community Nodes and install:

@youdotcom-oss/n8n-nodes-youdotcom

Or install via the CLI:

$
npm install @youdotcom-oss/n8n-nodes-youdotcom

Set up credentials

1. In n8n, go to Credentials > New Credential and select You.com API
2. Paste your API key from you.com/platform/api-keys
3. Click Test to verify the key works

Operations

Search

Search the web with the You.com Search API. Returns structured results with titles, URLs, descriptions, and snippets.

Required: query (the search query)

Optional parameters:

The query field supports search operators: site:, filetype:, +, -, AND, OR, NOT.

Get Contents

Fetch and extract clean content from web pages using the You.com Contents API.

Required: urls (comma-separated list of URLs)

Optional parameters:

Returns cleaned page content in your chosen format, plus metadata (JSON-LD, OpenGraph, Twitter Cards) when requested.

Use as an AI agent tool

The You.com node has usableAsTool enabled, which means n8n’s built-in AI agents can call it directly. Add the You.com node as a tool in any AI Agent workflow, and the agent will be able to search the web or extract page content on its own.

Resources