wallapop-mcp 0.1.1 → 0.2.0

package/dist/index.js

@@ -39715,13 +39715,17 @@ var generatedCategories = [
 ];
 
 // src/categories/search.ts
+function normalizeSearchText(value) {
+  return value.trim().normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase();
+}
 function searchCategories(categories, query) {
-  if (!query) {
+  const trimmedQuery = query?.trim();
+  if (!trimmedQuery) {
     return categories.filter((category) => category.path.length === 0);
   }
-  const needle = query.toLowerCase();
+  const needle = normalizeSearchText(trimmedQuery);
   return categories.filter(
-    (category) => category.name.toLowerCase().includes(needle)
+    (category) => normalizeSearchText(category.name).includes(needle)
   );
 }
 
@@ -39769,6 +39773,12 @@ function buildSearchRequest(input) {
 
 // src/search/listing.ts
 function normalizeItem(raw) {
+  if (!raw.price) {
+    throw new Error(`Malformed Wallapop item ${raw.id}: missing price`);
+  }
+  if (!raw.images[0]) {
+    throw new Error(`Malformed Wallapop item ${raw.id}: missing images`);
+  }
   return {
     id: raw.id,
     title: raw.title,
@@ -39790,6 +39800,34 @@ function normalizeItem(raw) {
 // src/search/paginate.ts
 var DEFAULT_MAX_RESULTS = 40;
 var MAX_RESULTS_CAP = 200;
+function extractItems(body) {
+  const data = body.data;
+  if (!data) {
+    throw new Error("Malformed Wallapop response: missing data");
+  }
+  const section = data.section;
+  if (!section) {
+    throw new Error("Malformed Wallapop response: missing data.section");
+  }
+  const payload = section.payload;
+  if (!payload) {
+    throw new Error(
+      "Malformed Wallapop response: missing data.section.payload"
+    );
+  }
+  const items = payload.items;
+  if (items === void 0) {
+    throw new Error(
+      "Malformed Wallapop response: missing data.section.payload.items"
+    );
+  }
+  if (!Array.isArray(items)) {
+    throw new Error(
+      "Malformed Wallapop response: data.section.payload.items is not an array"
+    );
+  }
+  return items;
+}
 async function searchListings(input, { fetchImpl }) {
   const maxResults = Math.min(
     input.maxResults ?? DEFAULT_MAX_RESULTS,
@@ -39807,7 +39845,7 @@ async function searchListings(input, { fetchImpl }) {
       );
     }
     const body = await response.json();
-    const items = body.data.section.payload.items;
+    const items = extractItems(body);
     for (const raw of items) {
       if (listings.length >= maxResults) break;
       listings.push(normalizeItem(raw));
@@ -39824,15 +39862,15 @@ function createServer(deps = {}) {
   const fetchImpl = deps.fetchImpl ?? fetch;
   const server2 = new McpServer({
     name: "wallapop-mcp",
-    version: "0.1.0"
+    version: "0.2.0"
   });
   server2.registerTool(
     "list_categories",
     {
-      description: "Free-text search over Wallapop's category tree. With no query, returns the top-level categories.",
+      description: "Free-text, case-insensitive, accent- and whitespace-insensitive search over Wallapop's static category tree. Use it to resolve a category name to the numeric categoryId accepted by the search tool's categoryId argument. With no query (or an empty/whitespace-only query), returns only the top-level categories.",
       inputSchema: {
         query: external_exports.string().optional().describe(
-          "Case-insensitive substring to match against category names."
+          "Case-insensitive, accent- and whitespace-insensitive substring to match against category names."
         )
       }
     },
@@ -39846,23 +39884,38 @@ function createServer(deps = {}) {
   server2.registerTool(
     "search",
     {
-      description: "Search Wallapop's marketplace. Defaults to the Barcelona-center location when latitude/longitude are omitted.",
+      description: "Search Wallapop's marketplace listings. Read-only: no login, purchase, messaging, reservation, or favoriting is performed. Defaults to the Barcelona-center location when latitude/longitude are omitted. Returns up to maxResults listings (default 40, hard-capped at 200 even if a higher value is requested). Item condition (e.g. new/used) is rarely present in Wallapop's raw data \u2014 treat it as unreliable and do not tell the user results are filtered by condition.",
       inputSchema: {
-        keywords: external_exports.string().optional(),
-        categoryId: external_exports.number().optional(),
-        minPrice: external_exports.number().optional(),
-        maxPrice: external_exports.number().optional(),
-        distanceInKm: external_exports.number().optional(),
-        orderBy: external_exports.string().optional(),
-        latitude: external_exports.number().optional(),
-        longitude: external_exports.number().optional(),
+        keywords: external_exports.string().optional().describe("Free-text keywords, passed through to Wallapop as-is."),
+        categoryId: external_exports.number().optional().describe(
+          "Numeric Wallapop category id (e.g. from list_categories) to restrict results to."
+        ),
+        minPrice: external_exports.number().nonnegative().optional().describe(
+          "Minimum price in EUR, inclusive. Must be zero or greater."
+        ),
+        maxPrice: external_exports.number().nonnegative().optional().describe(
+          "Maximum price in EUR, inclusive. Must be zero or greater, and must not be less than minPrice when both are given."
+        ),
+        distanceInKm: external_exports.number().positive().optional().describe(
+          "Search radius in kilometers from the search location. Must be greater than zero."
+        ),
+        orderBy: external_exports.string().optional().describe(
+          'Sort order, passed through to Wallapop unvalidated (e.g. "price_low_to_high"). No enumerated list of legal values is confirmed here; an invalid value may be ignored or rejected upstream rather than erroring in this tool.'
+        ),
+        latitude: external_exports.number().min(-90).max(90).optional().describe("Search latitude in decimal degrees, -90 to 90."),
+        longitude: external_exports.number().min(-180).max(180).optional().describe("Search longitude in decimal degrees, -180 to 180."),
         nextPage: external_exports.string().optional().describe(
-          "Opaque pagination cursor from a previous search's response."
+          "Opaque pagination cursor from a previous search response's nextPage field. Pass it back exactly as received (unmodified) to fetch the next page; do not construct or edit it."
         ),
-        maxResults: external_exports.number().optional().describe("Default 40, clamped to a 200 cap.")
+        maxResults: external_exports.number().int().nonnegative().optional().describe("Default 40, clamped to a 200 cap.")
       }
     },
     async (input) => {
+      if (input.minPrice !== void 0 && input.maxPrice !== void 0 && input.minPrice > input.maxPrice) {
+        throw new Error(
+          `Invalid search input: minPrice (${input.minPrice}) must not exceed maxPrice (${input.maxPrice})`
+        );
+      }
       const result = await searchListings(input, { fetchImpl });
       return {
         content: [{ type: "text", text: JSON.stringify(result) }]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wallapop-mcp",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "MCP server wrapping Wallapop's unofficial public search API",
   "type": "module",
   "license": "MIT",