search_engines/duckduckgo.py

import gradio as gr
import pandas as pd
from langchain_community.tools import DuckDuckGoSearchResults

from utils.helpers import map_results

from .base import BaseInterfaceWrapper


async def duckduckgo_search(query: str, max_results: int = 5) -> pd.DataFrame:
    """
    Given a search query, returns the search results from DuckDuckGo.

    Args:
        query (str): The search query.
        max_results (int, optional): The number of maximum results to return. Defaults to 5.

    Returns:
        dict: The search results from DuckDuckGo Search Engine. Fields:
            headers (list): The headers of the columns in the search results. Contains "title", "link", "body".
            data (list): The data in the search results. Each row contains the title, link, and body of the search result.
    """
    ddg = DuckDuckGoSearchResults(
        output_format="list",
    )
    ddg.max_results = max_results
    results = await ddg.ainvoke(query)
    mapping = {
        "title": "title",
        "link": "link",
        "snippet": "body",
    }
    results = await map_results(results, mapping)
    return results


class DuckDuckGoInterfaceWrapper(BaseInterfaceWrapper):
    def __init__(self):
        super().__init__(
            fn=duckduckgo_search,
            inputs=[
                gr.Textbox(label="Search Query"),
                gr.Slider(
                    minimum=1, maximum=10, step=1, value=5, label="Number of Results"
                ),
            ],
            title="DuckDuckGo Search",
            description="Search the web using DuckDuckGo Search Engine.",
        )