Real-time web search, URL content extraction, and cited multi-source research from You.com's production search index. Free keyless tier available.You.com
https://github.com/youdotcom-oss/dx-toolkitBúsqueda web en tiempo real, extracción de contenido de URL e investigación citada de múltiples fuentes desde el índice de búsqueda de producción de You.com. Nivel gratuito sin clave disponible.
Documentación
You.com para agentes de IA
Añade búsqueda web en tiempo real, investigación y extracción de contenido a cualquier agente. Servidor MCP alojado, nivel gratuito sin clave de API, además de plugins de primera parte para el SDK de IA de Vercel y LangChain.
// Add this to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.)
// Free tier — no API key, no signup.
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
Si tu cliente admite MCP remoto, apúntalo directamente a https://api.you.com/mcp?profile=free — no se necesita ningún proceso local.
Por qué You.com
- Índice web real — respaldado por la infraestructura de búsqueda de producción de You.com, no un rastreador.
- Nivel gratuito, sin registro —
?profile=freeexponeyou-searcha cualquier cliente MCP sin autenticación. - Listado en el registro oficial de MCP como
io.github.youdotcom-oss/mcp. - Funciona con todos los principales stacks de agentes — Claude, Cursor, Windsurf, VS Code, Vercel AI SDK, LangChain.
- Un único endpoint alojado — todos los paquetes aquí son clientes ligeros sobre
https://api.you.com/mcp.
Inicio rápido
Cada fragmento a continuación funciona con el nivel gratuito. Para desbloquear you-research y you-contents, elimina la línea YDC_PROFILE y establece YDC_API_KEY con una clave de you.com/platform/api-keys. you-finance es opcional — pasa ?tools=you-finance en la URL o establece YDC_ALLOWED_TOOLS=you-finance.
Claude Desktop
Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
Autenticado (todas las herramientas predeterminadas):
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_API_KEY": "<your-key>" }
}
}
}
Claude Code
# Free tier
claude mcp add you -e YDC_PROFILE=free -- npx @youdotcom-oss/mcp
# Authenticated
claude mcp add you -e YDC_API_KEY=<your-key> -- npx @youdotcom-oss/mcp
Cursor
Añade a ~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto):
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
Windsurf
Añade a ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
VS Code
Añade a tu mcp.json de usuario o espacio de trabajo:
{
"servers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
Cualquier cliente MCP (remoto)
Si tu cliente habla HTTP transmisible, omite el puente local:
https://api.you.com/mcp?profile=free
Autenticado:
https://api.you.com/mcp
Authorization: Bearer <your-key>
Paquetes
| Paquete | Qué hace |
|---|---|
@youdotcom-oss/mcp | Puente STDIO al servidor MCP alojado. Úsalo cuando tu cliente necesite un comando local. |
@youdotcom-oss/ai-sdk-plugin | Herramientas del SDK de IA de Vercel respaldadas por el servidor MCP alojado. |
@youdotcom-oss/langchain | Herramientas de LangChain.js respaldadas por el servidor MCP alojado. |
@youdotcom-oss/cli | CLI de ydc para listar herramientas, obtener esquemas e invocar herramientas remotas desde una terminal. |
El perfil gratuito (?profile=free) expone solo you-search. El autenticado predeterminado expone you-search, you-research y you-contents. you-finance está disponible bajo petición a través de ?tools=you-finance.
Casos de uso
Búsqueda web dentro de Claude
Una vez que @youdotcom-oss/mcp esté conectado a Claude Desktop (ver arriba), pídele a Claude:
Busca en la web las últimas versiones de Bun y resume los cambios desde la 1.2.
Claude llama a you-search directamente. No se requiere código.
Agente del SDK de IA de Vercel basado en web en tiempo real
import { createAnthropic } from '@ai-sdk/anthropic';
import { generateText, stepCountIs } from 'ai';
import { createYouClient } from '@youdotcom-oss/ai-sdk-plugin';
const client = await createYouClient({ apiKey: process.env.YDC_API_KEY });
const tools = await client.tools();
const result = await generateText({
model: createAnthropic()('claude-sonnet-4-5-20250929'),
tools,
stopWhen: stepCountIs(5),
prompt: 'What shipped in the latest Bun release?',
});
console.log(result.text);
await client.close();
Agente de LangChain con fuentes citadas
import { createAgent, initChatModel } from 'langchain';
import { createYouClient } from '@youdotcom-oss/langchain';
const client = await createYouClient({ apiKey: process.env.YDC_API_KEY });
const tools = await client.getTools();
const agent = createAgent({
model: await initChatModel('claude-haiku-4-5'),
tools,
systemPrompt: 'You are a research assistant. Always cite your sources.',
});
const result = await agent.invoke({
messages: [{ role: 'user', content: 'Latest developments in quantum computing?' }],
});
console.log(result);
Enlaces
- Claves de API: you.com/platform/api-keys
- Documentación de la plataforma: documentation.you.com
- Listado en el registro de MCP:
io.github.youdotcom-oss/mcp - Problemas: github.com/youdotcom-oss/dx-toolkit/issues
- Soporte: support@you.com
Contribuciones
Este es un monorepo de espacio de trabajo Bun. La configuración de desarrollo, los comandos del espacio de trabajo y las convenciones de código están en AGENTS.md; el flujo de contribuciones y las convenciones de PR están en CONTRIBUTING.md. Se aceptan problemas y PRs.
Licencia
MIT — ver LICENSE.