***

title: n8n
'og:title': You.com + n8n | Web Search and Content Extraction for n8n Workflows
'og:description': >-
Add real-time web search and content extraction to n8n workflows using the
@youdotcom-oss/n8n-nodes-youdotcom community node.
--------------------------------------------------

[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/api-keys](https://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**:

| 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](/search/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

<CardGroup cols={2}>
  <Card title="GitHub Repository" icon="fa-brands fa-github" href="https://github.com/youdotcom-oss/n8n-nodes-youdotcom">
    Source code for the n8n community node
  </Card>

  <Card title="npm Package" icon="fa-brands fa-npm" href="https://www.npmjs.com/package/@youdotcom-oss/n8n-nodes-youdotcom">
    Install from npm
  </Card>

  <Card title="n8n Community Nodes" icon="fa-regular fa-puzzle-piece" href="https://docs.n8n.io/integrations/community-nodes/">
    How to install and manage community nodes in n8n
  </Card>

  <Card title="Search API Reference" icon="fa-regular fa-magnifying-glass" href="/api-reference/search/v1-search">
    Full Search API parameters and response schema
  </Card>

  <Card title="Contents API Reference" icon="fa-regular fa-file-lines" href="/api-reference/contents/contents">
    Full Contents API parameters and response schema
  </Card>
</CardGroup>