@rog0x/mcp-seo-tools 1.0.0

package/dist/tools/page-speed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-speed.js","sourceRoot":"","sources":["../../src/tools/page-speed.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,4CA6JC;AA7LD,iDAAmC;AAgC5B,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAEpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,OAAO,EAAE;YACP,YAAY,EAAE,uCAAuC;YACrD,iBAAiB,EAAE,mBAAmB;SACvC;QACD,QAAQ,EAAE,QAAQ;QAClB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;IAEhD,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACxD,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC7D,MAAM,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAE3E,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7B,MAAM,OAAO,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,aAAa,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,MAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IACxG,MAAM,WAAW,GAAG,CAAC,CAAC,wBAAwB,CAAC,CAAC,MAAM,CAAC;IACvD,MAAM,YAAY,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAC/B,MAAM,gBAAgB,GAAG,CAAC,CAAC,6BAA6B,CAAC,CAAC,MAAM,CAAC;IACjE,MAAM,uBAAuB,GAAG,CAAC,CAAC,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE;QACnF,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC,MAAM,CAAC;IACV,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAEnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,IAAI,KAAK,GAAG,GAAG,CAAC;IAEhB,gBAAgB;IAChB,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,4BAA4B,MAAM,4BAA4B,CAAC,CAAC;QAC5E,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;SAAM,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QACxB,eAAe,CAAC,IAAI,CAAC,WAAW,MAAM,kFAAkF,CAAC,CAAC;QAC1H,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,GAAG,IAAI,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,sBAAsB,OAAO,yCAAyC,CAAC,CAAC;QACpF,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;SAAM,IAAI,OAAO,GAAG,IAAI,EAAE,CAAC;QAC1B,eAAe,CAAC,IAAI,CAAC,gBAAgB,OAAO,8CAA8C,CAAC,CAAC;QAC5F,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,YAAY;IACZ,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAChC,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,mEAAmE,CAAC,CAAC;QACtH,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;SAAM,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QACxB,eAAe,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC;QAC9F,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,oBAAoB;IACpB,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,mFAAmF,CAAC,CAAC;QACjG,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,+FAA+F,CAAC,CAAC;QACvH,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;SAAM,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,eAAe,CAAC,IAAI,CAAC,GAAG,OAAO,8EAA8E,CAAC,CAAC;QAC/G,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACtB,eAAe,CAAC,IAAI,CAAC,GAAG,aAAa,wEAAwE,CAAC,CAAC;QAC/G,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,oCAAoC;IACpC,MAAM,cAAc,GAAG,CAAC,CAAC,uCAAuC,CAAC,CAAC,MAAM,CAAC;IACzE,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,kEAAkE,CAAC,CAAC;QACjG,KAAK,IAAI,cAAc,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,sBAAsB;IACtB,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QACpB,eAAe,CAAC,IAAI,CAAC,GAAG,WAAW,6EAA6E,CAAC,CAAC;QAClH,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,iBAAiB;IACjB,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,gBAAgB,8EAA8E,CAAC,CAAC;QAC/G,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,uBAAuB,GAAG,CAAC,EAAE,CAAC;QAChC,eAAe,CAAC,IAAI,CAAC,GAAG,uBAAuB,mFAAmF,CAAC,CAAC;QACpI,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,uBAAuB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC;IACnD,IAAI,MAAM,GAAG,CAAC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACnC,eAAe,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;QACrG,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,eAAe;IACf,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,eAAe,CAAC,IAAI,CAAC,GAAG,OAAO,iGAAiG,CAAC,CAAC;QAClI,KAAK,IAAI,OAAO,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,OAAO;QACL,GAAG;QACH,MAAM,EAAE;YACN,WAAW,EAAE,IAAI;YACjB,YAAY,EAAE,IAAI;YAClB,MAAM;YACN,UAAU;YACV,OAAO;SACR;QACD,IAAI,EAAE;YACJ,SAAS;YACT,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YACzB,eAAe;YACf,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;SAC3E;QACD,cAAc,EAAE;YACd,OAAO;YACP,aAAa;YACb,WAAW;YACX,YAAY;YACZ,MAAM;YACN,gBAAgB;YAChB,uBAAuB;YACvB,OAAO;SACR;QACD,MAAM;QACN,eAAe;QACf,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC;KAC1B,CAAC;AACJ,CAAC"}

package/dist/tools/sitemap-parser.d.ts

