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

# 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

<AccordionGroup>
  <Accordion title="Building an agent in an IDE">
    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.
  </Accordion>

  <Accordion title="Building a production agent in code">
    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).
  </Accordion>

  <Accordion title="Adding web grounding to Claude">
    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.
  </Accordion>

  <Accordion title="No-code or workflow automation">
    Use [n8n](/docs/integrations/n8n) or [Zapier](/docs/integrations/zapier).
  </Accordion>
</AccordionGroup>

## How it works

Every integration in this section hits the same three 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

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

<CardGroup cols={2}>
  <Card title="LangChain" icon="fa-brands fa-python" href="/docs/integrations/langchain">
    Use `YouSearchTool`, `YouContentsTool`, and `YouRetriever` from the `langchain-youdotcom` package to add real-time web search to LangChain agents and RAG pipelines.
  </Card>

  <Card title="LangGraph" icon="fa-regular fa-diagram-project" href="/docs/integrations/langgraph">
    Build stateful, multi-step agents with real-time web search using `YouSearchTool` and `YouContentsTool` in LangGraph workflows.
  </Card>

  <Card title="LlamaIndex" icon="fa-regular fa-layer-group" href="/docs/integrations/llamaindex">
    Use the `llama-index-retrievers-you` package to add real-time web and news retrieval to LlamaIndex applications.
  </Card>
</CardGroup>

## Developer Tools & SDKs

<CardGroup cols={2}>
  <Card title="Vercel AI SDK" icon="fa-brands fa-js" href="/docs/integrations/vercel-ai-sdk">
    Add `youSearch()` and `youContents()` as tools in any Vercel AI SDK application with the `@youdotcom-oss/ai-sdk-plugin` package.
  </Card>

  <Card title="OpenAI GPT OSS" icon="fa-regular fa-brain" href="/docs/integrations/gpt-oss">
    You.com powers the default web browsing backend for OpenAI's open-weight GPT OSS models via `YouComBackend`.
  </Card>

  <Card title="MCP Server" icon="fa-regular fa-plug" href="/docs/build-with-agents/mcp-server">
    Connect You.com directly to any MCP-enabled IDE — Cursor, VS Code, Claude Code, Windsurf, and more.
  </Card>

  <Card title="Claude Skills" icon="fa-regular fa-sparkles" href="/docs/build-with-agents/skills">
    Drop-in capability modules that give Claude grounded web search via the Claude Agent SDK and Claude.ai.
  </Card>
</CardGroup>

## Automation Platforms

<CardGroup cols={2}>
  <Card title="n8n" icon="fa-regular fa-diagram-project" href="/docs/integrations/n8n">
    Use the `@youdotcom-oss/n8n-nodes-youdotcom` community node to add web search and content extraction to n8n workflows and AI agents.
  </Card>

  <Card title="Zapier" icon="fa-regular fa-bolt" href="/docs/integrations/zapier">
    Connect You.com Search, Content, and Research APIs to 8,000+ apps — no code required.
  </Card>
</CardGroup>

## Official SDKs

<CardGroup cols={2}>
  <Card title="Python SDK" icon="fa-brands fa-python" href="/docs/sdks/python-sdk">
    Official Python SDK for Search, Contents, and Research APIs.
  </Card>

  <Card title="TypeScript SDK" icon="fa-brands fa-js" href="/docs/sdks/typescript-sdk">
    Official TypeScript SDK for Search, Contents, and Research APIs.
  </Card>
</CardGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" href="/docs/quickstart">
    Get an API key and run your first call in five minutes
  </Card>

  <Card title="Examples" href="/docs/examples">
    Working templates for RAG, agents, and research
  </Card>

  <Card title="API reference" href="/docs/api-reference/search/v1-search">
    Full parameter and schema docs for every endpoint
  </Card>

  <Card title="Developer guide" href="/docs/guides/developer-guide">
    Patterns, best practices, and production tips
  </Card>
</CardGroup>