> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-staging.you.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-staging.you.com/_mcp/server.

# n8n

[n8n](https://n8n.io) 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`](https://www.npmjs.com/package/@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:

```bash
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](https://you.com/platform)
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**:

| Parameter           | Description                          | Values                                               |
| ------------------- | ------------------------------------ | ---------------------------------------------------- |
| `count`             | Max results per section              | 1–100 (default: 10)                                  |
| `livecrawl`         | Fetch full page content in real time | `web`, `news`, or `all`                              |
| `livecrawl_formats` | Format for live-crawled content      | `html` or `markdown` (default: `markdown`)           |
| `freshness`         | Recency filter                       | `day`, `week`, `month`, or `year`                    |
| `safesearch`        | Content moderation                   | `off`, `moderate`, or `strict` (default: `moderate`) |
| `country`           | Geographical focus                   | 36 country codes (US, GB, DE, FR, etc.)              |
| `language`          | Result language                      | BCP 47 codes (default: `EN`)                         |
| `offset`            | Pagination offset                    | 0–9 (default: 0)                                     |

The query field supports [search operators](/docs/guides/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**:

| Parameter       | Description              | Values                                               |
| --------------- | ------------------------ | ---------------------------------------------------- |
| `formats`       | Output formats           | `markdown`, `html`, `metadata` (default: `markdown`) |
| `crawl_timeout` | Crawl timeout in seconds | 1–60 (default: 30)                                   |

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](https://docs.n8n.io/advanced-ai/ai-agent-node/) 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

Source code for the n8n community node

Install from npm

How to install and manage community nodes in n8n

Full Search API parameters and response schema

Full Contents API parameters and response schema