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=free expone you-search a 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

PaqueteQué hace
@youdotcom-oss/mcpPuente STDIO al servidor MCP alojado. Úsalo cuando tu cliente necesite un comando local.
@youdotcom-oss/ai-sdk-pluginHerramientas del SDK de IA de Vercel respaldadas por el servidor MCP alojado.
@youdotcom-oss/langchainHerramientas de LangChain.js respaldadas por el servidor MCP alojado.
@youdotcom-oss/cliCLI 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

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.