Vercel AI SDK

Integrate You.com’s real-time web search and webpage content extraction capabilities into any application you’ve built with Vercel’s AI SDK.

The @youdotcom-oss/ai-sdk-plugin package provides three ready-made tools for the Vercel AI SDK:

youSearch() for real-time web and news search
youContents() for page content extraction
youResearch() for comprehensive web research with citations

Drop all three into any generateText, streamText, or generateObject call to give your AI application real-time web access.

Starting from scratch? We recommend using Skills, so your agent can build this integration for you. Learn how.

Getting Started

Install the package

$ npm install @youdotcom-oss/ai-sdk-plugin

Set your API key

$ export YDC_API_KEY=your_api_key

Get your API key at you.com/platform.

Usage

Web search with `youSearch`

Use youSearch() to give a model access to structured real-time web and news results.

1 import { generateText, isStepCount } from "ai";
2 import { youSearch } from "@youdotcom-oss/ai-sdk-plugin";
3 import { anthropic } from "@ai-sdk/anthropic";
4 
5 const { text } = await generateText({
6   model: anthropic("claude-sonnet-4-5"),
7   prompt: "What happened in San Francisco last week?",
8   tools: {
9     search: youSearch(),
10   },
11   stopWhen: isStepCount(3),
12 });
13 
14 console.log(text);

Content extraction with `youContents`

Use youContents() when the model needs to retrieve entire web page content as HTML or markdown.

1 import { generateText, isStepCount } from "ai";
2 import { youContents } from "@youdotcom-oss/ai-sdk-plugin";
3 import { anthropic } from "@ai-sdk/anthropic";
4 
5 const { text } = await generateText({
6   model: anthropic("claude-sonnet-4-5"),
7   prompt: "Summarize the content from vercel.com/blog",
8   tools: {
9     extract: youContents(),
10   },
11   stopWhen: isStepCount(3),
12 });
13 
14 console.log(text);

Research with `youResearch`

Use youResearch() when the model needs comprehensive, synthesized answers with inline citations. The Research API supports effort levels (lite, standard, deep, exhaustive) to balance speed against thoroughness—the model selects the appropriate level automatically.

1 import { generateText, isStepCount } from "ai";
2 import { youResearch } from "@youdotcom-oss/ai-sdk-plugin";
3 import { anthropic } from "@ai-sdk/anthropic";
4 
5 const { text } = await generateText({
6   model: anthropic("claude-sonnet-4-5"),
7   prompt: "What are the tradeoffs between WebSockets and Server-Sent Events for real-time applications?",
8   tools: {
9     research: youResearch(),
10   },
11   stopWhen: isStepCount(3),
12 });
13 
14 console.log(text);

Combining all three tools

You can provide all three tools at once and let the model decide which to use:

1 import { generateText, isStepCount } from "ai";
2 import { youSearch, youContents, youResearch } from "@youdotcom-oss/ai-sdk-plugin";
3 import { anthropic } from "@ai-sdk/anthropic";
4 
5 const { text } = await generateText({
6   model: anthropic("claude-sonnet-4-5"),
7   prompt: "Find recent blog posts about the Vercel AI SDK, then extract and summarize the top result.",
8   tools: {
9     search: youSearch(),
10     extract: youContents(),
11     research: youResearch(),
12   },
13   stopWhen: isStepCount(5),
14 });
15 
16 console.log(text);

Passing the API key explicitly

If you prefer not to use environment variables, pass the key directly:

1 import { youSearch, youContents, youResearch } from "@youdotcom-oss/ai-sdk-plugin";
2 
3 const searchTool = youSearch({ apiKey: "api_key" });
4 const contentsTool = youContents({ apiKey: "api_key" });
5 const researchTool = youResearch({ apiKey: "api_key" });

Resources

GitHub Repository

Source code for the AI SDK plugin

Vercel AI SDK Docs

Official Vercel AI SDK documentation

Search API Reference

Full Search API parameters and response schema

Contents API Reference

Full Contents API parameters and response schema

Research API Reference

Full Research API parameters and response schema

Integrate You.com’s real-time web search and webpage content extraction capabilities into any application you’ve built with Vercel’s AI SDK.

The @youdotcom-oss/ai-sdk-plugin package provides three ready-made tools for the Vercel AI SDK:

youSearch() for real-time web and news search
youContents() for page content extraction
youResearch() for comprehensive web research with citations

Drop all three into any generateText, streamText, or generateObject call to give your AI application real-time web access.

Starting from scratch? We recommend using Skills, so your agent can build this integration for you. Learn how.

Getting Started

Install the package

$ npm install @youdotcom-oss/ai-sdk-plugin

Set your API key

$ export YDC_API_KEY=your_api_key

Get your API key at you.com/platform.

Usage

Web search with `youSearch`

Use youSearch() to give a model access to structured real-time web and news results.

1 import { generateText, isStepCount } from "ai";
2 import { youSearch } from "@youdotcom-oss/ai-sdk-plugin";
3 import { anthropic } from "@ai-sdk/anthropic";
4 
5 const { text } = await generateText({
6   model: anthropic("claude-sonnet-4-5"),
7   prompt: "What happened in San Francisco last week?",
8   tools: {
9     search: youSearch(),
10   },
11   stopWhen: isStepCount(3),
12 });
13 
14 console.log(text);

Content extraction with `youContents`

