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

# SDKs & tools overview

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…                                                     | Use                                                  | Why                                                                                      |
| ---------------------------------------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Claude Code, Cursor, Windsurf, VS Code, or any MCP client                    | [**MCP Server**](/docs/build-with-agents/mcp-server) | Zero-config web access for your IDE or agent — free to start, no API key required        |
| Python                                                                       | [**Python SDK**](/docs/sdks/python-sdk)              | Typed client with async support, retries, and full Search / Contents / Research coverage |
| TypeScript or Node.js                                                        | [**TypeScript SDK**](/docs/sdks/typescript-sdk)      | First-class types, edge-runtime compatible, works in Next.js and Vercel AI SDK           |
| Claude Agent SDK or Claude.ai                                                | [**Skills**](/docs/build-with-agents/skills)         | Drop-in capability modules that give Claude grounded web search                          |
| LangChain, LangGraph, LlamaIndex, Vercel AI SDK, n8n, OpenAI GPT OSS, Zapier | [**Framework integrations**](#ai-frameworks)         | Native tools and retrievers — no wrapper code required                                   |

## Most common setups

Use the [MCP Server](/docs/build-with-agents/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.

Use the [Python SDK](/docs/sdks/python-sdk) or [TypeScript SDK](/docs/sdks/typescript-sdk), depending on your stack. Layer in a framework integration if you're using [LangChain](/docs/integrations/langchain), [LangGraph](/docs/integrations/langgraph), or the [Vercel AI SDK](/docs/integrations/vercel-ai-sdk).

Use [Skills](/docs/build-with-agents/skills). Ships as a capability module Claude can invoke directly — works with the Claude Agent SDK and Claude.ai.

Use [n8n](/docs/integrations/n8n) or [Zapier](/docs/integrations/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

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

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

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

## Developer Tools & SDKs

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

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

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

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

## Automation Platforms

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

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

## Official SDKs

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

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

## Next steps

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

Working templates for RAG, agents, and research

Full parameter and schema docs for every endpoint

Patterns, best practices, and production tips