sbuilder-mcp 0.71.0 → 0.72.0

package/CHANGELOG.md

@@ -6,6 +6,11 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.72.0] - 2026-09-28
+
+### Added
+- `sb_review` gains a `pageSeo` readiness gap: it lists published page, about, contact, policy, faq, and blog pages missing `settings.title` or `settings.description`, since the storefront falls back to the site name as `<title>` and drops the meta description entirely when either is unset, leaving every such page indistinguishable in a search result even though nothing on the canvas or in a screenshot shows it.
+
 ## [0.71.0] - 2026-09-28
 
 ### Added

package/CHANGELOG.vi.md

@@ -6,6 +6,11 @@ Mọi thay đổi đáng chú ý của dự án được ghi lại trong file n
 Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 và dự án tuân theo [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.72.0] - 2026-09-28
+
+### Added
+- `sb_review` có thêm gap readiness `pageSeo`: liệt kê các trang page, about, contact, policy, faq và blog đã publish nhưng thiếu `settings.title` hoặc `settings.description`, vì storefront sẽ dùng tên site làm `<title>` và bỏ hẳn meta description khi thiếu một trong hai — khiến các trang này không thể phân biệt trên kết quả tìm kiếm dù canvas hay screenshot đều không cho thấy điều đó.
+
 ## [0.71.0] - 2026-09-28
 
 ### Added

package/dist/domains/site/readiness.js

@@ -31,6 +31,15 @@ const COMMERCE_TYPES = [
     'dataset-block',
     'list-dataset',
 ];
+/**
+ * The page types a search engine INDEXES under the page's own settings. Entity
+ * templates (product, category, post, course) get their <title> and
+ * description merged from the entity (storefront/entityroute.go
+ * mergeEntitySettings); error and maintain have no address; the fixed-path and
+ * auth types are chrome a crawler is not sent to. Mirrors page.SlugTypes minus
+ * the auth four, plus the blog listing.
+ */
+const INDEXED_PAGE_TYPES = new Set(['page', 'about', 'contact', 'policy', 'faq', 'blog']);
 /** Does this node carry a purchase action (add to cart, buy now)? */
 function boundProductAction(n) {
     return (n.bindings ?? []).some((b) => b.id === PRODUCT_ACTION_BINDING_ID && !!b.target?.action);
@@ -163,6 +172,45 @@ export function readinessGaps(input) {
                     'footer and a link back to the home page.',
         });
     }
+    // EVERY PAGE ANSWERS WITH THE SAME <title>, AND NO DESCRIPTION.
+    //
+    // storefront.go pageSettings.head: a page whose settings carry no `title`
+    // serves the SITE NAME as its <title>, and no `description` means no meta
+    // description at all — so a site built through these tools, where nothing
+    // ever asks for either, publishes N pages that a search result cannot tell
+    // apart. Invisible on the canvas, invisible in a screenshot, and the one
+    // thing a search engine reads first.
+    //
+    // Only the types whose head IS the page's own settings (INDEXED_PAGE_TYPES),
+    // only published pages, and only when the list carried `settings` at all —
+    // an absent blob is "not read", not "empty".
+    if (pages) {
+        const bare = pages.filter((p) => {
+            if (p.status !== 'published' || !INDEXED_PAGE_TYPES.has(p.type))
+                return false;
+            const st = p.settings;
+            if (!st || typeof st !== 'object')
+                return false;
+            const has = (k) => typeof st[k] === 'string' && st[k].trim() !== '';
+            return !(has('title') && has('description'));
+        });
+        if (bare.length > 0) {
+            const named = bare.map((p) => p.name).filter((n) => !!n).slice(0, 3);
+            gaps.push({
+                id: 'pageSeo',
+                draft: false,
+                problem: `${bare.length} published page${bare.length === 1 ? '' : 's'}` +
+                    (named.length ? ` (${named.join(', ')}${bare.length > named.length ? ', …' : ''})` : '') +
+                    ' carry no settings.title or settings.description. Each serves the SITE NAME as its ' +
+                    '<title> and no meta description — a search result cannot tell them apart, and ' +
+                    'nothing on the canvas or in a screenshot shows it.',
+                fix: 'PATCH /api/v1/pages/{id} with {settings: {...existing, title, description}} — ' +
+                    '`settings` REPLACES the blob, so read the page and send it back whole. Title is ' +
+                    'what the tab and the result show (under ~60 chars); description is the ' +
+                    'two-line summary under it. ogImage takes a share picture.',
+            });
+        }
+    }
     // ONE PAGE QUIETLY BECAME THE WHOLE ACCOUNT AREA.
     //
     // This server used to tell agents, in as many words, to put the login and the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.71.0",
+  "version": "0.72.0",
   "description": "MCP server that designs and operates a Store Builder site — pages, data, theme and publish — through the platform's own API and live-edit protocol.",
   "mcpName": "io.github.vuluu2k/sbuilder-mcp",
   "type": "module",