@nooticr/mcp 1.26.39 → 1.26.40

package/README.md

@@ -145,9 +145,9 @@ a `scanId` for the rest.
 | `scan_amazon_category` | 3 per listing collected (30 by default) | The category, collected: listings with prices, star histograms, Amazon's own review-aspect counts and the review text itself, plus the arithmetic over them — price spread, rating spread, which aspects recur across how many brands, and the share of each listing's ratings sitting at 1-2 stars, read from the histogram rather than from the handful of reviews a scrape returns. Pass `query` to search the category, `asins` to pin the competitors a customer named, or both; named competitors keep their place at the front. Because the price is set by an argument, it confirms the total before spending it. |
 | `amazon_scan_status` | free | Picks a running collection back up by `scanId` — the listings collected since, with the same rollup. Free: it is the poll `scan_amazon_category` asked for, and billing the second half of one answer would charge for a wait the server chose. |
 | `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 ten more sites — AliExpress, Cdiscount, Flipkart, Mercado Libre, Lazada, Otto, Rakuten, Trendyol, Jumia and Temu. `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. |
+| `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. |
-| `get_marketplace_product` | 3 | One product from any of the eleven sites, by id or URL: price, rating, the full star histogram, specs and the reviews. |
+| `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. Makes no requests. |
 
 ### Make something

package/dist/shared/amazon.js

@@ -33,7 +33,25 @@ export function normaliseProducts(raw) {
         // raw `p.asin` there gave every review on every non-Amazon product the id
         // "review::0", "review::1" — colliding across products, so a model citing
         // one could not be pointed back at the right listing.
-        const id = String(p.asin ?? p.id ?? p.item_id ?? p.sku ?? p.product_id ?? "");
+        //
+        // This list must stay equal to `ID_KEYS` in nooticr-server's
+        // `crates/server/src/marketplace.rs`. The server computes `rollup.perProduct[].id`
+        // from its copy and the view joins those rows onto the tiles by the id
+        // resolved here, so a key in one list and not the other does not read as a
+        // missing id — it reads as a tile with no `negativeStarShare`, which looks
+        // like a site that publishes no histogram.
+        //
+        // `pid` and `goods_id` were the two missing, which is Flipkart and Temu:
+        // each collector publishes exactly one id field and those are theirs, so
+        // every product in a scan of either site resolved to "" and shared one
+        // blank key — the failure the comment below says was fixed for the others.
+        //
+        // Found by hand rather than by a test, and `??` is why it could be: it
+        // falls through null and undefined but not "", so a site that sends an
+        // empty id under an earlier key would stop the chain on the empty value
+        // rather than continue past it. Matching on a non-empty string closes
+        // both.
+        const id = String([p.asin, p.sku, p.pid, p.goods_id, p.item_id, p.product_id, p.id].find((v) => typeof v === "string" && v.trim() !== "") ?? "");
         const histogram = (p.rating_histogram ?? {});
         const reviews = Array.isArray(p.reviews) ? p.reviews : [];
         const aspects = Array.isArray(p.review_aspects) ? p.review_aspects : [];
@@ -137,6 +155,26 @@ export function categoryGuidance(opts) {
             : "."));
     if (opts.brands.length)
         lines.push(`Brands in the set: ${opts.brands.join(", ")}.`);
