Wallapop MCP Server
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.comv3-EndpunkteSSR-Fallback:
__NEXT_DATA__-Scraping vones.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 |
| – | Stichwortsuche mit Kategorie-/Preis-/Standort-/Radius-/Sortierfiltern, Cursor-Paginierung ( |
| – | Multi-Query-Stichwortscan mit Deduplizierung, Preisfilterung und Betrugsmarkierung (versandfähige Angebote) |
| – | Vollständige Artikeldetails: Beschreibung, Zustand, Preis, Bilder, Aufrufe, Favoriten, Verkäufer, Versand |
| – | Verkäuferprofil per ID oder Web-Slug: Bewertung (0–100), Verkaufs-/Veröffentlichungszahlen, Registrierungsdatum, Standort |
| – | Marktplatz-Kategoriebaum mit IDs |
| – | Status von Gesundheit / Authentifizierung / Browser-Fallback |
| erforderlich | Favoriten per numerischer ID, Web-Slug oder Artikel-URL (API + Browser-Fallback) |
| erforderlich | Benachrichtigungen für gespeicherte Suchen |
| erforderlich | Chat-Posteingang: anderer Benutzer, Artikel, ungelesene Anzahl, letzte Nachricht |
| erforderlich | Vollständiger Nachrichtenverlauf einer Konversation |
| erforderlich | Chat-Nachricht senden (Echtzeitkanal) |
| 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 APIMit 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 inspectorKonfiguration (.env, siehe .env.example)
Variable | Zweck |
| Authentifizierungs-Tools aktivieren (Favoriten, gespeicherte Suchen, Chat, Angebote) |
| Optionales JSON-Array von Browser-Cookies ( |
| Standard-Suchstandort (Zentrum von Barcelona) |
| Token-/Cookie-Persistenz (Standard |
| Mindestverzögerung zwischen API-Aufrufen (Standard 600) |
| Obergrenze für Suchergebnisse, 1–200 (Standard 200) |
|
|
Hinweis:
WALLAPOP_EMAIL/WALLAPOP_PASSWORDkönnen bei Konten mit MFA oder Keycloak-Flows fehlschlagen – in diesem Fall exportieren Sie Cookies aus einem angemeldeten Browser inWALLAPOP_COOKIES_FILE(ein JSON-Array von Cookie-Objekten) und der Server verwendet sie direkt.
So funktioniert es
Suche (zweistufiger API-Ablauf)
GET /api/v3/search/components→search_idGET /api/v3/search/section(40 Artikel/Seite) →meta.next_pageJWT; der Server packtsearch_id+ Cursor in ein undurchsichtigesnextPage-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/offersmit 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 überPOST /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_FILEexportieren).
Fallback-Kette
API-Anfrage mit browserähnlichen Headern, UA-Rotation, exponentiellem Backoff bei 429 und
X-Signature-Wiederholung bei 403SSR-HTML-Scraping (
es.wallapop.com/item/...,/user/...) – reichhaltigere Daten für Verkäufer (Bewertungen, Zähler)Off-Screen-Headless-Chrome über Playwright (erfasst
api.wallapop.comXHR-Antworten) – Wallapops CDN blockiert Headless-Modus, daher niemalsWALLAPOP_BROWSER=chromiumohne manuelle Browser-Downloads verwenden;autobevorzugt installiertes Chrome/Edge
Hinweise und bekannte Einschränkungen
Die Preisfilterung (
minPrice/maxPrice) und Radiusfilterung (distance_in_km) vonsearch_productssind API-seitige Parameter.favorite_listing/unfavorite_listingverwenden Best-Effort-Endpunktkandidaten – mit Ihrem Konto verifizieren; Endpunkte ändern sich.Der Artikelzustand (
condition) ist nur zuverlässig überget_listingverfügbar (Suchergebnisse lassen ihn normalerweise aus).Einige Verkäufer deaktivieren Angebote –
make_offerzeigt in diesem Fall einen 409-Fehler an.
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-