Skip to main content
Glama
Wallapop MCP Server

Wallapop MCP Server

by AdeiTamayo

Wallapop MCP Server

Гибридный, неофициальный MCP-сервер для маркетплейса Wallapop, написанный на TypeScript.

  • Основной HTTP-канал: реверс-инжиниринг вызовов к приватным v3-эндпоинтам api.wallapop.com

  • SSR-запасной вариант: скрейпинг __NEXT_DATA__ со страниц es.wallapop.com (детали объявлений, профили продавцов)

  • Запасной вариант на Playwright: невидимый браузер с окном как крайняя мера (CDN Wallapop блокирует headless Chrome)

  • Аутентификация: опционально email/пароль или импорт cookie из браузера для избранного, сохранённых поисков, чата и предложений (обновление токена + сохранение сессии)

Неофициальный и не аффилированный. Использует недокументированное API Wallapop, которое может измениться или заблокировать трафик в любой момент — используйте на свой страх и риск, держите низкий объём запросов и соблюдайте их Условия предоставления услуг.

Инструменты

Инструмент

Авторизация

Описание

search_products

–

Поиск по ключевым словам с фильтрами по категории / цене / местоположению / радиусу / сортировке, курсорная пагинация (nextPage), зарезервированные товары отфильтровываются

scan_products

–

Многозапросное сканирование по ключевым словам с дедупликацией, фильтрацией по цене и пометкой подозрительных объявлений (объявления с доставкой)

get_listing

–

Полная информация об объявлении: описание, состояние, цена, изображения, просмотры, избранное, продавец, доставка

get_seller

–

Профиль продавца по id или веб-слагу: рейтинг (0–100), количество проданных/опубликованных товаров, дата регистрации, местоположение

list_categories

–

Дерево категорий маркетплейса с id

server_status

–

Статус здоровья / авторизации / браузерного запасного варианта

favorite_listing / unfavorite_listing

требуется

Избранное по числовому id, веб-слагу или URL объявления (API + браузерный запасной вариант)

get_saved_searches / create_saved_search / delete_saved_search

требуется

Оповещения о сохранённых поисках

list_conversations

требуется

Входящие чата: другой пользователь, товар, количество непрочитанных, последнее сообщение

get_messages

требуется

Полная история сообщений беседы

send_message

требуется

Отправить сообщение в чат (канал реального времени)

make_offer

требуется

Отправить предложение о покупке (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)

Переменная

Назначение

WALLAPOP_EMAIL / WALLAPOP_PASSWORD

Включает инструменты с авторизацией (избранное, сохранённые поиски, чат, предложения)

WALLAPOP_COOKIES_FILE

Опциональный JSON-массив cookie браузера ([{ name, value }]), экспортированных из авторизованной сессии — самый надёжный путь с авторизацией

WALLAPOP_DEFAULT_LAT / LNG / DISTANCE_KM

Местоположение поиска по умолчанию (центр Барселоны)

WALLAPOP_SESSION_FILE

Сохранение токена/cookie (по умолчанию ./wallapop-session.json, в gitignore)

WALLAPOP_RATE_DELAY_MS

Минимальная задержка между вызовами API (по умолчанию 600)

WALLAPOP_MAX_RESULTS

Ограничение результатов поиска, 1–200 (по умолчанию 200)

WALLAPOP_BROWSER

auto (по умолчанию) | chrome | msedge | chromium | off

Примечание: WALLAPOP_EMAIL/WALLAPOP_PASSWORD могут не сработать для аккаунтов с MFA или Keycloak-потоками — в этом случае экспортируйте cookie из авторизованного браузера в WALLAPOP_COOKIES_FILE (JSON-массив объектов cookie), и сервер будет использовать их напрямую.

Как это работает

Поиск (двухэтапный API-поток)

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

  2. GET /api/v3/search/section (40 товаров/страница) → meta.next_page JWT; сервер упаковывает 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).

Цепочка запасных вариантов

  1. API-запрос с заголовками как у браузера, ротацией UA, экспоненциальной задержкой при 429 и повтором с X-Signature при 403

  2. Скрейпинг SSR HTML (es.wallapop.com/item/..., /user/...) — более богатые данные для продавцов (рейтинги, счётчики)

  3. Невидимый 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 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