You.com

YouTools enable an Agent to search the web using the You.com Search API.

Prerequisites

YouTools uses the httpx client already bundled with Agno. The only requirement is a You.com API key, available at you.com/platform/api-keys.

export YDC_API_KEY=***
# optional: point at a non-default endpoint (e.g. staging)
export YDC_BASE_URL=https://api.you.com

No API key? You.com also hosts a free MCP profile at https://api.you.com/mcp?profile=free (you-search, 100 queries/day, no signup). Plug that URL into Agno’s MCPTools instead of YouTools.

Example

The following agent searches You.com for AAPL news and prints the response.

cookbook/91_tools/youcom_tools.py

from agno.agent import Agent
from agno.tools.youcom import YouTools

agent = Agent(
    tools=[YouTools(
        include_domains=["cnbc.com", "reuters.com", "bloomberg.com"],
        num_results=8,
        show_results=True,
    )],
)
agent.print_response("Search for AAPL news", markdown=True)

Toolkit Functions

Function	Description
`you_search`	Search the web for a given query. Accepts `query` (str) and an optional `num_results` (int) to override the configured count. Returns results as JSON or markdown.

Toolkit Params

Parameter	Type	Default	Description
`api_key`	`Optional[str]`	`None`	You.com API key. Falls back to the `YDC_API_KEY` environment variable.
`base_url`	`Optional[str]`	`None`	Override the API base URL. Falls back to `YDC_BASE_URL`, then `https://api.you.com`.
`num_results`	`int`	`5`	Default number of search results.
`livecrawl`	`Literal['always', 'fallback', 'never', 'web']`	`'web'`	Live-crawl mode for the search API.
`livecrawl_formats`	`str`	`'markdown'`	Comma-separated content formats to request from livecrawl (e.g. `markdown`, `text`).
`text_length_limit`	`int`	`1000`	Maximum length of text content per result.
`include_domains`	`Optional[List[str]]`	`None`	Restrict results to these domains.
`exclude_domains`	`Optional[List[str]]`	`None`	Exclude results from these domains.
`timeout`	`int`	`30`	Maximum time in seconds to wait for API responses.
`format`	`Literal['json', 'markdown']`	`'json'`	Output format for search results.
`show_results`	`bool`	`False`	Log responses for debugging.

Developer Resources

View Tools
View Cookbook example

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Prerequisites

Example

Toolkit Functions

Toolkit Params

Developer Resources

​Prerequisites

​Example

​Toolkit Functions

​Toolkit Params

​Developer Resources

Prerequisites

Example

Toolkit Functions

Toolkit Params

Developer Resources