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 example below runs on the default OpenAI model, so it needs the openai library and a You.com API key, available at you.com/platform/api-keys.

uv pip install -U openai

export YDC_API_KEY=***
# optional: override the default API endpoint (https://ydc-index.io)
export YDC_BASE_URL=***

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://ydc-index.io`.
`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.

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