Use youContents() when the model needs to retrieve entire web page content as HTML or markdown.

1 import { generateText, isStepCount } from "ai";
2 import { youContents } from "@youdotcom-oss/ai-sdk-plugin";
3 import { anthropic } from "@ai-sdk/anthropic";
4 
5 const { text } = await generateText({
6   model: anthropic("claude-sonnet-4-5"),
7   prompt: "Summarize the content from vercel.com/blog",
8   tools: {
9     extract: youContents(),
10   },
11   stopWhen: isStepCount(3),
12 });
13 
14 console.log(text);

Research with `youResearch`

1 import { generateText, isStepCount } from "ai";
2 import { youResearch } from "@youdotcom-oss/ai-sdk-plugin";
3 import { anthropic } from "@ai-sdk/anthropic";
4 
5 const { text } = await generateText({
6   model: anthropic("claude-sonnet-4-5"),
7   prompt: "What are the tradeoffs between WebSockets and Server-Sent Events for real-time applications?",
8   tools: {
9     research: youResearch(),
10   },
11   stopWhen: isStepCount(3),
12 });
13 
14 console.log(text);

Combining all three tools

You can provide all three tools at once and let the model decide which to use:

1 import { generateText, isStepCount } from "ai";
2 import { youSearch, youContents, youResearch } from "@youdotcom-oss/ai-sdk-plugin";
3 import { anthropic } from "@ai-sdk/anthropic";
4 
5 const { text } = await generateText({
6   model: anthropic("claude-sonnet-4-5"),
7   prompt: "Find recent blog posts about the Vercel AI SDK, then extract and summarize the top result.",
8   tools: {
9     search: youSearch(),
10     extract: youContents(),
11     research: youResearch(),
12   },
13   stopWhen: isStepCount(5),
14 });
15 
16 console.log(text);

Passing the API key explicitly

If you prefer not to use environment variables, pass the key directly:

1 import { youSearch, youContents, youResearch } from "@youdotcom-oss/ai-sdk-plugin";
2 
3 const searchTool = youSearch({ apiKey: "api_key" });
4 const contentsTool = youContents({ apiKey: "api_key" });
5 const researchTool = youResearch({ apiKey: "api_key" });

Resources

GitHub Repository

Source code for the AI SDK plugin

Vercel AI SDK Docs

Official Vercel AI SDK documentation

Search API Reference

Full Search API parameters and response schema

Contents API Reference

Full Contents API parameters and response schema

Research API Reference

Full Research API parameters and response schema

1	import { generateText, isStepCount } from "ai";
2	import { youSearch } from "@youdotcom-oss/ai-sdk-plugin";
3	import { anthropic } from "@ai-sdk/anthropic";
4
5	const { text } = await generateText({
6	model: anthropic("claude-sonnet-4-5"),
7	prompt: "What happened in San Francisco last week?",
8	tools: {
9	search: youSearch(),
10	},
11	stopWhen: isStepCount(3),
12	});
13
14	console.log(text);

1	import { generateText, isStepCount } from "ai";
2	import { youContents } from "@youdotcom-oss/ai-sdk-plugin";
3	import { anthropic } from "@ai-sdk/anthropic";
4
5	const { text } = await generateText({
6	model: anthropic("claude-sonnet-4-5"),
7	prompt: "Summarize the content from vercel.com/blog",
8	tools: {
9	extract: youContents(),
10	},
11	stopWhen: isStepCount(3),
12	});
13
14	console.log(text);

1	import { generateText, isStepCount } from "ai";
2	import { youResearch } from "@youdotcom-oss/ai-sdk-plugin";
3	import { anthropic } from "@ai-sdk/anthropic";
4
5	const { text } = await generateText({
6	model: anthropic("claude-sonnet-4-5"),
7	prompt: "What are the tradeoffs between WebSockets and Server-Sent Events for real-time applications?",
8	tools: {
9	research: youResearch(),
10	},
11	stopWhen: isStepCount(3),
12	});
13
14	console.log(text);

1	import { generateText, isStepCount } from "ai";
2	import { youSearch, youContents, youResearch } from "@youdotcom-oss/ai-sdk-plugin";
3	import { anthropic } from "@ai-sdk/anthropic";
4
5	const { text } = await generateText({
6	model: anthropic("claude-sonnet-4-5"),
7	prompt: "Find recent blog posts about the Vercel AI SDK, then extract and summarize the top result.",
8	tools: {
9	search: youSearch(),
10	extract: youContents(),
11	research: youResearch(),
12	},
13	stopWhen: isStepCount(5),
14	});
15
16	console.log(text);

1	import { youSearch, youContents, youResearch } from "@youdotcom-oss/ai-sdk-plugin";
2
3	const searchTool = youSearch({ apiKey: "api_key" });
4	const contentsTool = youContents({ apiKey: "api_key" });
5	const researchTool = youResearch({ apiKey: "api_key" });

Getting Started

Install the package

Set your API key

Usage

Web search with youSearch

Content extraction with youContents

Research with youResearch

Combining all three tools

Passing the API key explicitly

Resources

Getting Started

Install the package

Set your API key

Usage

Web search with youSearch

Content extraction with youContents

Research with youResearch

Combining all three tools

Passing the API key explicitly

Resources

Web search with `youSearch`

Content extraction with `youContents`

Research with `youResearch`

Web search with `youSearch`

Content extraction with `youContents`

Research with `youResearch`