agent-skills

You.com Agent Skills

Agent skills for integrating You.com's AI-powered search, content extraction, and web capabilities with popular AI agent frameworks and bash-based agents.

These skills provide interactive workflows that guide your AI agent through setting up You.com integrations for SDKs, frameworks, and CLI tools.

Available Skills

ydc-ai-sdk-integration

Integrate Vercel AI SDK applications with You.com tools for real-time web search, AI-powered answers, and content extraction.

Use when:

• Building AI SDK applications with generateText() or streamText()
• Adding web search capabilities to your AI agents
• Extracting and processing web content programmatically

Features:

• Interactive setup workflow for existing or new projects
• Three powerful tools: youSearch, youContents
• Smart integration with existing AI SDK code
• Support for multiple AI providers (Anthropic, OpenAI, Google, etc.)

---

ydc-claude-agent-sdk-integration

Connect Claude Agent SDK (Python and TypeScript) to You.com's HTTP MCP server for web search and content extraction.

Use when:

• Building Claude-powered agents in Python or TypeScript
• Integrating MCP tools with Claude Agent SDK v1 or v2
• Adding You.com capabilities to existing Claude applications

Features:

• Complete templates for Python and TypeScript (v1 & v2)
• HTTP MCP server configuration patterns
• Bearer token authentication setup
• Error handling and validation examples

---

ydc-openai-agent-sdk-integration

Add You.com MCP tools to OpenAI Agents SDK using Hosted MCP or Streamable HTTP modes.

Use when:

• Building OpenAI-powered agents with MCP integration
• Using Python or TypeScript OpenAI Agents SDK
• Choosing between Hosted MCP and Streamable HTTP deployment

Features:

• Dual-mode templates (Hosted MCP + Streamable HTTP)
• Python and TypeScript implementations
• Complete configuration examples for both modes
• Tool approval and validation patterns

---

ydc-crewai-mcp-integration

Integrate You.com's remote MCP server with crewAI agents for web search, AI-powered answers, and content extraction.

Use when:

• Building crewAI agents that need real-time web access
• Integrating You.com MCP via MCPServerHTTP or MCPServerAdapter
• Adding web search and content extraction to existing crewAI workflows

Features:

• DSL and MCPServerAdapter integration patterns
• Python implementation with uv/pip setup
• Bearer token authentication for the remote MCP server
• Complete crewAI crew and task configuration examples

---

ydc-langchain-integration

Integrate LangChain applications (TypeScript and Python) with You.com tools for web search, content extraction, and retrieval.

Use when:

• Building LangChain.js agents with createAgent and initChatModel (TypeScript)
• Using YouRetriever, YouSearchTool, or YouContentsTool with LangChain (Python)
• Adding web search or content extraction to existing LangChain workflows

Features:

• TypeScript: youSearch and youContents via @youdotcom-oss/langchain, structured output with Zod
• Python: YouRetriever for RAG chains, YouSearchTool + YouContentsTool for agents via langchain-youdotcom
• Prompt injection defense guidance (W011 trust boundary)
• Direct invocation and agent-based usage patterns for both languages

---

teams-anthropic-integration

Use @youdotcom-oss/teams-anthropic to add Anthropic Claude models (Opus, Sonnet, Haiku) to Microsoft Teams.ai applications. Optionally integrate You.com MCP server for web search and content extraction.

Use when:

• Building Teams.ai apps with Claude models
• Need streaming, function calling, or conversation memory
• Optionally want web search capabilities via You.com MCP

Features:

• Two paths: Basic setup (Claude only) or with You.com MCP
• Complete templates for new and existing apps
• Streaming responses and function calling
• Conversation memory with Teams.ai Memory API

---

youdotcom-api

Integrate You.com APIs (Research, Search, Contents) into any language using direct HTTP calls — no SDK required.

Use when:

• Calling You.com APIs directly without an SDK wrapper
• Need synthesized, cited answers via the Research API
• Building custom search pipelines with raw Search + Contents data
• Working in a language without a dedicated You.com SDK

Features:

• Research API: one call for multi-step reasoning with cited Markdown answers
• Search API: raw web and news results with filtering, pagination, and livecrawl
• Contents API: full page extraction (HTML, Markdown, metadata) from any URL
• Language-agnostic — works with any HTTP client (fetch, requests, httpx, curl)
• TypeScript and Python reference implementations included
• JSON Schemas for all request/response shapes

---

youdotcom-cli

Web search, research with citations, and content extraction for bash agents using curl and You.com's REST API.