+    // Nothing came back, which is the one outcome where the next step is not
+    // "read the set" and the guidance above says nothing useful. Without this a
+    // model reports an empty category as a finding — the category is empty —
+    // when what actually happened is a search that found nothing, and the
+    // commonest reason is a query in a language that storefront does not sell
+    // in. Said here rather than only in the tool description because by the time
+    // this is read the description is long out of the model's attention.
+    if (opts.products === 0 && opts.complete) {
+        lines.push(`No listings came back. This is not a finding about the category — it is a search that ` +
+            `matched nothing. Before reporting it: check the query is in the language that ` +
+            `storefront sells in, try the common shopper's word for the thing rather than a ` +
+            `category or brand-family name, and drop any quotes or operators. If a second query ` +
+            `also returns nothing, say the search found nothing rather than that the category ` +
+            `is empty.`);
+    }
+    // Before the "still running" line and before the analysis prompt: a model
+    // that has already started composing a read is past the point where a
+    // caveat changes what it writes.
+    if (opts.freshness)
+        lines.push(opts.freshness);
     if (!opts.complete) {
         lines.push(`Collection is still running — ${opts.pending} listing${opts.pending === 1 ? "" : "s"} to go. ` +
             `Everything below is real and usable now; call ${statusTool} with scanId "${opts.scanId}" ` +

package/dist/shared/marketplace.js

@@ -5,7 +5,7 @@ import { withEvidence } from "./evidence-digest.js";
 import { confirmSpend, declinedResult } from "./spend.js";
 import { allReviews, categoryGuidance, listingCount, normaliseProducts, scanCost } from "./amazon.js";
 /**
- * The eleven sites, mirroring `MARKETPLACES` in nooticr-server.
+ * The twelve sites, mirroring `MARKETPLACES` in nooticr-server.
  *
  * Kept in the same order and the same words deliberately: a model reads this
  * text to decide what to send, and the server refuses on the same terms. Two
@@ -22,21 +22,25 @@ export const MARKETS = [
             hint: "a country code or host — com (US), co.uk, de, fr, it, es, ca, co.jp, in, com.br, " +
                 "com.mx, com.au, nl, se, pl, com.be, com.tr, ae, sa, eg, sg, cn. Default www.amazon.com",
         },
+        searchLang: "the storefront's own — English on com, co.uk, ca, in, com.au and sg, otherwise the country's",
     },
     {
         slug: "aliexpress",
         label: "AliExpress",
         idLabel: "the numeric id from /item/<id>.html, or a full AliExpress product URL",
+        searchLang: "English",
     },
     {
         slug: "cdiscount",
         label: "Cdiscount",
         idLabel: "the SKU from a product URL's /f-<category>-<sku>.html, or the full URL",
+        searchLang: "French",
     },
     {
         slug: "flipkart",
         label: "Flipkart",
         idLabel: "the 16-character PID from a product URL's pid= parameter, or the full URL",
+        searchLang: "English",
     },
     {
         slug: "mercadolibre",
@@ -48,6 +52,7 @@ export const MARKETS = [
                 "mercadolivre.com.br. Inferred from the ids when omitted, and a job runs against one " +
                 "market: an id from another is refused rather than mis-filed",
         },
+        searchLang: "Spanish, except Brazil (MLB), which is Portuguese",
     },
     {
         slug: "lazada",
@@ -59,6 +64,7 @@ export const MARKETS = [
             hint: "sg, my, th, vn, ph or id. An item id is scoped to one of them — the same id on another " +
                 "Lazada host is a different product or nothing at all",
         },
+        searchLang: "English on sg and ph; Thai, Vietnamese, Indonesian or Malay on th, vn, id and my",
     },
     {
         slug: "otto",
@@ -70,6 +76,7 @@ export const MARKETS = [
             hint: "de or at. The two are not interchangeable: an id from one does not address a product " +
                 "on the other",
         },
+        searchLang: "German, on both storefronts",
     },
     {
         slug: "rakuten",
@@ -81,6 +88,7 @@ export const MARKETS = [
             hint: "jp (Ichiba) or tw. Taiwan publishes no review text, so a category study there reads on " +
                 "price and rating alone",
         },
+        searchLang: "Japanese on jp, Traditional Chinese on tw",
     },
     {
         slug: "trendyol",
@@ -91,6 +99,7 @@ export const MARKETS = [
             hint: "one of 47 storefronts — tr, de, ae, sa, at, be, fr, it, nl, pl, ro and the rest. An id " +
                 "is scoped to one: the same number 404s on another country's",
         },
+        searchLang: "Turkish on tr; the storefront's own language elsewhere",
     },
     {
         slug: "jumia",
@@ -98,11 +107,30 @@ export const MARKETS = [
         idLabel: "a SKU such as OR537EA86PWGTNAFAMZ. A product URL does NOT contain it — the number at the " +
             "end of a product path is a different handle — so reach a product through `query` instead",
         region: { field: "market", hint: "ng, eg, ke, ma, ci, gh, sn, tn, ug or dz" },
+        searchLang: "English on ng, ke, gh and ug; French on ci, sn, ma, tn and dz; Arabic or French on eg",
+    },
+    // The one resale site here. Its `rating` describes the seller rather than the
+    // product, because a Vinted listing is a unique second-hand item with no
+    // reviews of its own — the server says so in `ratingScope`/`ratingNote` on
+    // every scan of it, and those are worth passing on rather than summarising
+    // away.
+    {
+        slug: "vinted",
+        label: "Vinted",
+        idLabel: "the numeric id from /items/<id>, or a full Vinted item URL",
+        region: {
+            field: "market",
+            hint: "one of 27 European storefronts — fr, de, es, it, pl, co.uk, com (US), com.au and the " +
+                "rest. A listing belongs to exactly one: the same item id does not exist on another " +
+                "country's Vinted",
+        },
+        searchLang: "the storefront's own — French on fr, German on de, Polish on pl, and so on",
     },
     {
         slug: "temu",
         label: "Temu",
         idLabel: "the goods id after -g- in a product URL, or the full URL",
+        searchLang: "English",
     },
 ];
 const BY_SLUG = new Map(MARKETS.map((m) => [m.slug, m]));
@@ -114,7 +142,7 @@ const SLUGS = MARKETS.map((m) => m.slug).join(", ");
 /**
  * The storefront argument, described site by site.
  *
- * One string rather than eleven schemas, because a tool takes one `marketplace`
+ * One string rather than twelve schemas, because a tool takes one `marketplace`
  * per call and the host shows the whole description whichever it picks. Sites
  * with a single storefront are named as taking none, so a model does not
  * invent one for Temu.
@@ -124,6 +152,8 @@ const MARKET_HINT = MARKETS.filter((m) => m.region)
     .join(" · ") +
     ` · ${MARKETS.filter((m) => !m.region).map((m) => m.label).join(", ")} have one storefront each ` +
     "and take no market argument.";
+/** Which language a query has to be in, site by site. */
+const LANG_HINT = MARKETS.map((m) => `${m.label}: ${m.searchLang}`).join(" · ");
 /** The product ids each site addresses by, for `items`. */
 const ID_HINT = MARKETS.map((m) => `${m.label}: ${m.idLabel}`).join(" · ");
 function structured(res) {
@@ -161,6 +191,9 @@ function marketplaceResult(payload, m, focus) {
         scanId: String(payload.scanId ?? ""),
         pending: Math.max(0, total - done),
         focus,
+        // Present only when the server answered from its own store. See the field's
+        // comment in `categoryGuidance` for why it is repeated in both channels.
+        freshness: typeof payload.freshness === "string" ? payload.freshness : undefined,
         site: m.label,
         statusTool: "marketplace_scan_status",
         // There is no free insights view for these sites yet, and pointing a model
@@ -177,6 +210,12 @@ function marketplaceResult(payload, m, focus) {
         complete: payload.complete !== false,
         query: payload.query ?? null,
         market: payload.market ?? payload.domain ?? null,
+        // Where this answer came from, and when the figures in it were measured.
+        // `collectedAt` is when the result was assembled, which on a stored answer
+        // is now and says nothing about the price's age; `observedAt` is the age.
+        servedFrom: payload.servedFrom ?? "live",
+        observedAt: payload.observedAt ?? null,
+        freshness: payload.freshness ?? null,
         progress,
         rollup,
         products,
@@ -197,7 +236,7 @@ export function registerMarketplaceTools(server, makeClient) {
     server.registerTool("scan_marketplace_category", {
         title: "Scan Marketplace Category",
         _meta: viewMeta("scan_marketplace_category"),
-        description: "Collect a category from any of eleven marketplaces and read it: products with prices, " +
+        description: "Collect a category from any of twelve marketplaces and read it: products with prices, " +
             "star histograms, the review text itself, and the arithmetic over them (price spread, " +
             "rating spread, which aspects recur across how many brands, and the share of each " +
             "product's ratings sitting at 1-2 stars). `marketplace` picks the site — one of " +
@@ -222,7 +261,17 @@ export function registerMarketplaceTools(server, makeClient) {
         inputSchema: z
             .object({
             marketplace: marketplaceArg,
-            query: z.string().optional().describe("Category or keyword to search, e.g. 'cast iron skillet'."),
+            query: z
+                .string()
+                .optional()
+                .describe("Category or keyword to search, e.g. 'cast iron skillet'. Two to four words, " +
+                "the common name a shopper would type rather than a catalogue description, " +
+                "and no quotes or AND/OR — none of these sites read them as operators, they " +
+                "search for them and narrow to nothing. It has to be in the storefront's " +
+                `language — ${LANG_HINT}. A query in the wrong language does not fail: it ` +
+                "returns a few imported listings, which reads as a thin category and is " +
+                "really a bad search. Brand names are not translated. A scan that came back " +
+                "with no products is a reason to change the query, not to raise the limit."),
             items: z
                 .array(z.string())
                 .optional()
@@ -329,7 +378,7 @@ export function registerMarketplaceTools(server, makeClient) {
     server.registerTool("get_marketplace_product", {
         title: "Get Marketplace Product",
         _meta: viewMeta("get_marketplace_product"),
-        description: "Fetch one product from any of eleven marketplaces by id or URL: price, rating, the full " +
+        description: "Fetch one product from any of twelve marketplaces by id or URL: price, rating, the full " +
             "star histogram, specs, and the review text. `marketplace` picks the site — one of " +
             `${SLUGS}. ` +
             "Costs 3 nooticr credits. " +

package/dist/shared/tools.js

@@ -28,7 +28,7 @@ import { registerCollabTools } from "./collab.js";
 import { registerAmazonTools } from "./amazon.js";
 import { registerMarketplaceTools } from "./marketplace.js";
 /** Current MCP server version — bumped on every deploy for traceability. */
-export const MCP_SERVER_VERSION = "1.26.39";
+export const MCP_SERVER_VERSION = "1.26.40";
 /** MCP Apps extension identifier */
 const UI_EXTENSION = "io.modelcontextprotocol/ui";
 /** MIME type for MCP Apps HTML resources */

package/dist/shared/ui-template.js

@@ -3677,6 +3677,7 @@ export const NOOTICR_UI_TEMPLATE = `<!DOCTYPE html>
     rakuten:{label:"Rakuten",color:"#BF0000",on:"#fff",path:"M23.277 21.3L3.939 24 .722 21.3h22.555zM7.6 19.276H3.939V0h6.052a6.653 6.653 0 0 1 6.65 6.646c0 2.234-1.108 4.204-2.799 5.418l5.418 7.211h-4.585l-4.486-5.979H7.6v5.98zm0-9.64h2.392a2.992 2.992 0 0 0 2.989-2.989 2.994 2.994 0 0 0-2.989-2.986H7.6v5.975z"},
     trendyol:{label:"Trendyol",color:"#F27A1A",on:"#fff"},
     jumia:{label:"Jumia",color:"#F68B1E",on:"#111"},
+    vinted:{label:"Vinted",color:"#007782",on:"#fff"},
     temu:{label:"Temu",color:"#FB7701",on:"#fff"}
   };
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nooticr/mcp",
   "mcpName": "com.nooticr/mcp",
-  "version": "1.26.39",
+  "version": "1.26.40",
   "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": {