data-aggregator-mcp 1.0.0

package/dist/tools/public-data.js

@@ -0,0 +1,262 @@
+/**
+ * query_public_data - Miscellaneous public API queries.
+ *
+ * Sub-commands:
+ *   - wikipedia    : Get a Wikipedia article summary
+ *   - ip_geolocation : Look up geographic info for an IP address
+ *   - dns_lookup   : DNS record lookup for a domain
+ *   - expand_url   : Expand a shortened URL to its final destination
+ *
+ * All APIs used are free and require no API keys.
+ */
+import { cache, TTL } from "../utils/cache.js";
+import { rateLimiter } from "../utils/rate-limiter.js";
+import { httpGetJson, httpFetch, formatError } from "../utils/http.js";
+import { resolve } from "node:dns/promises";
+// ─── Wikipedia Summary ─────────────────────────────────────────────────────
+async function fetchWikipediaSummary(query, language = "en") {
+    // Use the Wikipedia REST API summary endpoint
+    const encoded = encodeURIComponent(query.replace(/\s+/g, "_"));
+    const url = `https://${language}.wikipedia.org/api/rest_v1/page/summary/${encoded}`;
+    await rateLimiter.acquire("wikipedia");
+    const data = await httpGetJson(url);
+    if (data.type === "disambiguation") {
+        return {
+            title: data.title ?? query,
+            extract: `This is a disambiguation page. ${data.extract ?? "Multiple meanings exist for this term."}`,
+            url: data.content_urls?.desktop?.page ?? `https://${language}.wikipedia.org/wiki/${encoded}`,
+            thumbnail: data.thumbnail?.source,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    if (!data.extract) {
+        throw new Error(`No Wikipedia article found for "${query}". Try a different search term.`);
+    }
+    return {
+        title: data.title ?? query,
+        extract: data.extract,
+        url: data.content_urls?.desktop?.page ?? `https://${language}.wikipedia.org/wiki/${encoded}`,
+        thumbnail: data.thumbnail?.source,
+        timestamp: new Date().toISOString(),
+    };
+}
+// ─── IP Geolocation ────────────────────────────────────────────────────────
+async function fetchIpGeolocation(ip) {
+    // ip-api.com is free for non-commercial use, no key required
+    const target = ip ?? ""; // empty string = caller's IP
+    const url = `http://ip-api.com/json/${target}?fields=status,message,country,countryCode,regionName,city,lat,lon,timezone,isp,query`;
+    await rateLimiter.acquire("ipgeo");
+    const data = await httpGetJson(url);
+    if (data.status !== "success") {
+        throw new Error(data.message ?? `Geolocation failed for IP "${ip ?? "self"}"`);
+    }
+    return {
+        ip: data.query,
+        country: data.country,
+        countryCode: data.countryCode,
+        region: data.regionName,
+        city: data.city,
+        latitude: data.lat,
+        longitude: data.lon,
+        timezone: data.timezone,
+        isp: data.isp,
+    };
+}
+// ─── DNS Lookup ────────────────────────────────────────────────────────────
+async function fetchDnsRecords(domain, recordType) {
+    await rateLimiter.acquire("dns");
+    const type = recordType.toUpperCase();
+    let records = [];
+    try {
+        switch (type) {
+            case "A": {
+                const result = await resolve(domain, "A");
+                records = result;
+                break;
+            }
+            case "AAAA": {
+                const result = await resolve(domain, "AAAA");
+                records = result;
+                break;
+            }
+            case "MX": {
+                const result = await resolve(domain, "MX");
+                records = result.map((r) => `${r.priority} ${r.exchange}`);
+                break;
+            }
+            case "TXT": {
+                const result = await resolve(domain, "TXT");
+                records = result.map((r) => r.join(""));
+                break;
+            }
+            case "NS": {
+                const result = await resolve(domain, "NS");
+                records = result;
+                break;
+            }
+            case "CNAME": {
+                const result = await resolve(domain, "CNAME");
+                records = result;
+                break;
+            }
+            case "SOA": {
+                const result = await resolve(domain, "SOA");
+                const soa = result;
+                records = [
+                    `nsname=${soa.nsname} hostmaster=${soa.hostmaster} serial=${soa.serial}`,
+                ];
+                break;
+            }
+            default:
+                throw new Error(`Unsupported record type: ${type}. Supported: A, AAAA, MX, TXT, NS, CNAME, SOA`);
+        }
+    }
+    catch (err) {
+        if (err.code === "ENODATA" || err.code === "ENOTFOUND") {
+            records = [];
+        }
+        else {
+            throw err;
+        }
+    }
+    return {
+        domain,
+        type,
+        records,
+    };
+}
+// ─── URL Expander ──────────────────────────────────────────────────────────
+async function expandUrl(shortUrl) {
+    await rateLimiter.acquire("generic");
+    // Follow redirects by making a HEAD request
+    const response = await httpFetch(shortUrl, {
+        method: "GET",
+        maxRetries: 1,
+        timeoutMs: 10_000,
+        rotateUserAgent: true,
+    });
+    return {
+        originalUrl: shortUrl,
+        expandedUrl: response.url,
+        statusCode: response.status,
+        contentType: response.headers.get("content-type") ?? undefined,
+    };
+}
+export async function queryPublicData(args) {
+    try {
+        const { command } = args;
+        switch (command) {
+            case "wikipedia": {
+                const query = args.query;
+                if (!query) {
+                    return {
+                        content: [
+                            { type: "text", text: 'The "query" parameter is required for Wikipedia lookups.' },
+                        ],
+                        isError: true,
+                    };
+                }
+                const cacheKey = `wiki:${query.toLowerCase()}:${args.language ?? "en"}`;
+                const cached = cache.get(cacheKey);
+                if (cached) {
+                    return {
+                        content: [
+                            { type: "text", text: JSON.stringify({ ...cached, cached: true }, null, 2) },
+                        ],
+                    };
+                }
+                const summary = await fetchWikipediaSummary(query, args.language);
+                cache.set(cacheKey, summary, TTL.PUBLIC);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(summary, null, 2) }],
+                };
+            }
+            case "ip_geolocation": {
+                const cacheKey = `ipgeo:${args.ip ?? "self"}`;
+                const cached = cache.get(cacheKey);
+                if (cached) {
+                    return {
+                        content: [
+                            { type: "text", text: JSON.stringify({ ...cached, cached: true }, null, 2) },
+                        ],
+                    };
+                }
+                const geo = await fetchIpGeolocation(args.ip);
+                cache.set(cacheKey, geo, TTL.PUBLIC);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(geo, null, 2) }],
+                };
+            }
+            case "dns_lookup": {
+                const domain = args.domain;
+                if (!domain) {
+                    return {
+                        content: [
+                            { type: "text", text: 'The "domain" parameter is required for DNS lookups.' },
+                        ],
+                        isError: true,
+                    };
+                }
+                const recordType = args.recordType ?? "A";
+                const cacheKey = `dns:${domain.toLowerCase()}:${recordType}`;
+                const cached = cache.get(cacheKey);
+                if (cached) {
+                    return {
+                        content: [
+                            { type: "text", text: JSON.stringify({ ...cached, cached: true }, null, 2) },
+                        ],
+                    };
+                }
+                const records = await fetchDnsRecords(domain, recordType);
+                cache.set(cacheKey, records, TTL.PUBLIC);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(records, null, 2) }],
+                };
+            }
+            case "expand_url": {
+                const url = args.url;
+                if (!url) {
+                    return {
+                        content: [
+                            { type: "text", text: 'The "url" parameter is required for URL expansion.' },
+                        ],
+                        isError: true,
+                    };
+                }
+                const cacheKey = `url:${url}`;
+                const cached = cache.get(cacheKey);
+                if (cached) {
+                    return {
+                        content: [
+                            { type: "text", text: JSON.stringify({ ...cached, cached: true }, null, 2) },
+                        ],
+                    };
+                }
+                const info = await expandUrl(url);
+                cache.set(cacheKey, info, TTL.PUBLIC);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(info, null, 2) }],
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Unknown sub-command: "${command}". Available commands: wikipedia, ip_geolocation, dns_lookup, expand_url`,
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (err) {
+        return {
+            content: [
+                { type: "text", text: `Error in public data query: ${formatError(err)}` },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=public-data.js.map

package/dist/tools/public-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-data.js","sourceRoot":"","sources":["../../src/tools/public-data.ts"],"names":[],"mappings":"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"}

package/dist/tools/scraper.d.ts

@@ -0,0 +1,19 @@
+/**
+ * fetch_webpage - Structured web scraping.
+ *
+ * Fetches a URL and returns structured JSON with:
+ *   - Page title
+ *   - Meta description
+ *   - Headings hierarchy
+ *   - Main text content (HTML stripped)
+ *   - Selected content via CSS-selector-like path (basic support)
+ *   - Links found on the page
+ *
+ * Uses rotating User-Agent strings for basic anti-scraping.
+ */
+import type { ToolResult } from "../types.js";
+export declare function fetchWebpage(args: {
+    url: string;
+    selector?: string;
+}): Promise<ToolResult>;
+//# sourceMappingURL=scraper.d.ts.map

package/dist/tools/scraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scraper.d.ts","sourceRoot":"","sources":["../../src/tools/scraper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,aAAa,CAAC;AAqI3D,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+DtB"}

package/dist/tools/scraper.js

@@ -0,0 +1,185 @@
+/**
+ * fetch_webpage - Structured web scraping.
+ *
+ * Fetches a URL and returns structured JSON with:
+ *   - Page title
+ *   - Meta description
+ *   - Headings hierarchy
+ *   - Main text content (HTML stripped)
+ *   - Selected content via CSS-selector-like path (basic support)
+ *   - Links found on the page
+ *
+ * Uses rotating User-Agent strings for basic anti-scraping.
+ */
+import { cache, TTL } from "../utils/cache.js";
+import { rateLimiter } from "../utils/rate-limiter.js";
+import { httpGetText, formatError } from "../utils/http.js";
+// ─── Basic HTML Parsing Helpers ────────────────────────────────────────────
+// We do simple regex-based extraction to avoid heavy deps like cheerio.
+function extractTag(html, tag) {
+    const re = new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`, "i");
+    const m = html.match(re);
+    return m ? stripHtml(m[1]).trim() : "";
+}
+function extractMetaContent(html, name) {
+    // Match both name="..." and property="..."
+    const re = new RegExp(`<meta\\s+(?:[^>]*?(?:name|property)\\s*=\\s*["']${name}["'][^>]*?content\\s*=\\s*["']([^"']*)["']|[^>]*?content\\s*=\\s*["']([^"']*)["'][^>]*?(?:name|property)\\s*=\\s*["']${name}["'])`, "i");
+    const m = html.match(re);
+    return (m?.[1] ?? m?.[2] ?? "").trim();
+}
+function extractHeadings(html) {
+    const headings = [];
+    const re = /<(h[1-6])[^>]*>([\s\S]*?)<\/\1>/gi;
+    let match;
+    while ((match = re.exec(html)) !== null) {
+        const level = parseInt(match[1].charAt(1), 10);
+        const text = stripHtml(match[2]).trim();
+        if (text)
+            headings.push({ level, text });
+    }
+    return headings;
+}
+function extractLinks(html, baseUrl) {
+    const links = [];
+    const re = /<a\s+[^>]*href\s*=\s*["']([^"'#]+)["'][^>]*>([\s\S]*?)<\/a>/gi;
+    let match;
+    const seen = new Set();
+    while ((match = re.exec(html)) !== null) {
+        let href = match[1].trim();
+        const text = stripHtml(match[2]).trim();
+        if (!text || !href)
+            continue;
+        // Resolve relative URLs
+        try {
+            href = new URL(href, baseUrl).href;
+        }
+        catch {
+            continue;
+        }
+        if (!seen.has(href)) {
+            seen.add(href);
+            links.push({ text: text.slice(0, 200), href });
+        }
+        if (links.length >= 50)
+            break;
+    }
+    return links;
+}
+function stripHtml(html) {
+    return html
+        .replace(/<script[\s\S]*?<\/script>/gi, " ")
+        .replace(/<style[\s\S]*?<\/style>/gi, " ")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/gi, " ")
+        .replace(/&amp;/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;/gi, "'")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function extractMainContent(html) {
+    // Try to find <main>, <article>, or role="main" first
+    const mainPatterns = [
+        /<main[^>]*>([\s\S]*?)<\/main>/i,
+        /<article[^>]*>([\s\S]*?)<\/article>/i,
+        /<div[^>]*role\s*=\s*["']main["'][^>]*>([\s\S]*?)<\/div>/i,
+    ];
+    for (const pattern of mainPatterns) {
+        const match = html.match(pattern);
+        if (match) {
+            const text = stripHtml(match[1]);
+            if (text.length > 100)
+                return text.slice(0, 10_000);
+        }
+    }
+    // Fall back to stripping the body
+    const bodyMatch = html.match(/<body[^>]*>([\s\S]*?)<\/body>/i);
+    const body = bodyMatch ? bodyMatch[1] : html;
+    return stripHtml(body).slice(0, 10_000);
+}
+/**
+ * Very basic CSS-selector-like content extraction.
+ * Supports: tag, .class, #id (single selector only).
+ */
+function extractBySelector(html, selector) {
+    let pattern;
+    if (selector.startsWith("#")) {
+        const id = selector.slice(1);
+        pattern = new RegExp(`<([a-z][a-z0-9]*)\\s+[^>]*id\\s*=\\s*["']${id}["'][^>]*>([\\s\\S]*?)<\\/\\1>`, "i");
+    }
+    else if (selector.startsWith(".")) {
+        const cls = selector.slice(1);
+        pattern = new RegExp(`<([a-z][a-z0-9]*)\\s+[^>]*class\\s*=\\s*["'][^"']*\\b${cls}\\b[^"']*["'][^>]*>([\\s\\S]*?)<\\/\\1>`, "i");
+    }
+    else {
+        // Plain tag name
+        pattern = new RegExp(`<${selector}[^>]*>([\\s\\S]*?)<\\/${selector}>`, "i");
+    }
+    const match = html.match(pattern);
+    if (!match)
+        return "";
+    // The captured content is in group 2 for id/class patterns, group 1 for tag
+    const content = match[2] ?? match[1] ?? "";
+    return stripHtml(content).slice(0, 10_000);
+}
+// ─── Public handler ────────────────────────────────────────────────────────
+export async function fetchWebpage(args) {
+    try {
+        const url = args.url.trim();
+        // Validate URL
+        try {
+            new URL(url);
+        }
+        catch {
+            return {
+                content: [{ type: "text", text: `Invalid URL: "${url}"` }],
+                isError: true,
+            };
+        }
+        const cacheKey = `scrape:${url}:${args.selector ?? ""}`;
+        const cached = cache.get(cacheKey);
+        if (cached) {
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify({ ...cached, cached: true }, null, 2) },
+                ],
+            };
+        }
+        await rateLimiter.acquire("generic");
+        const html = await httpGetText(url, {
+            rotateUserAgent: true,
+            headers: {
+                "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+                "Accept-Language": "en-US,en;q=0.5",
+            },
+        });
+        const result = {
+            url,
+            title: extractTag(html, "title"),
+            metaDescription: extractMetaContent(html, "description") ||
+                extractMetaContent(html, "og:description"),
+            headings: extractHeadings(html),
+            mainContent: extractMainContent(html),
+            links: extractLinks(html, url),
+            timestamp: new Date().toISOString(),
+        };
+        if (args.selector) {
+            result.selectedContent = extractBySelector(html, args.selector);
+        }
+        cache.set(cacheKey, result, TTL.SCRAPE);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                { type: "text", text: `Error scraping webpage: ${formatError(err)}` },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=scraper.js.map

package/dist/tools/scraper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scraper.js","sourceRoot":"","sources":["../../src/tools/scraper.ts"],"names":[],"mappings":"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"}

package/dist/tools/stocks.d.ts

@@ -0,0 +1,14 @@
+/**
+ * query_stocks - Fetch stock and crypto market data.
+ *
+ * Free data sources:
+ *   - CoinGecko API (crypto, no key required)
+ *   - Yahoo Finance v8 unofficial API (stocks, no key required)
+ *   - Alpha Vantage (stocks, optional key via ALPHA_VANTAGE_KEY env)
+ */
+import type { ToolResult } from "../types.js";
+export declare function queryStocks(args: {
+    symbol: string;
+    type?: "stock" | "crypto" | "auto";
+}): Promise<ToolResult>;
+//# sourceMappingURL=stocks.d.ts.map

package/dist/tools/stocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stocks.d.ts","sourceRoot":"","sources":["../../src/tools/stocks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAA2B,UAAU,EAAE,MAAM,aAAa,CAAC;AAoIvE,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;CACpC,GAAG,OAAO,CAAC,UAAU,CAAC,CAyDtB"}