Skip to main content
Glama
Wallapop MCP Server

Wallapop MCP Server

by AdeiTamayo

Wallapop MCP Server

Hybrider, inoffizieller MCP-Server für den Wallapop-Marktplatz, entwickelt in TypeScript.

  • HTTP-Primär: Reverse-Engineering-Aufrufe an die privaten api.wallapop.com v3-Endpunkte

  • SSR-Fallback: __NEXT_DATA__-Scraping von es.wallapop.com-Seiten (Artikeldetails, Verkäuferprofile)

  • Playwright-Fallback: Off-Screen-Headless-Browser als letzte Option (Wallapops CDN blockiert Headless-Chrome)

  • Authentifizierung: Optional E-Mail/Passwort oder Browser-Cookie-Import für Favoriten, gespeicherte Suchen, Chat und Angebote (Token-Aktualisierung + Sitzungspersistenz)

Inoffiziell und nicht verbunden. Verwendet Wallapops undokumentierte API, die sich jederzeit ändern oder Datenverkehr blockieren kann – Nutzung auf eigenes Risiko, halten Sie das Anfragevolumen niedrig und respektieren Sie die Nutzungsbedingungen.

Tools

Tool

Auth

Beschreibung

search_products

–

Stichwortsuche mit Kategorie-/Preis-/Standort-/Radius-/Sortierfiltern, Cursor-Paginierung (nextPage), reservierte Artikel herausgefiltert

scan_products

–

Multi-Query-Stichwortscan mit Deduplizierung, Preisfilterung und Betrugsmarkierung (versandfähige Angebote)

get_listing

–

Vollständige Artikeldetails: Beschreibung, Zustand, Preis, Bilder, Aufrufe, Favoriten, Verkäufer, Versand

get_seller

–

Verkäuferprofil per ID oder Web-Slug: Bewertung (0–100), Verkaufs-/Veröffentlichungszahlen, Registrierungsdatum, Standort

list_categories

–

Marktplatz-Kategoriebaum mit IDs

server_status

–

Status von Gesundheit / Authentifizierung / Browser-Fallback

favorite_listing / unfavorite_listing

erforderlich

Favoriten per numerischer ID, Web-Slug oder Artikel-URL (API + Browser-Fallback)

get_saved_searches / create_saved_search / delete_saved_search

erforderlich

Benachrichtigungen für gespeicherte Suchen

list_conversations

erforderlich

Chat-Posteingang: anderer Benutzer, Artikel, ungelesene Anzahl, letzte Nachricht

get_messages

erforderlich

Vollständiger Nachrichtenverlauf einer Konversation

send_message

erforderlich

Chat-Nachricht senden (Echtzeitkanal)

make_offer

erforderlich

Kaufangebot senden (EUR) – der Verkäufer erhält es im Chat und kann annehmen/ablehnen

Related MCP server: Bazos-MCP

Schnellstart

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

Mit einem MCP-Client verbinden

# Claude Code (stdio)
claude mcp add wallapop -- node /absolute/path/to/WallpopMCP/dist/index.js
# Inspector (browse tools interactively)
npm run inspector

Konfiguration (.env, siehe .env.example)

Variable

Zweck

WALLAPOP_EMAIL / WALLAPOP_PASSWORD

Authentifizierungs-Tools aktivieren (Favoriten, gespeicherte Suchen, Chat, Angebote)

WALLAPOP_COOKIES_FILE

Optionales JSON-Array von Browser-Cookies ([{ name, value }]), exportiert aus einer angemeldeten Sitzung – der zuverlässigste authentifizierte Pfad

WALLAPOP_DEFAULT_LAT / LNG / DISTANCE_KM

Standard-Suchstandort (Zentrum von Barcelona)

WALLAPOP_SESSION_FILE

Token-/Cookie-Persistenz (Standard ./wallapop-session.json, gitignored)

WALLAPOP_RATE_DELAY_MS

Mindestverzögerung zwischen API-Aufrufen (Standard 600)

WALLAPOP_MAX_RESULTS

Obergrenze für Suchergebnisse, 1–200 (Standard 200)

WALLAPOP_BROWSER

auto (Standard) | chrome | msedge | chromium | off

Hinweis: WALLAPOP_EMAIL/WALLAPOP_PASSWORD können bei Konten mit MFA oder Keycloak-Flows fehlschlagen – in diesem Fall exportieren Sie Cookies aus einem angemeldeten Browser in WALLAPOP_COOKIES_FILE (ein JSON-Array von Cookie-Objekten) und der Server verwendet sie direkt.

So funktioniert es

Suche (zweistufiger API-Ablauf)

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

  2. GET /api/v3/search/section (40 Artikel/Seite) → meta.next_page JWT; der Server packt search_id + Cursor in ein undurchsichtiges nextPage-Token, sodass Clients es einfach zurückschicken.

Chat & Angebote

  • Nachrichten werden über den Echtzeitkanal (PubNub) gesendet und landen auch in der Inbox-API (/bff/messaging/inbox) – beide Ende-zu-Ende verifiziert.

  • Angebote werden über POST /api/v3/delivery/buyer/offers mit einer clientgenerierten Angebots-ID erstellt; Verkäufer erhalten sie in der Konversation.

Authentifizierung

  • Versucht POST /api/v3/access/login → speichert Zugriffs-/Aktualisierungstokens + Cookies in der Sitzungsdatei, aktualisiert über POST /api/v3/access/refresh, wenn das JWT kurz vor Ablauf steht.

  • Fällt auf einen automatisierten Browser-Login zurück; MFA-Herausforderungen werden erkannt und als Fehler angezeigt (manuell abschließen, dann Cookies in WALLAPOP_COOKIES_FILE exportieren).

Fallback-Kette

  1. API-Anfrage mit browserähnlichen Headern, UA-Rotation, exponentiellem Backoff bei 429 und X-Signature-Wiederholung bei 403

  2. SSR-HTML-Scraping (es.wallapop.com/item/..., /user/...) – reichhaltigere Daten für Verkäufer (Bewertungen, Zähler)

  3. Off-Screen-Headless-Chrome über Playwright (erfasst api.wallapop.com XHR-Antworten) – Wallapops CDN blockiert Headless-Modus, daher niemals WALLAPOP_BROWSER=chromium ohne manuelle Browser-Downloads verwenden; auto bevorzugt installiertes Chrome/Edge

Hinweise und bekannte Einschränkungen

  • Die Preisfilterung (minPrice/maxPrice) und Radiusfilterung (distance_in_km) von search_products sind API-seitige Parameter.

  • favorite_listing/unfavorite_listing verwenden Best-Effort-Endpunktkandidaten – mit Ihrem Konto verifizieren; Endpunkte ändern sich.

  • Der Artikelzustand (condition) ist nur zuverlässig über get_listing verfügbar (Suchergebnisse lassen ihn normalerweise aus).

  • Einige Verkäufer deaktivieren Angebote – make_offer zeigt in diesem Fall einen 409-Fehler an.

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