sbuilder-mcp 0.27.0 → 0.28.0

package/CHANGELOG.md

@@ -6,6 +6,15 @@ 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.28.0] - 2026-09-10
+
+### Added
+- The API catalog gained the platform's own image-search route, `GET /api/sites/{siteId}/images/search`, reachable through sb_api_call as well as through sb_media_upload.
+- The API catalog gained the admin key-pool pair, `GET/POST /api/admin/image-keys`, for managing the platform's Pexels credentials.
+
+### Changed
+- sb_media_upload's "search unavailable" instruction now names the admin Settings area's Pexels keys screen as the way to turn image search on, alongside the PEXELS_API_KEYS server variable, and notes that several keys are walked round-robin because the provider rate-limits per key.
+
 ## [0.27.0] - 2026-09-10
 
 ### Changed

package/CHANGELOG.vi.md

@@ -6,6 +6,15 @@ 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.28.0] - 2026-09-10
+
+### Added
+- Catalog API có thêm route tìm ảnh của chính nền tảng, `GET /api/sites/{siteId}/images/search`, gọi được qua sb_api_call cũng như qua sb_media_upload.
+- Catalog API có thêm cặp quản lý pool key phía admin, `GET/POST /api/admin/image-keys`, để quản lý key Pexels của nền tảng.
+
+### Changed
+- Chỉ dẫn "chưa cấu hình tìm ảnh" của sb_media_upload giờ nêu tên màn Cài đặt phía admin (khoá Pexels) như một cách bật tìm ảnh, bên cạnh biến môi trường PEXELS_API_KEYS trên server, và ghi chú rằng nhiều khoá được xoay vòng vì nhà cung cấp giới hạn theo từng khoá.
+
 ## [0.27.0] - 2026-09-10
 
 ### Changed

package/dist/catalog/api.generated.js

@@ -1,5 +1,5 @@
 export const SWAGGER_SOURCE = {
-    "operations": 498,
+    "operations": 501,
     "definitions": 104,
     "bodyCarrying": 178,
     "bodyUndescribed": 64,
@@ -1211,6 +1211,32 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/admin/image-keys",
+        "method": "GET",
+        "path": "/api/admin/image-keys",
+        "tags": [
+            "admin"
+        ],
+        "summary": "Manage the platform's Pexels credentials",
+        "params": [],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
+    {
+        "id": "post:/api/admin/image-keys",
+        "method": "POST",
+        "path": "/api/admin/image-keys",
+        "tags": [
+            "admin"
+        ],
+        "summary": "Manage the platform's Pexels credentials",
+        "params": [],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/admin/plans/export",
         "method": "GET",
@@ -7542,6 +7568,55 @@ export const API_OPERATIONS = [
         "bodyRef": null,
         "credential": "siteScoped"
     },
+    {
+        "id": "get:/api/sites/{siteId}/images/search",
+        "method": "GET",
+        "path": "/api/sites/{siteId}/images/search",
+        "tags": [
+            "images"
+        ],
+        "summary": "Search stock photographs",
+        "params": [
+            {
+                "name": "siteId",
+                "in": "path",
+                "required": true,
+                "type": "string",
+                "description": "Site ID"
+            },
+            {
+                "name": "query",
+                "in": "query",
+                "required": true,
+                "type": "string",
+                "description": "What to search for"
+            },
+            {
+                "name": "per_page",
+                "in": "query",
+                "required": false,
+                "type": "integer",
+                "description": "1-30, default 8"
+            },
+            {
+                "name": "orientation",
+                "in": "query",
+                "required": false,
+                "type": "string",
+                "description": "landscape, portrait or square"
+            },
+            {
+                "name": "locale",
+                "in": "query",
+                "required": false,
+                "type": "string",
+                "description": "Provider locale, e.g. vi-VN"
+            }
+        ],
+        "bodyDescribed": false,
+        "bodyRef": null,
+        "credential": "siteScoped"
+    },
     {
         "id": "get:/api/sites/{siteId}/integrations",
         "method": "GET",

package/dist/catalog/shapes.generated.js

@@ -1,10 +1,10 @@
 export const SHAPE_SOURCE = {
-    "writeOperations": 218,
-    "shaped": 168,
-    "fromHandlers": 168,
+    "writeOperations": 219,
+    "shaped": 169,
+    "fromHandlers": 169,
     "fromSwaggerOnly": 0,
     "withReadOnly": 26,
-    "structsRead": 1649
+    "structsRead": 1658
 };
 export const REQUEST_SHAPES = {
     "post:/api/sites/{siteId}/api-keys": {
@@ -4672,6 +4672,21 @@ export const REQUEST_SHAPES = {
         "source": "go",
         "goType": "(inline)"
     },
+    "post:/api/admin/image-keys": {
+        "fields": [
+            {
+                "name": "label",
+                "type": "string"
+            },
+            {
+                "name": "key",
+                "type": "string",
+                "note": "`key`, not `secret`: it is what Pexels's own dashboard calls the value the operator is copying, and a form field named for the thing you are pasting is one less thing to guess at."
+            }
+        ],
+        "source": "go",
+        "goType": "(inline)"
+    },
     "post:/api/admin/translation-keys": {
         "fields": [
             {

package/dist/transport/stock.js

@@ -11,8 +11,10 @@ export class SearchUnavailable extends Error {
 }
 export const NO_SEARCH_NEXT = 'This platform has no image search available, so find a photograph by your own means and pass ' +
     'its URL to sb_media_upload — the platform fetches it server-side and it lands in this site\'s ' +
-    'own library, never hotlinked. An operator enables the search by setting PEXELS_API_KEYS on the ' +
-    'server; the key belongs there rather than here, so one place holds it and one quota is spent.';
+    'own library, never hotlinked. An operator turns the search on by adding a Pexels key in the ' +
+    'admin Settings area (Pexels keys), or by setting PEXELS_API_KEYS on the server; several keys ' +
+    'are walked round-robin, because that provider rate-limits per key. Either way the key lives ' +
+    'there rather than here, so one place holds it and one quota is spent.';
 export async function searchStock(ctx, siteId, query, opts = {}) {
     const q = new URLSearchParams({ query, per_page: String(opts.perPage ?? 8) });
     if (opts.orientation)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.27.0",
+  "version": "0.28.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",