@nooticr/mcp 1.26.58 → 1.26.59

package/README.md

@@ -52,7 +52,7 @@ npx @nooticr/mcp login   # one-time sign-in (Google)
 
 ## Tools
 
-92 tools, grouped by what you are trying to do. Prices are in nooticr credits and
+93 tools, grouped by what you are trying to do. Prices are in nooticr credits and
 match what the server actually charges.
 
 The job tools under **Answer a question you actually have** are not
@@ -151,6 +151,7 @@ a `scanId` for the rest.
 | `get_amazon_product` | 3 | One listing by ASIN or URL: price, rating, the full star histogram, features, specs, Amazon's review digest and aspect breakdown, and the reviews. |
 | `scan_marketplace_category` | 3 per product collected (30 by default) | The same category read on eleven more sites — AliExpress, Cdiscount, Flipkart, Mercado Libre, Lazada, Otto, Rakuten, Trendyol, Jumia, Vinted and Temu. Vinted is resale rather than retail, so its `rating` describes the seller and the scan says so in `ratingScope` — do not read it as a product's reviews. `marketplace` picks the site; `market` picks the storefront for the sites that have several, and the argument names the real set per site so a model cannot send Otto a Lazada region. Same rollup, same confirmation before spending. |
 | `marketplace_scan_status` | free | Picks a running marketplace collection back up by `scanId` and the same `marketplace`. Free, for the same reason `amazon_scan_status` is. |
+| `marketplace_changes` | free | What moved in a category since the previous scan of the same `marketplace` and `query`: products that entered or left the results and ones whose price or place changed. Read from the two latest stored scans, so it fetches nothing; a category scanned once says it has no earlier run. |
 | `get_marketplace_product` | 3 | One product from any of the twelve sites, by id or URL: price, rating, the full star histogram, specs and the reviews. |
 | `show_amazon_category_insights` | free | Draws the read **your model** wrote — purchase drivers, barriers, what each brand does well, the gaps, the positioning angles — beside the listings and their reviews, so a person can click a product and check any claim against the text it came from. The conclusions are attributed to your model, never presented as a nooticr rating of anyone's product. Given the `scanId`, it re-reads the listings from the scan itself (free) instead of drawing whatever the model re-sends, and flags any ASIN the read cites that the scan does not contain; without one, the card says its listings were not checked. |
 | `show_marketplace_category_insights` | free | The same card for the other eleven marketplaces: your read beside that site's listings and reviews, labelled with the right site, re-read from the scan by `scanId` and `marketplace` so nothing is re-typed. |

package/dist/shared/loading-plans.js

@@ -436,6 +436,8 @@ export const LOADING_PLANS = {
         steps: [],
         free: true,
     },
+    // Free: reads two stored scans, fetches nothing.
+    marketplace_changes: { label: "Comparing the two scans", kind: "list", n: 6, steps: [], free: true },
     get_marketplace_product: {
         label: "Reading the product",
         kind: "text",

package/dist/shared/marketplace.js

@@ -400,6 +400,45 @@ export function registerMarketplaceTools(server, makeClient) {
             return toolError("marketplace_scan_status failed", err);
         }
     });
