For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Go to Platform
HomeSDKs & toolsAPI referencePricing
    • Overview
  • Build with agents
    • MCP Server
    • Skills
  • SDKs
    • Python SDK
    • TypeScript SDK
  • Integrations
    • crewAI
    • LangChain
    • LangGraph
    • n8n
    • LlamaIndex
    • OpenAI GPT OSS
    • Vercel AI SDK
    • Zapier
  • Guides
    • Developer guide
    • Build an Automated Fact Checker With You.com
LogoLogo
HomeSDKs & toolsAPI referencePricing
LogoLogo
Go to Platform
On this page
  • Getting Started
  • Install the node
  • Set up credentials
  • Operations
  • Search
  • Get Contents
  • Use as an AI agent tool
  • Resources
Integrations

n8n

|View as Markdown|Open in Claude|
Was this page helpful?
Built with

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
  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:

ParameterDescriptionValues
countMax results per section1–100 (default: 10)
livecrawlFetch full page content in real timeweb, news, or all
livecrawl_formatsFormat for live-crawled contenthtml or markdown (default: markdown)
freshnessRecency filterday, week, month, or year
safesearchContent moderationoff, moderate, or strict (default: moderate)
countryGeographical focus36 country codes (US, GB, DE, FR, etc.)
languageResult languageBCP 47 codes (default: EN)
offsetPagination offset0–9 (default: 0)

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:

ParameterDescriptionValues
formatsOutput formatsmarkdown, html, metadata (default: markdown)
crawl_timeoutCrawl timeout in seconds1–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 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

GitHub Repository

Source code for the n8n community node

npm Package

Install from npm

n8n Community Nodes

How to install and manage community nodes in n8n

Search API Reference

Full Search API parameters and response schema

Contents API Reference

Full Contents API parameters and response schema