Skip to main content
Glama
Wallapop MCP Server

Wallapop MCP Server

by AdeiTamayo

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.com

  • Respaldo SSR: extracción de __NEXT_DATA__ de las páginas de es.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

search_products

–

Búsqueda por palabras clave con filtros de categoría / precio / ubicación / radio / orden, paginación con cursor (nextPage), artículos reservados filtrados

scan_products

–

Escaneo de palabras clave múltiples con deduplicación, filtrado por precio y marcado de estafas (anuncios enviables)

get_listing

–

Detalle completo del anuncio: descripción, estado, precio, imágenes, visitas, favoritos, vendedor, envío

get_seller

–

Perfil del vendedor por id o slug web: valoración (0–100), recuento de vendidos/publicados, fecha de registro, ubicación

list_categories

–

Árbol de categorías del mercado con ids

server_status

–

Estado de salud / autenticación / respaldo del navegador

favorite_listing / unfavorite_listing

requerida

Favoritos por id numérico, slug web o URL del artículo (API + respaldo del navegador)

get_saved_searches / create_saved_search / delete_saved_search

requerida

Alertas de búsquedas guardadas

list_conversations

requerida

Bandeja de entrada del chat: otro usuario, artículo, no leídos, último mensaje

get_messages

requerida

Historial completo de mensajes de una conversación

send_message

requerida

Enviar un mensaje de chat (canal en tiempo real)

make_offer

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 API

Conectar 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 inspector

Configuración (.env, ver .env.example)

Variable

Propósito

WALLAPOP_EMAIL / WALLAPOP_PASSWORD

Habilitar herramientas de autenticación (favoritos, búsquedas guardadas, chat, ofertas)

WALLAPOP_COOKIES_FILE

Matriz JSON opcional de cookies del navegador ([{ name, value }]) exportadas desde una sesión iniciada — la ruta autenticada más fiable

WALLAPOP_DEFAULT_LAT / LNG / DISTANCE_KM

Ubicación de búsqueda predeterminada (centro de Barcelona)

WALLAPOP_SESSION_FILE

Persistencia de token/cookie (por defecto ./wallapop-session.json, ignorado por git)

WALLAPOP_RATE_DELAY_MS

Retraso mínimo entre llamadas a la API (por defecto 600)

WALLAPOP_MAX_RESULTS

Límite de resultados de búsqueda, 1–200 (por defecto 200)

WALLAPOP_BROWSER

auto (por defecto) | chrome | msedge | chromium | off

Nota: WALLAPOP_EMAIL/WALLAPOP_PASSWORD pueden fallar para cuentas con MFA o flujos de Keycloak — en ese caso, exporta cookies desde un navegador con sesión iniciada a WALLAPOP_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)

  1. GET /api/v3/search/components → search_id

  2. GET /api/v3/search/section (40 artículos/página) → meta.next_page JWT; el servidor empaqueta search_id + cursor en un token nextPage opaco 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/offers con 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 mediante POST /api/v3/access/refresh cuando 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

  1. Solicitud a la API con cabeceras similares a las de un navegador, rotación de UA, retroceso exponencial en 429 y reintento con X-Signature en 403

  2. Extracción de HTML SSR (es.wallapop.com/item/..., /user/...) — datos más ricos para vendedores (valoraciones, contadores)

  3. 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 uses WALLAPOP_BROWSER=chromium sin descargas manuales del navegador; auto prefiere Chrome/Edge instalados

Notas y limitaciones conocidas

  • El filtrado por precio (minPrice/maxPrice) y por radio (distance_in_km) de search_products son parámetros del lado de la API.

  • favorite_listing/unfavorite_listing usan candidatos de endpoint de mejor esfuerzo — verifica con tu cuenta; los endpoints cambian.

  • El condition del artículo solo está disponible de forma fiable mediante get_listing (los resultados de búsqueda normalmente lo omiten).

  • Algunos vendedores desactivan las ofertas — make_offer muestra un error 409 en ese caso.

Available Tools

6 tools
get_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

    A4/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      A
      maintenance
      MCP server for automating Xianyu (Goofish) marketplace operations: publish, manage items, handle IM messages, and more via CLI or AI agents.
      17
      1,060 PyPI
      498
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for interacting with Bazos.cz, Bazos.sk, Bazos.at, and Bazos.pl. Supports searching ads, retrieving ad details, and fetching user ratings.
      3
      101 npm
      4
      AGPL 3.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      An 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.
      36
      AGPL 3.0