Wallapop MCP Server
Servidor MCP de Wallapop
Servidor MCP híbrido y no oficial para el mercado de Wallapop, construido en TypeScript.
HTTP principal: llamadas de ingeniería inversa a los endpoints privados v3 de
api.wallapop.comRespaldo SSR: extracción de
__NEXT_DATA__de las páginas dees.wallapop.com(detalles de artículos, perfiles de vendedores)Respaldo Playwright: navegador con interfaz fuera de pantalla como último recurso (el CDN de Wallapop bloquea Chrome sin interfaz)
Autenticación: opcional con correo/contraseña o importación de cookies del navegador para favoritos, búsquedas guardadas, chat y ofertas (refresco de token + persistencia de sesión)
No oficial y sin afiliación. Utiliza la API no documentada de Wallapop, que puede cambiar o bloquear el tráfico en cualquier momento: úsalo bajo tu propio riesgo, mantén un volumen de solicitudes bajo y respeta sus Términos de Servicio.
Herramientas
Herramienta | Autenticación | Descripción |
| – | Búsqueda por palabras clave con filtros de categoría / precio / ubicación / radio / orden, paginación con cursor ( |
| – | Escaneo de palabras clave múltiples con deduplicación, filtrado por precio y marcado de estafas (anuncios enviables) |
| – | Detalle completo del anuncio: descripción, estado, precio, imágenes, visitas, favoritos, vendedor, envío |
| – | Perfil del vendedor por id o slug web: valoración (0–100), recuento de vendidos/publicados, fecha de registro, ubicación |
| – | Árbol de categorías del mercado con ids |
| – | Estado de salud / autenticación / respaldo del navegador |
| requerida | Favoritos por id numérico, slug web o URL del artículo (API + respaldo del navegador) |
| requerida | Alertas de búsquedas guardadas |
| requerida | Bandeja de entrada del chat: otro usuario, artículo, no leídos, último mensaje |
| requerida | Historial completo de mensajes de una conversación |
| requerida | Enviar un mensaje de chat (canal en tiempo real) |
| requerida | Enviar una oferta de compra (EUR) — el vendedor la recibe en el chat y puede aceptarla/rechazarla |
Related MCP server: Bazos-MCP
Inicio rápido
git clone <this-repo>
cd WallpopMCP
npm install
npm run build
cp .env.example .env # fill in your keys (see Configuration)
npm run smoke # live sanity check against the APIConectar a un cliente MCP
# Claude Code (stdio)
claude mcp add wallapop -- node /absolute/path/to/WallpopMCP/dist/index.js# Inspector (browse tools interactively)
npm run inspectorConfiguración (.env, ver .env.example)
Variable | Propósito |
| Habilitar herramientas de autenticación (favoritos, búsquedas guardadas, chat, ofertas) |
| Matriz JSON opcional de cookies del navegador ( |
| Ubicación de búsqueda predeterminada (centro de Barcelona) |
| Persistencia de token/cookie (por defecto |
| Retraso mínimo entre llamadas a la API (por defecto 600) |
| Límite de resultados de búsqueda, 1–200 (por defecto 200) |
|
|
Nota:
WALLAPOP_EMAIL/WALLAPOP_PASSWORDpueden fallar para cuentas con MFA o flujos de Keycloak — en ese caso, exporta cookies desde un navegador con sesión iniciada aWALLAPOP_COOKIES_FILE(una matriz JSON de objetos de cookie) y el servidor las usará directamente.
Cómo funciona
Búsqueda (flujo de API en dos pasos)
GET /api/v3/search/components→search_idGET /api/v3/search/section(40 artículos/página) →meta.next_pageJWT; el servidor empaquetasearch_id+ cursor en un tokennextPageopaco para que los clientes simplemente lo devuelvan.
Chat y ofertas
Los mensajes se envían a través del canal en tiempo real (PubNub) y también llegan a la API de bandeja de entrada (
/bff/messaging/inbox) — ambos verificados de extremo a extremo.Las ofertas se crean mediante
POST /api/v3/delivery/buyer/offerscon un id de oferta generado por el cliente; los vendedores las reciben en la conversación.
Autenticación
Intenta
POST /api/v3/access/login→ almacena tokens de acceso/refresco + cookies en el archivo de sesión, refresca mediantePOST /api/v3/access/refreshcuando el JWT está a punto de expirar.Recurre a un inicio de sesión automatizado del navegador; los desafíos MFA se detectan y se muestran como un error (complétalo manualmente, luego exporta las cookies a
WALLAPOP_COOKIES_FILE).
Cadena de respaldo
Solicitud a la API con cabeceras similares a las de un navegador, rotación de UA, retroceso exponencial en 429 y reintento con
X-Signatureen 403Extracción de HTML SSR (
es.wallapop.com/item/...,/user/...) — datos más ricos para vendedores (valoraciones, contadores)Chrome con interfaz fuera de pantalla mediante Playwright (captura las respuestas XHR de
api.wallapop.com) — el CDN de Wallapop bloquea el modo sin interfaz, así que nunca usesWALLAPOP_BROWSER=chromiumsin descargas manuales del navegador;autoprefiere Chrome/Edge instalados
Notas y limitaciones conocidas
El filtrado por precio (
minPrice/maxPrice) y por radio (distance_in_km) desearch_productsson parámetros del lado de la API.favorite_listing/unfavorite_listingusan candidatos de endpoint de mejor esfuerzo — verifica con tu cuenta; los endpoints cambian.El
conditiondel artículo solo está disponible de forma fiable medianteget_listing(los resultados de búsqueda normalmente lo omiten).Algunos vendedores desactivan las ofertas —
make_offermuestra un error 409 en ese caso.
Available Tools
6 toolsget_listingGet full listing detailsA
Get detailed information about a single Wallapop listing: description, condition, price, images, location, views, favorites, seller id, shipping options. Accepts the numeric listing id, a web slug, or a full item URL. Falls back to server-side rendering when the API fails.
Inputs: itemId (required).
get_sellerGet seller informationA
Get a Wallapop seller profile by numeric user id (from a listing) or by web slug (e.g. 'sergiof-462579195'): rating, review count, sold/published counts, registration date, location.
Inputs: reference (required).
list_categoriesList Wallapop categoriesA
List all marketplace top-level categories with ids and subcategories.
Inputs: no named parameters.
scan_productsScan multiple searches for phone candidatesA
Runs several keyword searches (default nationwide radius) and dedupes results, keeping only in-range, shippable listings and flagging suspicious ones (scam wording or book-slug retitled listings). Returns compact candidate list, ready for get_listing/verify.
Inputs: queries (required), distanceKm, maxResultsPerQuery.
search_productsSearch Wallapop listingsA
Search Wallapop for products with optional filters: category, price range, location (latitude/longitude), radius, sort order. Paginate with the nextPage cursor returned. Reserved listings are filtered out. Returns up to maxResults listings (default 40, capped at 200).
Inputs: keywords (required), orderBy, latitude, maxPrice, +6 more.
server_statusGet MCP server health and auth statusA
Returns whether the server is configured for public or authenticated use, whether a session is loaded, and whether browser fallback is available.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools are clearly distinct: search_products, get_listing, get_seller, list_categories, and server_status each target a different resource or action. The main ambiguity is between search_products and scan_products, though scan_products is clearly positioned as a specialized multi-keyword search with deduplication.
The naming pattern is largely consistent: search_products, get_listing, get_seller, list_categories, and scan_products all follow verb_noun naming. server_status breaks the pattern slightly by using a noun phrase instead of a get_ or status_ verb, but it is still readable and predictable.
Six tools is well-scoped for a marketplace browsing/searching MCP server. Each tool covers a meaningful capability without bloat, and the count feels appropriate for the server's purpose.
The core browsing flow is covered: search listings, get listing details, get seller profiles, and list categories. Minor gaps exist such as not being able to list a seller's active listings or perform authenticated actions, but those are not necessarily core to this server's stated scope.
Related MCP Connectors
Hosted WhatsApp MCP server: read, search and reply to your own WhatsApp chats from your AI.
Your own WhatsApp as an MCP server: read, search and send from any MCP client.
Official SerpApi MCP server for Google, Bing, and other search engines.
Related MCP Servers
- AlicenseBqualityAmaintenanceMCP server for automating Xianyu (Goofish) marketplace operations: publish, manage items, handle IM messages, and more via CLI or AI agents.171,060 PyPI498Apache 2.0
- AlicenseAqualityCmaintenanceMCP server for interacting with Bazos.cz, Bazos.sk, Bazos.at, and Bazos.pl. Supports searching ads, retrieving ad details, and fetching user ratings.3101 npm4AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceAn MCP server for Vinted search and analysis that provides tools to search listings, fetch item details, inspect seller profiles, compare prices across countries, and surface trending items.36AGPL 3.0
- FlicenseBqualityDmaintenanceRead-only MCP server for WhatsApp Web allowing listing chats and reading recent messages, without sending or mutating WhatsApp state.3-