@@ -0,0 +1,29 @@
+export interface SitemapUrl {
+    loc: string;
+    lastmod: string | null;
+    changefreq: string | null;
+    priority: string | null;
+}
+export interface SitemapIndex {
+    loc: string;
+    lastmod: string | null;
+}
+export interface SitemapAnalysis {
+    url: string;
+    type: "urlset" | "sitemapindex" | "not_found";
+    urls: SitemapUrl[];
+    sitemapIndexEntries: SitemapIndex[];
+    totalUrls: number;
+    stats: {
+        withLastmod: number;
+        withChangefreq: number;
+        withPriority: number;
+        uniqueHosts: string[];
+        oldestLastmod: string | null;
+        newestLastmod: string | null;
+    };
+    issues: string[];
+    recommendations: string[];
+}
+export declare function parseSitemap(url: string): Promise<SitemapAnalysis>;
+//# sourceMappingURL=sitemap-parser.d.ts.map

package/dist/tools/sitemap-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-parser.d.ts","sourceRoot":"","sources":["../../src/tools/sitemap-parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,GAAG,cAAc,GAAG,WAAW,CAAC;IAC9C,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,mBAAmB,EAAE,YAAY,EAAE,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AA0BD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA6KxE"}

package/dist/tools/sitemap-parser.js

