Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agno.com/llms.txt

Use this file to discover all available pages before exploring further.

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

FunctionDescription
you_searchSearch 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

ParameterTypeDefaultDescription
api_keyOptional[str]NoneYou.com API key. Falls back to the YDC_API_KEY environment variable.
base_urlOptional[str]NoneOverride the API base URL. Falls back to YDC_BASE_URL, then https://api.you.com.
num_resultsint5Default number of search results.
livecrawlLiteral['always', 'fallback', 'never', 'web']'web'Live-crawl mode for the search API.
livecrawl_formatsstr'markdown'Comma-separated content formats to request from livecrawl (e.g. markdown, text).
text_length_limitint1000Maximum length of text content per result.
include_domainsOptional[List[str]]NoneRestrict results to these domains.
exclude_domainsOptional[List[str]]NoneExclude results from these domains.
timeoutint30Maximum time in seconds to wait for API responses.
formatLiteral['json', 'markdown']'json'Output format for search results.
show_resultsboolFalseLog responses for debugging.

​
Developer Resources