+    server.registerTool("marketplace_changes", {
+        title: "Marketplace Changes",
+        description: "What moved in a category since the run before: products that entered or left a search's " +
+            "results, and ones whose price or place changed. Compared from the two latest stored scans " +
+            "of the same marketplace and `query`, so it fetches nothing and never re-scans — run " +
+            "scan_marketplace_category first, and again later, to have two runs to compare. `new` and " +
+            "`gone` mean entered or left the results, not listed or delisted. A category scanned only " +
+            "once has no earlier run and says so. Free.",
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        outputSchema: OUTPUT_SCHEMAS.marketplace_changes,
+        inputSchema: z
+            .object({
+            marketplace: marketplaceArg,
+            query: z.string().describe("The category search to compare, exactly as it was scanned."),
+            market: z.string().optional().describe("The storefront the scan read, if the site has several."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        const client = await makeClient({ ...extra, arguments: args });
+        const m = marketOf(args.marketplace);
+        if (!m)
+            return toolError("marketplace_changes failed", new Error(`unknown marketplace — one of ${SLUGS}`));
+        try {
+            const res = await client.callTool("marketplace_changes", args);
+            const payload = structured(res);
+            return {
+                content: [{ type: "text", text: JSON.stringify(payload) }],
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            return toolError("marketplace_changes failed", err);
+        }
+    });
     server.registerTool("get_marketplace_product", {
         title: "Get Marketplace Product",
         _meta: viewMeta("get_marketplace_product"),

package/dist/shared/output-schemas.js

@@ -1629,6 +1629,24 @@ export const OUTPUT_SCHEMAS = {
     // the result does not have to know which site it asked.
     scan_marketplace_category: marketplaceScan,
     marketplace_scan_status: marketplaceScan,
+    // A diff of two stored scans, drawn by no view: the rows are the answer.
+    marketplace_changes: open({
+        display: scalar(),
+        hasBaseline: scalar(),
+        since: scalar(),
+        takenAt: scalar(),
+        counts: open({ new: scalar(), gone: scalar(), moved: scalar() }).nullish(),
+        totalChanges: scalar(),
+        rows: listOf(open({
+            change: scalar(),
+            id: scalar(),
+            title: scalar(),
+            meta: scalar(),
+            url: scalar(),
+            move: scalar(),
+        })),
+        note: scalar(),
+    }),
     get_marketplace_product: open({
         ...marketplaceScanShape,
         product: amazonProduct.nullish().describe("The single product, also present as products[0]."),

package/dist/shared/tools-def.js

@@ -522,6 +522,12 @@ export const TOOL_DEFINITIONS = [
         description: "Pick up a scan_marketplace_category collection that was still running, by scanId and the same marketplace — the products and reviews collected since, with the same rollup and the same instructions for reading them. Free: it is the poll scan_marketplace_category asked for, and charging for the second half of one answer would bill a wait this server chose. Call it when a scan came back incomplete, and keep calling it until it reports complete: true; only then write your read, from the full set. Do not end your turn between polls.",
         inputSchema: z.object({ marketplace: z.string().describe("The same site the scan ran against."), scanId: z.string().describe("The scanId scan_marketplace_category returned."), waitSeconds: z.number().int().optional().describe("How long to wait for more products before answering (default 30, max 55)."), focus: z.string().optional().describe("Same optional steer as scan_marketplace_category.") }).strict(),
     },
+    {
+        name: "marketplace_changes",
+        title: "Marketplace Changes",
+        description: "What moved in a category since the run before: products that entered or left a search's results, and ones whose price or place changed. Compared from the two latest stored scans of the same marketplace and `query`, so it fetches nothing and never re-scans — run scan_marketplace_category first, and again later, to have two runs to compare. `new` and `gone` mean entered or left the results, not listed or delisted. A category scanned only once has no earlier run and says so. Free.",
+        inputSchema: z.object({ marketplace: z.string().describe("Which site the scan read."), query: z.string().describe("The category search to compare, exactly as it was scanned."), market: z.string().optional().describe("The storefront the scan read, if the site has several.") }).strict(),
+    },
     {
         name: "get_marketplace_product",
         title: "Get Marketplace Product",

package/dist/shared/tools.js

@@ -32,7 +32,7 @@ import { registerAmazonTools } from "./amazon.js";
 import { registerMarketplaceTools } from "./marketplace.js";
 import { DEFAULT_NOOTICR_SETTINGS, DEFAULT_SOCIAL_PLATFORMS, MemorySettingsStore, SETTINGS_READ_TOOL, SETTINGS_UPDATE_TOOL, settingsOwnerFromAuth, } from "./settings.js";
 /** Current MCP server version — bumped on every deploy for traceability. */
-export const MCP_SERVER_VERSION = "1.26.58";
+export const MCP_SERVER_VERSION = "1.26.59";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nooticr/mcp",
   "mcpName": "com.nooticr/mcp",
-  "version": "1.26.58",
+  "version": "1.26.59",
   "description": "MCP server for nooticr - fetch, discover and understand TikTok/Instagram/YouTube/X/Reddit/LinkedIn/Weibo posts with AI (media metadata, niche discovery, brand monitoring, hook & viral analysis)",
   "homepage": "https://mcp.nooticr.com",
   "repository": {