@@ -0,0 +1,224 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSitemap = parseSitemap;
+const cheerio = __importStar(require("cheerio"));
+async function fetchSitemap(url) {
+    const response = await fetch(url, {
+        headers: { "User-Agent": "MCPSEOTools/1.0 (Sitemap Parser)" },
+        redirect: "follow",
+        signal: AbortSignal.timeout(20000),
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} fetching sitemap at ${url}`);
+    }
+    return response.text();
+}
+function resolveSitemapUrl(pageUrl) {
+    try {
+        const parsed = new URL(pageUrl);
+        // If the URL already ends with sitemap.xml or similar, use it directly
+        if (parsed.pathname.includes("sitemap"))
+            return pageUrl;
+        // Otherwise, try the standard location
+        return `${parsed.protocol}//${parsed.host}/sitemap.xml`;
+    }
+    catch {
+        return pageUrl;
+    }
+}
+async function parseSitemap(url) {
+    const sitemapUrl = resolveSitemapUrl(url);
+    let xml;
+    try {
+        xml = await fetchSitemap(sitemapUrl);
+    }
+    catch (err) {
+        // Try robots.txt for sitemap location
+        try {
+            const robotsUrl = `${new URL(sitemapUrl).protocol}//${new URL(sitemapUrl).host}/robots.txt`;
+            const robotsResp = await fetch(robotsUrl, {
+                headers: { "User-Agent": "MCPSEOTools/1.0 (Sitemap Parser)" },
+                signal: AbortSignal.timeout(10000),
+            });
+            const robotsTxt = await robotsResp.text();
+            const sitemapMatch = robotsTxt.match(/Sitemap:\s*(.+)/i);
+            if (sitemapMatch) {
+                xml = await fetchSitemap(sitemapMatch[1].trim());
+            }
+            else {
+                return {
+                    url: sitemapUrl,
+                    type: "not_found",
+                    urls: [],
+                    sitemapIndexEntries: [],
+                    totalUrls: 0,
+                    stats: { withLastmod: 0, withChangefreq: 0, withPriority: 0, uniqueHosts: [], oldestLastmod: null, newestLastmod: null },
+                    issues: [`No sitemap found at ${sitemapUrl} and no Sitemap directive in robots.txt.`],
+                    recommendations: ["Create a sitemap.xml and submit it to search engines via Google Search Console."],
+                };
+            }
+        }
+        catch {
+            return {
+                url: sitemapUrl,
+                type: "not_found",
+                urls: [],
+                sitemapIndexEntries: [],
+                totalUrls: 0,
+                stats: { withLastmod: 0, withChangefreq: 0, withPriority: 0, uniqueHosts: [], oldestLastmod: null, newestLastmod: null },
+                issues: [`Failed to fetch sitemap: ${err.message}`],
+                recommendations: ["Ensure a sitemap.xml exists at the root of your domain."],
+            };
+        }
+    }
+    const $ = cheerio.load(xml, { xml: true });
+    const issues = [];
+    const recommendations = [];
+    // Check if it's a sitemap index
+    const sitemapIndexEntries = [];
+    $("sitemapindex > sitemap").each((_, el) => {
+        sitemapIndexEntries.push({
+            loc: $(el).find("loc").text().trim(),
+            lastmod: $(el).find("lastmod").text().trim() || null,
+        });
+    });
+    if (sitemapIndexEntries.length > 0) {
+        if (sitemapIndexEntries.length > 500) {
+            issues.push(`Sitemap index has ${sitemapIndexEntries.length} entries. Google supports up to 500 sitemaps per index.`);
+        }
+        const withoutLastmod = sitemapIndexEntries.filter((s) => !s.lastmod).length;
+        if (withoutLastmod > 0) {
+            recommendations.push(`${withoutLastmod} sitemap index entries lack lastmod dates. Adding them helps search engines prioritize crawling.`);
+        }
+        return {
+            url: sitemapUrl,
+            type: "sitemapindex",
+            urls: [],
+            sitemapIndexEntries,
+            totalUrls: sitemapIndexEntries.length,
+            stats: { withLastmod: sitemapIndexEntries.length - (sitemapIndexEntries.filter((s) => !s.lastmod).length), withChangefreq: 0, withPriority: 0, uniqueHosts: [], oldestLastmod: null, newestLastmod: null },
+            issues,
+            recommendations,
+        };
+    }
+    // Parse URL set
+    const urls = [];
+    $("urlset > url").each((_, el) => {
+        urls.push({
+            loc: $(el).find("loc").text().trim(),
+            lastmod: $(el).find("lastmod").text().trim() || null,
+            changefreq: $(el).find("changefreq").text().trim() || null,
+            priority: $(el).find("priority").text().trim() || null,
+        });
+    });
+    // Stats
+    const withLastmod = urls.filter((u) => u.lastmod).length;
+    const withChangefreq = urls.filter((u) => u.changefreq).length;
+    const withPriority = urls.filter((u) => u.priority).length;
+    const hosts = new Set();
+    for (const u of urls) {
+        try {
+            hosts.add(new URL(u.loc).hostname);
+        }
+        catch { /* skip */ }
+    }
+    const lastmods = urls
+        .map((u) => u.lastmod)
+        .filter((d) => d !== null)
+        .sort();
+    const oldestLastmod = lastmods.length > 0 ? lastmods[0] : null;
+    const newestLastmod = lastmods.length > 0 ? lastmods[lastmods.length - 1] : null;
+    // Analysis
+    if (urls.length === 0) {
+        issues.push("Sitemap contains no URLs.");
+    }
+    if (urls.length > 50000) {
+        issues.push(`Sitemap has ${urls.length} URLs. Maximum allowed per sitemap file is 50,000. Split into multiple sitemaps.`);
+    }
+    if (withLastmod === 0 && urls.length > 0) {
+        recommendations.push("No lastmod dates found. Adding lastmod helps search engines identify updated content.");
+    }
+    else if (withLastmod < urls.length * 0.5) {
+        recommendations.push(`Only ${withLastmod} of ${urls.length} URLs have lastmod dates. Add dates to all entries.`);
+    }
+    // Check for stale lastmod
+    if (newestLastmod) {
+        const newestDate = new Date(newestLastmod);
+        const sixMonthsAgo = new Date();
+        sixMonthsAgo.setMonth(sixMonthsAgo.getMonth() - 6);
+        if (newestDate < sixMonthsAgo) {
+            issues.push(`Most recent lastmod is ${newestLastmod}. The sitemap appears outdated. Update it regularly.`);
+        }
+    }
+    // Check for duplicate URLs
+    const locSet = new Set();
+    let duplicates = 0;
+    for (const u of urls) {
+        if (locSet.has(u.loc))
+            duplicates++;
+        locSet.add(u.loc);
+    }
+    if (duplicates > 0) {
+        issues.push(`${duplicates} duplicate URL(s) found. Remove duplicates to avoid crawl budget waste.`);
+    }
+    // Check for non-canonical patterns
+    const mixedProtocol = urls.some((u) => u.loc.startsWith("http://")) && urls.some((u) => u.loc.startsWith("https://"));
+    if (mixedProtocol) {
+        issues.push("Sitemap contains both HTTP and HTTPS URLs. Use only HTTPS URLs.");
+    }
+    const mixedTrailingSlash = urls.some((u) => u.loc.endsWith("/")) && urls.some((u) => !u.loc.endsWith("/") && !u.loc.match(/\.\w{2,5}$/));
+    if (mixedTrailingSlash) {
+        recommendations.push("Inconsistent trailing slashes in URLs. Standardize to one pattern for cleaner crawling.");
+    }
+    return {
+        url: sitemapUrl,
+        type: "urlset",
+        urls: urls.slice(0, 200), // Cap output to avoid overwhelming responses
+        sitemapIndexEntries: [],
+        totalUrls: urls.length,
+        stats: {
+            withLastmod,
+            withChangefreq,
+            withPriority,
+            uniqueHosts: [...hosts],
+            oldestLastmod,
+            newestLastmod,
+        },
+        issues,
+        recommendations,
+    };
+}
+//# sourceMappingURL=sitemap-parser.js.map

