Skip to main content
Glama
Wallapop MCP Server

Wallapop MCP Server

by AdeiTamayo

Wallapop MCP Server

Wallapop マーケットプレイス向けのハイブリッド型・非公式 MCP サーバー。TypeScript で構築されています。

  • HTTP プライマリ: 非公開の api.wallapop.com v3 エンドポイントへのリバースエンジニアリングによる呼び出し

  • SSR フォールバック: es.wallapop.com ページの __NEXT_DATA__ スクレイピング(商品詳細、出品者プロフィール)

  • Playwright フォールバック: 最終手段としてオフスクリーンのヘッド付きブラウザを使用(Wallapop の CDN がヘッドレス Chrome をブロックするため)

  • 認証: お気に入り、保存した検索、チャット、オファー用に、任意のメールアドレス/パスワードまたはブラウザ Cookie のインポート(トークン更新 + セッション永続化)

非公式であり、Wallapop とは無関係です。Wallapop の非公開 API を使用しています。この API はいつでも変更されたり、トラフィックをブロックしたりする可能性があります。自己責任で使用し、リクエスト量を抑え、Wallapop の利用規約を尊重してください。

ツール

ツール

認証

説明

search_products

–

カテゴリ / 価格 / 場所 / 半径 / 並び順フィルターによるキーワード検索、カーソルページネーション(nextPage)、保留中の商品は除外

scan_products

–

重複排除、価格フィルタリング、詐欺フラグ付きの複数クエリキーワードスキャン(配送可能な出品)

get_listing

–

出品の完全な詳細: 説明、状態、価格、画像、閲覧数、お気に入り数、出品者、配送情報

get_seller

–

ID または Web スラッグによる出品者プロフィール: 評価(0〜100)、販売数/公開数、登録日、所在地

list_categories

–

ID 付きのマーケットプレイスカテゴリツリー

server_status

–

ヘルス / 認証 / ブラウザフォールバックのステータス

favorite_listing / unfavorite_listing

必須

数値 ID、Web スラッグ、または商品 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

ログイン済みセッションからエクスポートしたブラウザ Cookie の任意の JSON 配列([{ 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 フローを使用するアカウントでは失敗する可能性があります。その場合は、ログイン済みブラウザから WALLAPOP_COOKIES_FILE に Cookie をエクスポート(Cookie オブジェクトの JSON 配列)すると、サーバーはそれらを直接使用します。

仕組み

検索(2 段階 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)にも届きます。両方ともエンドツーエンドで検証済みです。

  • オファーはクライアント生成のオファー ID を使用して POST /api/v3/delivery/buyer/offers で作成され、出品者は会話内でそれを受け取ります。

認証

  • POST /api/v3/access/login を試行し、アクセス/リフレッシュトークン + Cookie をセッションファイルに保存します。JWT の有効期限が近づくと POST /api/v3/access/refresh で更新します。

  • 自動ブラウザログインにフォールバックします。MFA チャレンジは検出され、エラーとして表示されます(手動で完了させ、その後 WALLAPOP_COOKIES_FILE に Cookie をエクスポートしてください)。

フォールバックチェーン

  1. ブラウザ風ヘッダー、UA ローテーション、429 での指数バックオフ、403 での X-Signature リトライを使用した API リクエスト

  2. SSR HTML スクレイピング(es.wallapop.com/item/...、/user/...)— 出品者にとってより豊富なデータ(評価、カウンター)

  3. Playwright 経由のオフスクリーンのヘッド付き Chrome(api.wallapop.com の XHR レスポンスをキャプチャ)— Wallapop の CDN がヘッドレスモードをブロックするため、手動でブラウザをダウンロードせずに WALLAPOP_BROWSER=chromium を使用しないでください。auto はインストール済みの Chrome/Edge を優先します。

注意点と既知の制限

  • search_products の価格フィルタリング(minPrice/maxPrice)と半径フィルタリング(distance_in_km)は API 側のパラメータです。

  • favorite_listing/unfavorite_listing はベストエフォートのエンドポイント候補を使用します。自分のアカウントで検証してください。エンドポイントは変更される可能性があります。

  • 商品の 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