Safe Local Sandbox for AI Agents

/**
 * DuckDuckGo Search Script
 * Searches DuckDuckGo (HTML version) and extracts the abstract, organic results with title, link, and snippet
 */

import { browser } from "@deeptask/sandbox";

export const metadata = {
    name: "duckduckgo-search",
    version: "1.0.0",
    description:
        "Search DuckDuckGo and extract abstract, organic results with title, link, and snippet",
    inputSchema: {
        type: "object",
        properties: {
            query: {
                type: "string",
                description: "The search query/keyword",
                default: "chatgpt"
            },
            language: {
                type: "string",
                description: "Language code for search results (e.g., en-us, ja, zh-cn)",
                default: "en-us"
            },
            page: {
                type: "number",
                description: "Page index (0 for first page, 1 for second, etc.)",
                default: 0,
                minimum: 0
            }
        },
        required: ["query"]
    },
    type: "puppeteer",
    defaultTimeout: 30000,
    fsEnabled: false,
    networkEnabled: true,
    domainsAllowed: ["duckduckgo.com", "html.duckduckgo.com"],
};

export async function main(input) {
    try {
        const page = browser.getPage();
        const keyword = input?.query || "chatgpt";
        const language = input?.language || "en-us";
        const pageIndex = (input?.page !== undefined && input?.page !== null) ? input.page : 0;
        const start = pageIndex * 25;
        const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(keyword)}&kl=${language}&s=${start}`;

        await page.goto(url, { waitUntil: "networkidle2" });
        await page.waitForSelector("#links .result, .result", { timeout: 15000 });

        const data = await page.evaluate(() => {
            const out = { abstract: null, results: [] };
            const abstractEl = document.querySelector(".result--more .result__body, .zci__body, .abstract");
            if (abstractEl) out.abstract = abstractEl.innerText.trim();

            const results = document.querySelectorAll(".result:not(.result--more)");
            results.forEach((el) => {
                const titleLink = el.querySelector("a.result__a");
                const snippetEl = el.querySelector(".result__snippet");
                if (!titleLink || !titleLink.href) return;
                const title = titleLink.innerText.trim();
                if (!title) return;
                let link = titleLink.href;
                if (link.includes("uddg=")) {
                    try {
                        const m = link.match(/uddg=([^&]+)/);
                        if (m) link = decodeURIComponent(m[1]);
                    } catch (_) {}
                }
                const snippet = snippetEl ? snippetEl.innerText.trim() : "";
                out.results.push({ title, link, snippet });
            });
            return out;
        });

        return {
            result: {
                content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
            }
        };
    } catch (error) {
        return {
            error: { message: error.message || "Unknown error occurred" }
        };
    }
}