You.com

YouTools searches the You.com Search API and returns JSON or markdown results.

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,
        )
    ],
    markdown=True,
)

agent.print_response("Search for the latest AAPL news")

Setup

uv pip install -U agno openai
export YDC_API_KEY=***

YDC_BASE_URL overrides the default https://ydc-index.io endpoint.

Toolkit Function

Function	Parameters	Description
`you_search`	`query: str`, `num_results: Optional[int] = None`	Search the web. `num_results` overrides the toolkit default for one call.

Toolkit Parameters

Parameter	Type	Default	Description
`api_key`	`Optional[str]`	`None`	You.com API key. Falls back to `YDC_API_KEY`.
`base_url`	`Optional[str]`	`None`	API base URL. Falls back to `YDC_BASE_URL`, then `https://ydc-index.io`.
`num_results`	`int`	`5`	Default result count.
`livecrawl`	`Optional[Literal["web", "news", "all"]]`	`None`	Enable livecrawl for the selected source.
`livecrawl_formats`	`Union[str, List[str]]`	`"markdown"`	Livecrawl content formats. Strings may be comma-separated.
`text_length_limit`	`int`	`1000`	Maximum livecrawled text length per result.
`include_domains`	`Optional[List[str]]`	`None`	Restrict results to these domains. Cannot be combined with `exclude_domains` or `boost_domains`.
`exclude_domains`	`Optional[List[str]]`	`None`	Exclude these domains.
`country`	`Optional[str]`	`None`	Country code for the search focus.
`freshness`	`Optional[str]`	`None`	Result freshness, such as `day`, `week`, `month`, or `year`.
`language`	`Optional[str]`	`None`	Result language in BCP 47 format.
`safesearch`	`Optional[str]`	`None`	Content filter: `off`, `moderate`, or `strict`.
`offset`	`Optional[int]`	`None`	Pagination offset from `0` through `9`.
`boost_domains`	`Optional[List[str]]`	`None`	Boost these domains without restricting results. Cannot be combined with `include_domains`.
`crawl_timeout`	`int`	`10`	Livecrawl timeout from 1 through 60 seconds.
`search_params`	`Optional[Dict[str, Any]]`	`None`	Additional query parameters. These values override the parameters above.
`timeout`	`int`	`30`	HTTP request timeout in seconds.
`format`	`Literal["json", "markdown"]`	`"json"`	Result format.
`show_results`	`bool`	`False`	Log the formatted result.

You.com also provides an MCP profile at https://api.you.com/mcp?profile=free. Use it with MCPTools when you want the hosted you-search MCP tool.

Get Started

Basics

Advanced

Production

Providers

Other

Additional Resources

Setup

Toolkit Function

Toolkit Parameters

Developer Resources

​Setup

​Toolkit Function

​Toolkit Parameters

​Developer Resources

Setup

Toolkit Function

Toolkit Parameters

Developer Resources