Search the web using SearXNG and return results.

This is the primary web search tool. Use it when you need to:

• Find information on the web

• Research a topic

• Look up documentation

• Debug errors (search for exact error messages)

• Find GitHub issues or Stack Overflow threads

Args: query: Search query. Use specific keywords and quotes for exact phrases. num_results: Number of results to return (default: 5, max: 50). categories: Search category (general, news, images, videos, it, science, files, music). language: Language code (en, fr, es, de, etc.). time_range: Time filter (day, week, month, year) or None for no filter. include_content: If True, fetch and extract full page content for each result. This is slower but provides complete content without follow-up calls.

Returns: Dictionary with "results" list, where each result has: - title: Result title - url: Result URL - snippet: Search snippet from SearXNG - content: Full page content (if include_content=True, otherwise empty string) - engine: List of search engines that returned this result

Example: >>> await web_search("python async await", num_results=3) { "results": [ { "title": "Python Asyncio - Real Python", "url": "https://realpython.com/async-io-python/", "snippet": "Learn how to use Python's asyncio...", "content": "# Python Asyncio...", "engine": ["google", "bing"] } ] }

Notes: - Requires SEARXNG_BASE_URL environment variable to be set. - Content extraction is best-effort and may fail for paywalled or protected content. - For large num_results with include_content=True, this can be slow due to parallel fetching.

Fetch a URL and extract LLM-ready Markdown content.

Use this when you already have a specific URL and want to read its content.
If you need to discover URLs first, use web_search() instead.

Args:
    url: URL to fetch and extract content from.

Returns:
    Dictionary with:
    - url: The requested URL
    - content: Extracted Markdown content

Example:
    >>> await get_content("https://example.com")
    {
        "url": "https://example.com",
        "content": "# Example Domain

This domain is for use in illustrative examples..." }

Notes:
    - Specialized handlers for GitHub Issues, Stack Exchange, Wikipedia, and arXiv.
    - Falls back to Trafilatura and BeautifulSoup for general websites.
    - Content extraction is best-effort and may fail for paywalled or protected content.
    - Some content types (PDFs, videos) may not be supported.

Raises:
    ContentExtractionError: If fetching or extraction fails.

Search recent news articles using SearXNG.

This is a convenience wrapper around web_search() optimized for news.

Args: query: News topic or event to search for. num_results: Number of articles to return (default: 10). time_range: Time filter (day, week, month, year). Defaults to "week". language: Language code for results (default: "en").

Returns: Dictionary with "results" list of news articles.

Example: >>> await search_news("artificial intelligence breakthrough", num_results=5) { "results": [ { "title": "Major AI Breakthrough Announced", "url": "https://example.com/ai-breakthrough", "snippet": "Researchers announce...", "content": "", "engine": ["google"] } ] }