SDKs & tools overview
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
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.
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
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.
