Wallapop MCP Server
Wallapop MCP Server
Гибридный, неофициальный MCP-сервер для маркетплейса Wallapop, написанный на TypeScript.
Основной HTTP-канал: реверс-инжиниринг вызовов к приватным v3-эндпоинтам
api.wallapop.comSSR-запасной вариант: скрейпинг
__NEXT_DATA__со страницes.wallapop.com(детали объявлений, профили продавцов)Запасной вариант на Playwright: невидимый браузер с окном как крайняя мера (CDN Wallapop блокирует headless Chrome)
Аутентификация: опционально email/пароль или импорт cookie из браузера для избранного, сохранённых поисков, чата и предложений (обновление токена + сохранение сессии)
Неофициальный и не аффилированный. Использует недокументированное API Wallapop, которое может измениться или заблокировать трафик в любой момент — используйте на свой страх и риск, держите низкий объём запросов и соблюдайте их Условия предоставления услуг.
Инструменты
Инструмент | Авторизация | Описание |
| – | Поиск по ключевым словам с фильтрами по категории / цене / местоположению / радиусу / сортировке, курсорная пагинация ( |
| – | Многозапросное сканирование по ключевым словам с дедупликацией, фильтрацией по цене и пометкой подозрительных объявлений (объявления с доставкой) |
| – | Полная информация об объявлении: описание, состояние, цена, изображения, просмотры, избранное, продавец, доставка |
| – | Профиль продавца по id или веб-слагу: рейтинг (0–100), количество проданных/опубликованных товаров, дата регистрации, местоположение |
| – | Дерево категорий маркетплейса с id |
| – | Статус здоровья / авторизации / браузерного запасного варианта |
| требуется | Избранное по числовому id, веб-слагу или URL объявления (API + браузерный запасной вариант) |
| требуется | Оповещения о сохранённых поисках |
| требуется | Входящие чата: другой пользователь, товар, количество непрочитанных, последнее сообщение |
| требуется | Полная история сообщений беседы |
| требуется | Отправить сообщение в чат (канал реального времени) |
| требуется | Отправить предложение о покупке (EUR) — продавец получает его в чате и может принять/отклонить |
Related MCP server: Bazos-MCP
Быстрый старт
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Подключение к MCP-клиенту
# Claude Code (stdio)
claude mcp add wallapop -- node /absolute/path/to/WallpopMCP/dist/index.js# Inspector (browse tools interactively)
npm run inspectorКонфигурация (.env, см. .env.example)
Переменная | Назначение |
| Включает инструменты с авторизацией (избранное, сохранённые поиски, чат, предложения) |
| Опциональный JSON-массив cookie браузера ( |
| Местоположение поиска по умолчанию (центр Барселоны) |
| Сохранение токена/cookie (по умолчанию |
| Минимальная задержка между вызовами API (по умолчанию 600) |
| Ограничение результатов поиска, 1–200 (по умолчанию 200) |
|
|
Примечание:
WALLAPOP_EMAIL/WALLAPOP_PASSWORDмогут не сработать для аккаунтов с MFA или Keycloak-потоками — в этом случае экспортируйте cookie из авторизованного браузера вWALLAPOP_COOKIES_FILE(JSON-массив объектов cookie), и сервер будет использовать их напрямую.
Как это работает
Поиск (двухэтапный API-поток)
GET /api/v3/search/components→search_idGET /api/v3/search/section(40 товаров/страница) →meta.next_pageJWT; сервер упаковываетsearch_id+ курсор в непрозрачный токенnextPage, чтобы клиенты просто передавали его обратно.
Чат и предложения
Сообщения отправляются через канал реального времени (PubNub) и также попадают в API входящих (
/bff/messaging/inbox) — оба пути проверены end-to-end.Предложения создаются через
POST /api/v3/delivery/buyer/offersс сгенерированным клиентом id предложения; продавцы получают их в беседе.
Аутентификация
Пытается выполнить
POST /api/v3/access/login→ сохраняет access/refresh токены + cookie в файл сессии, обновляет черезPOST /api/v3/access/refresh, когда JWT скоро истечёт.Запасной вариант — автоматический вход через браузер; вызовы MFA обнаруживаются и выводятся как ошибка (завершите их вручную, затем экспортируйте cookie в
WALLAPOP_COOKIES_FILE).
Цепочка запасных вариантов
API-запрос с заголовками как у браузера, ротацией UA, экспоненциальной задержкой при 429 и повтором с
X-Signatureпри 403Скрейпинг SSR HTML (
es.wallapop.com/item/...,/user/...) — более богатые данные для продавцов (рейтинги, счётчики)Невидимый Chrome с окном через Playwright (перехватывает XHR-ответы
api.wallapop.com) — CDN Wallapop блокирует headless-режим, поэтому никогда не используйтеWALLAPOP_BROWSER=chromiumбез ручной загрузки браузеров;autoпредпочитает установленные Chrome/Edge
Примечания и известные ограничения
Фильтрация по цене (
minPrice/maxPrice) и по радиусу (distance_in_km) вsearch_products— параметры на стороне API.favorite_listing/unfavorite_listingиспользуют кандидатов эндпоинтов по принципу best-effort — проверьте на своём аккаунте; эндпоинты меняются.Состояние товара (
condition) надёжно доступно только черезget_listing(результаты поиска обычно его опускают).Некоторые продавцы отключают предложения — в этом случае
make_offerвозвращает ошибку 409.
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-