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
  • Choose your path
  • Most common setups
  • How it works
  • AI Frameworks
  • Developer Tools & SDKs
  • Automation Platforms
  • Official SDKs
  • Next steps

SDKs & tools overview

One API, every agent surface. Pick the integration that matches how you're already building.
|View as Markdown|Open in Claude|
Was this page helpful?
Built with

You.com meets your agents wherever they run — MCP clients, Python and TypeScript codebases, Claude Skills, and the major agent frameworks. Every tool in this section wraps the same three APIs: Search, Contents, and Research. Switching between integrations is a transport change, not a capability change. One API key works across everything.

Choose your path

If you’re building with…UseWhy
Claude Code, Cursor, Windsurf, VS Code, or any MCP clientMCP ServerZero-config web access for your IDE or agent — free to start, no API key required
PythonPython SDKTyped client with async support, retries, and full Search / Contents / Research coverage
TypeScript or Node.jsTypeScript SDKFirst-class types, edge-runtime compatible, works in Next.js and Vercel AI SDK
Claude Agent SDK or Claude.aiSkillsDrop-in capability modules that give Claude grounded web search
LangChain, LangGraph, LlamaIndex, Vercel AI SDK, n8n, OpenAI GPT OSS, ZapierFramework integrationsNative tools and retrievers — no wrapper code required

Most common setups

Building an agent in an IDE

Use the MCP Server. Five-line config, works with Claude Code and every major IDE. Run it locally without an API key to start, or connect to the remote server for OAuth 2.1 auth and higher rate limits.

Building a production agent in code

Use the Python SDK or TypeScript SDK, depending on your stack. Layer in a framework integration if you’re using LangChain, LangGraph, or the Vercel AI SDK.

Adding web grounding to Claude

Use Skills. Ships as a capability module Claude can invoke directly — works with the Claude Agent SDK and Claude.ai.

No-code or workflow automation

Use n8n or Zapier.

How it works

Every integration in this section hits the same APIs:

  • Search — live-crawled web and news results with LLM-ready snippets
  • Contents — full page content extraction from URLs you already have
  • Research — multi-step synthesis for deep information gathering
  • Finance Research — citation-backed answers from a finance-optimized index (available via MCP as you-finance)

That means:

  • You get the same data, the same filtering controls, and the same rate limits regardless of which integration you pick
  • Switching between MCP and the SDKs — or between frameworks — is a transport change, not a capability change
  • One API key works across everything

AI Frameworks

LangChain

Use YouSearchTool, YouContentsTool, and YouRetriever from the langchain-youdotcom package to add real-time web search to LangChain agents and RAG pipelines.

LangGraph

Build stateful, multi-step agents with real-time web search using YouSearchTool and YouContentsTool in LangGraph workflows.

LlamaIndex

Use the llama-index-retrievers-you package to add real-time web and news retrieval to LlamaIndex applications.

Developer Tools & SDKs

Vercel AI SDK

Add youSearch() and youContents() as tools in any Vercel AI SDK application with the @youdotcom-oss/ai-sdk-plugin package.

OpenAI GPT OSS

You.com powers the default web browsing backend for OpenAI’s open-weight GPT OSS models via YouComBackend.

MCP Server

Connect You.com directly to any MCP-enabled IDE — Cursor, VS Code, Claude Code, Windsurf, and more.

Claude Skills

Drop-in capability modules that give Claude grounded web search via the Claude Agent SDK and Claude.ai.

Automation Platforms

n8n

Use the @youdotcom-oss/n8n-nodes-youdotcom community node to add web search and content extraction to n8n workflows and AI agents.

Zapier

Connect You.com Search, Content, and Research APIs to 8,000+ apps — no code required.

Official SDKs

Python SDK

Official Python SDK for Search, Contents, and Research APIs.

TypeScript SDK

Official TypeScript SDK for Search, Contents, and Research APIs.

Next steps

Quickstart

Get an API key and run your first call in five minutes

Examples

Working templates for RAG, agents, and research

API reference

Full parameter and schema docs for every endpoint

Developer guide

Patterns, best practices, and production tips