package/dist/tools/sitemap-parser.js.map

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

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@rog0x/mcp-seo-tools",
+  "version": "1.0.0",
+  "description": "MCP server providing SEO analysis tools for AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mcp-seo-tools": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "cheerio": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "^5.8.3"
+  },
+  "license": "MIT"
+}

package/src/index.ts

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import { analyzeMeta } from "./tools/meta-analyzer.js";
+import { checkHeadings } from "./tools/heading-checker.js";
+import { checkLinks } from "./tools/link-checker.js";
+import { analyzeKeywordDensity } from "./tools/keyword-density.js";
+import { analyzePageSpeed } from "./tools/page-speed.js";
+import { parseSitemap } from "./tools/sitemap-parser.js";
+
+const server = new Server(
+  {
+    name: "mcp-seo-tools",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "seo_meta_analyze",
+      description:
+        "Analyze a page's meta tags, Open Graph tags, and Twitter Card tags. Returns an SEO score with actionable recommendations for title, description, social sharing tags, and other meta elements.",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          url: {
+            type: "string",
+            description: "Full URL of the page to analyze (e.g. https://example.com)",
+          },
+        },
+        required: ["url"],
+      },
+    },
+    {
+      name: "seo_heading_check",
+      description:
+        "Audit the heading hierarchy (H1-H6) of a page. Detects missing H1, skipped heading levels, duplicate headings, empty headings, and provides a visual hierarchy tree.",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          url: {
+            type: "string",
+            description: "Full URL of the page to audit",
+          },
+        },
+        required: ["url"],
+      },
+    },
+    {
+      name: "seo_link_check",
+      description:
+        "Crawl a page and check all links for broken URLs, redirects, and missing anchor text. Tests up to 50 links by default with concurrent requests.",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          url: {
+            type: "string",
+            description: "Full URL of the page to scan for links",
+          },
+          max_links: {
+            type: "number",
+            description: "Maximum number of links to check (default: 50, max: 200)",
+          },
+        },
+        required: ["url"],
+      },
+    },
+    {
+      name: "seo_keyword_density",
+      description:
+        "Analyze keyword density and distribution across a page. Returns top single words, two-word and three-word phrases with density percentages. Optionally checks placement of a target keyword in title, H1, meta description, and first paragraph.",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          url: {
+            type: "string",
+            description: "Full URL of the page to analyze",
+          },
+          target_keyword: {
+            type: "string",
+            description: "Optional target keyword to check placement and density for",
+          },
+        },
+        required: ["url"],
+      },
+    },
+    {
+      name: "seo_page_speed",
+      description:
+        "Measure basic page speed metrics including Time to First Byte, total load time, HTML size, and resource counts (scripts, stylesheets, images). Identifies render-blocking resources and missing optimizations.",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          url: {
+            type: "string",
+            description: "Full URL of the page to measure",
+          },
+        },
+        required: ["url"],
+      },
+    },
+    {
+      name: "seo_sitemap_parse",
+      description:
+        "Parse and analyze a website's sitemap.xml. Handles both sitemap indexes and URL sets. Reports URL counts, lastmod freshness, duplicate URLs, protocol consistency, and sitemap compliance issues. Automatically tries /sitemap.xml and falls back to robots.txt.",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          url: {
+            type: "string",
+            description: "URL of the sitemap or any page on the site (will try /sitemap.xml automatically)",
+          },
+        },
+        required: ["url"],
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      case "seo_meta_analyze": {
+        const result = await analyzeMeta(args?.url as string);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      case "seo_heading_check": {
+        const result = await checkHeadings(args?.url as string);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      case "seo_link_check": {
+        const maxLinks = Math.min((args?.max_links as number) || 50, 200);
+        const result = await checkLinks(args?.url as string, maxLinks);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      case "seo_keyword_density": {
+        const result = await analyzeKeywordDensity(
+          args?.url as string,
+          args?.target_keyword as string | undefined
+        );
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      case "seo_page_speed": {
+        const result = await analyzePageSpeed(args?.url as string);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      case "seo_sitemap_parse": {
+        const result = await parseSitemap(args?.url as string);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+      }
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error: any) {
+    return {
+      content: [{ type: "text", text: `Error: ${error.message}` }],
+      isError: true,
+    };
+  }
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("MCP SEO Tools server running on stdio");
+}
+
+main().catch(console.error);

package/src/tools/heading-checker.ts

@@ -0,0 +1,109 @@
+import * as cheerio from "cheerio";
+
+export interface HeadingInfo {
+  level: number;
+  text: string;
+  id: string | null;
+}
+
+export interface HeadingAnalysis {
+  url: string;
+  headings: HeadingInfo[];
+  hierarchy: string;
+  counts: Record<string, number>;
+  issues: string[];
+  score: number;
+}
+
+export async function checkHeadings(url: string): Promise<HeadingAnalysis> {
+  const response = await fetch(url, {
+    headers: { "User-Agent": "MCPSEOTools/1.0 (SEO Analyzer)" },
+    redirect: "follow",
+    signal: AbortSignal.timeout(15000),
+  });
+  const html = await response.text();
+  const $ = cheerio.load(html);
+
+  const headings: HeadingInfo[] = [];
+  const counts: Record<string, number> = { h1: 0, h2: 0, h3: 0, h4: 0, h5: 0, h6: 0 };
+
+  $("h1, h2, h3, h4, h5, h6").each((_, el) => {
+    const tag = $(el).prop("tagName")?.toLowerCase() || "";
+    const level = parseInt(tag.replace("h", ""), 10);
+    const text = $(el).text().trim().replace(/\s+/g, " ");
+    const id = $(el).attr("id") || null;
+    headings.push({ level, text, id });
+    if (counts[tag] !== undefined) counts[tag]++;
+  });
+
+  const issues: string[] = [];
+
+  // Check for missing H1
+  if (counts.h1 === 0) {
+    issues.push("No H1 tag found. Every page should have exactly one H1 as the main heading.");
+  } else if (counts.h1 > 1) {
+    issues.push(`Found ${counts.h1} H1 tags. Use only one H1 per page for optimal SEO.`);
+  }
+
+  // Check if first heading is H1
+  if (headings.length > 0 && headings[0].level !== 1) {
+    issues.push(`First heading is H${headings[0].level} instead of H1. The first heading should be H1.`);
+  }
+
+  // Check for skipped levels
+  let previousLevel = 0;
+  for (const heading of headings) {
+    if (heading.level > previousLevel + 1 && previousLevel > 0) {
+      issues.push(`Heading level skipped: H${previousLevel} to H${heading.level} ("${heading.text.substring(0, 50)}"). Avoid skipping heading levels.`);
+    }
+    previousLevel = heading.level;
+  }
+
+  // Check for empty headings
+  const emptyHeadings = headings.filter((h) => h.text.length === 0);
+  if (emptyHeadings.length > 0) {
+    issues.push(`Found ${emptyHeadings.length} empty heading(s). All headings should contain descriptive text.`);
+  }
+
+  // Check for very long headings
+  const longHeadings = headings.filter((h) => h.text.length > 70);
+  for (const h of longHeadings) {
+    issues.push(`H${h.level} exceeds 70 characters (${h.text.length} chars): "${h.text.substring(0, 60)}..."`);
+  }
+
+  // Check for duplicate headings
+  const seen = new Map<string, number>();
+  for (const h of headings) {
+    const key = `h${h.level}:${h.text.toLowerCase()}`;
+    seen.set(key, (seen.get(key) || 0) + 1);
+  }
+  for (const [key, count] of seen) {
+    if (count > 1) {
+      const [tag, ...textParts] = key.split(":");
+      issues.push(`Duplicate ${tag.toUpperCase()}: "${textParts.join(":")}" appears ${count} times.`);
+    }
+  }
+
+  // Build visual hierarchy
+  const hierarchy = headings
+    .map((h) => `${"  ".repeat(h.level - 1)}H${h.level}: ${h.text.substring(0, 80)}`)
+    .join("\n");
+
+  // Score calculation
+  let score = 100;
+  if (counts.h1 === 0) score -= 25;
+  else if (counts.h1 > 1) score -= 15;
+  if (headings.length > 0 && headings[0].level !== 1) score -= 10;
+  score -= Math.min(issues.filter((i) => i.includes("skipped")).length * 10, 20);
+  score -= emptyHeadings.length * 5;
+  score -= longHeadings.length * 3;
+
+  return {
+    url,
+    headings,
+    hierarchy,
+    counts,
+    issues,
+    score: Math.max(0, score),
+  };
+}