You.com Web Access & AI
AI 与智能体by youdotcom-oss
通过 You.com APIs 提供 Web 搜索、AI agent 能力与内容提取,便于统一接入在线信息。
什么是 You.com Web Access & AI?
通过 You.com APIs 提供 Web 搜索、AI agent 能力与内容提取,便于统一接入在线信息。
README
You.com for AI agents
Add real-time web search, research, and content extraction to any agent. Hosted MCP server, free tier with no API key, plus first-party plugins for the Vercel AI SDK and 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" }
}
}
}
If your client supports remote MCP, point it at https://api.you.com/mcp?profile=free directly — no local process needed.
Why You.com
- Real web index — backed by You.com's production search infrastructure, not a scraper.
- Free tier, no signup —
?profile=freeexposesyou-searchto any MCP client with zero auth. - Listed in the official MCP registry as
io.github.youdotcom-oss/mcp. - Works with every major agent stack — Claude, Cursor, Windsurf, VS Code, Vercel AI SDK, LangChain.
- One hosted endpoint — all packages here are thin clients over
https://api.you.com/mcp.
Quick start
Every snippet below works against the free tier. To unlock you-research and you-contents, drop the YDC_PROFILE line and set YDC_API_KEY to a key from you.com/platform/api-keys. you-finance is opt-in — pass ?tools=you-finance on the URL or set YDC_ALLOWED_TOOLS=you-finance.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
Authenticated (all default tools):
{
"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
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
VS Code
Add to your user or workspace mcp.json:
{
"servers": {
"you": {
"command": "npx",
"args": ["@youdotcom-oss/mcp"],
"env": { "YDC_PROFILE": "free" }
}
}
}
Any MCP client (remote)
If your client speaks streamable HTTP, skip the local bridge:
https://api.you.com/mcp?profile=free
Authenticated:
https://api.you.com/mcp
Authorization: Bearer <your-key>
Packages
| Package | What it does |
|---|---|
@youdotcom-oss/mcp | STDIO bridge to the hosted MCP server. Use this when your client needs a local command. |
@youdotcom-oss/ai-sdk-plugin | Vercel AI SDK tools backed by the hosted MCP server. |
@youdotcom-oss/langchain | LangChain.js tools backed by the hosted MCP server. |
@youdotcom-oss/cli | ydc CLI for listing tools, fetching schemas, and invoking remote tools from a shell. |
The free profile (?profile=free) exposes you-search only. The authenticated default exposes you-search, you-research, and you-contents. you-finance is available on request via ?tools=you-finance.
Use cases
Web search inside Claude
Once @youdotcom-oss/mcp is wired into Claude Desktop (see above), ask Claude:
Search the web for the latest releases of Bun and summarize the changes since 1.2.
Claude calls you-search directly. No code required.
Vercel AI SDK agent grounded in real-time web
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();
LangChain agent with cited sources
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);
Links
- API keys: you.com/platform/api-keys
- Platform docs: documentation.you.com
- MCP registry listing:
io.github.youdotcom-oss/mcp - Issues: github.com/youdotcom-oss/dx-toolkit/issues
- Support: support@you.com
Contributing
This is a Bun workspace monorepo. Development setup, workspace commands, and code conventions live in AGENTS.md; contribution flow and PR conventions live in CONTRIBUTING.md. Issues and PRs welcome.
License
MIT — see LICENSE.
常见问题
You.com Web Access & AI 是什么?
通过 You.com APIs 提供 Web 搜索、AI agent 能力与内容提取,便于统一接入在线信息。
相关 Skills
Claude接口
by anthropics
面向接入 Claude API、Anthropic SDK 或 Agent SDK 的开发场景,自动识别项目语言并给出对应示例与默认配置,快速搭建 LLM 应用。
✎ 想把Claude能力接进应用或智能体,用claude-api上手快、兼容Anthropic与Agent SDK,集成路径清晰又省心
RAG架构师
by alirezarezvani
聚焦生产级RAG系统设计与优化,覆盖文档切块、检索链路、索引构建、召回评估等关键环节,适合搭建可扩展、高准确率的知识库问答与检索增强应用。
✎ 面向RAG落地,把知识库、向量检索和生成链路系统串联起来,做架构设计时更清晰,也更少踩坑。
多智能体架构
by alirezarezvani
聚焦多智能体系统架构设计,梳理 Supervisor、Swarm、分层和 Pipeline 等模式,覆盖角色定义、通信协作与性能评估,适合规划稳健可扩展的 AI agent 编排方案。
✎ 帮你系统解决多智能体应用的架构设计与协同编排难题,适合构建复杂 AI 工作流,成熟度高、社区认可也很亮眼。
相关 MCP Server
知识图谱记忆
编辑精选by Anthropic
Memory 是一个基于本地知识图谱的持久化记忆系统,让 AI 记住长期上下文。
✎ 帮 AI 和智能体补上“记不住”的短板,用本地知识图谱沉淀长期上下文,连续对话更聪明,数据也更可控。
顺序思维
编辑精选by Anthropic
Sequential Thinking 是让 AI 通过动态思维链解决复杂问题的参考服务器。
✎ 这个服务器展示了如何让 Claude 像人类一样逐步推理,适合开发者学习 MCP 的思维链实现。但注意它只是个参考示例,别指望直接用在生产环境里。
by deusdata
持久化的代码库知识图谱,可跨会话保留上下文,在 session 重启或上下文压缩后仍能继续使用。
✎ 专治 AI 编程助手“会话失忆”,把代码库沉淀为持久知识图谱,重启或压缩上下文后也能无缝续上开发状态。