pagesight 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pagesight",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "See your site the way search engines and AI see it.",
   "keywords": [
     "seo",

package/src/tools/metatags.ts

@@ -322,11 +322,15 @@ export function registerMetatagsTool(server: McpServer): void {
         // Redirect chain (only if there were redirects)
         if (chain.length > 1) {
           output.push("--- Redirect Chain ---", "");
-          for (let i = 0; i < chain.length; i++) {
-            const hop = chain[i];
-            const prefix = i === chain.length - 1 ? "" : `${hop.status} → `;
-            output.push(`${i + 1}. ${prefix}${hop.url}`);
+          const parts: string[] = [];
+          for (const hop of chain) {
+            parts.push(hop.url);
+            parts.push(String(hop.status));
           }
+          // Format: URL → status → URL → status (drop trailing status)
+          parts.pop();
+          output.push(parts.join(" → "));
+          output.push(`Hops: ${chain.length - 1}`);
           output.push("");
         }
 
@@ -352,9 +356,27 @@ export function registerMetatagsTool(server: McpServer): void {
               output.push(`${check.tag}: BROKEN — HTTP ${check.status}`);
               output.push(`  URL: ${check.url}`);
             } else {
-              const size = check.contentLength ? ` (${Math.round(check.contentLength / 1024)} KB)` : "";
+              const sizeKB = check.contentLength ? Math.round(check.contentLength / 1024) : null;
+              const size = sizeKB ? ` (${sizeKB} KB)` : "";
               const type = check.contentType ? ` ${check.contentType}` : "";
               output.push(`${check.tag}: OK —${type}${size}`);
+              if (sizeKB && sizeKB > 1024) {
+                output.push(`  Warning: ${sizeKB} KB is large for social previews — consider compressing below 1 MB`);
+              }
+            }
+
+            // Check declared dimensions from meta tags
+            if (check.tag === "og:image") {
+              const w = getMeta(parsed.meta, "og:image:width");
+              const h = getMeta(parsed.meta, "og:image:height");
+              if (w && h) {
+                output.push(`  Declared dimensions: ${w}x${h}`);
+                const wn = Number(w);
+                const hn = Number(h);
+                if (wn && hn && (wn < 1200 || hn < 630)) {
+                  output.push(`  Note: recommended minimum for og:image is 1200x630`);
+                }
+              }
             }
           }
         }

package/src/tools/sample-inspect.ts

@@ -108,6 +108,15 @@ async function inspectSingle(url: string, siteUrl: string): Promise<InspectionSu
   }
 }
 
+function humanizeState(state: string): string {
+  const map: Record<string, string> = {
+    PAGE_FETCH_STATE_UNSPECIFIED: "not yet crawled",
+    ROBOTS_TXT_STATE_UNSPECIFIED: "not yet checked",
+    INDEXING_STATE_UNSPECIFIED: "not yet determined",
+  };
+  return map[state] ?? state;
+}
+
 function formatResults(siteUrl: string, sitemapUrl: string, totalUrls: number, results: InspectionSummary[]): string {
   const lines: string[] = [
     `=== Sample Inspection: ${siteUrl} ===`,
@@ -153,7 +162,7 @@ function formatResults(siteUrl: string, sitemapUrl: string, totalUrls: number, r
     lines.push("");
     lines.push("Page fetch issues:");
     for (const [state, count] of fetchIssues) {
-      lines.push(`  ${state}: ${count}`);
+      lines.push(`  ${humanizeState(state)}: ${count}`);
     }
   }
 
@@ -171,9 +180,9 @@ function formatResults(siteUrl: string, sitemapUrl: string, totalUrls: number, r
     } else {
       lines.push(`   Verdict: ${r.verdict}`);
       lines.push(`   Coverage: ${r.coverageState}`);
-      lines.push(`   Page fetch: ${r.pageFetchState}`);
-      if (r.robotsTxtState !== "ALLOWED") lines.push(`   Robots.txt: ${r.robotsTxtState}`);
-      if (r.indexingState !== "INDEXING_ALLOWED") lines.push(`   Indexing: ${r.indexingState}`);
+      lines.push(`   Page fetch: ${humanizeState(r.pageFetchState)}`);
+      if (r.robotsTxtState !== "ALLOWED") lines.push(`   Robots.txt: ${humanizeState(r.robotsTxtState)}`);
+      if (r.indexingState !== "INDEXING_ALLOWED") lines.push(`   Indexing: ${humanizeState(r.indexingState)}`);
       if (r.lastCrawlTime) lines.push(`   Last crawled: ${r.lastCrawlTime}`);
       if (r.googleCanonical && r.googleCanonical !== r.url) {
         lines.push(`   Google canonical: ${r.googleCanonical}`);