Wallapop MCP Server
Wallapop MCP Server
Wallapop マーケットプレイス向けのハイブリッド型・非公式 MCP サーバー。TypeScript で構築されています。
HTTP プライマリ: 非公開の
api.wallapop.comv3 エンドポイントへのリバースエンジニアリングによる呼び出しSSR フォールバック:
es.wallapop.comページの__NEXT_DATA__スクレイピング(商品詳細、出品者プロフィール)Playwright フォールバック: 最終手段としてオフスクリーンのヘッド付きブラウザを使用(Wallapop の CDN がヘッドレス Chrome をブロックするため)
認証: お気に入り、保存した検索、チャット、オファー用に、任意のメールアドレス/パスワードまたはブラウザ Cookie のインポート(トークン更新 + セッション永続化)
非公式であり、Wallapop とは無関係です。Wallapop の非公開 API を使用しています。この API はいつでも変更されたり、トラフィックをブロックしたりする可能性があります。自己責任で使用し、リクエスト量を抑え、Wallapop の利用規約を尊重してください。
ツール
ツール | 認証 | 説明 |
| – | カテゴリ / 価格 / 場所 / 半径 / 並び順フィルターによるキーワード検索、カーソルページネーション( |
| – | 重複排除、価格フィルタリング、詐欺フラグ付きの複数クエリキーワードスキャン(配送可能な出品) |
| – | 出品の完全な詳細: 説明、状態、価格、画像、閲覧数、お気に入り数、出品者、配送情報 |
| – | ID または Web スラッグによる出品者プロフィール: 評価(0〜100)、販売数/公開数、登録日、所在地 |
| – | ID 付きのマーケットプレイスカテゴリツリー |
| – | ヘルス / 認証 / ブラウザフォールバックのステータス |
| 必須 | 数値 ID、Web スラッグ、または商品 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 APIMCP クライアントに接続する
# 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 を参照)
変数 | 目的 |
| 認証ツールを有効にする(お気に入り、保存した検索、チャット、オファー) |
| ログイン済みセッションからエクスポートしたブラウザ Cookie の任意の JSON 配列( |
| デフォルトの検索場所(バルセロナ中心部) |
| トークン/Cookie の永続化(デフォルト |
| API 呼び出し間の最小遅延(デフォルト 600) |
| 検索結果の上限、1〜200(デフォルト 200) |
|
|
注:
WALLAPOP_EMAIL/WALLAPOP_PASSWORDは、MFA または Keycloak フローを使用するアカウントでは失敗する可能性があります。その場合は、ログイン済みブラウザからWALLAPOP_COOKIES_FILEに Cookie をエクスポート(Cookie オブジェクトの JSON 配列)すると、サーバーはそれらを直接使用します。
仕組み
検索(2 段階 API フロー)
GET /api/v3/search/components→search_idGET /api/v3/search/section(40 件/ページ)→meta.next_pageJWT。サーバーは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 をエクスポートしてください)。
フォールバックチェーン
ブラウザ風ヘッダー、UA ローテーション、429 での指数バックオフ、403 での
X-Signatureリトライを使用した API リクエストSSR HTML スクレイピング(
es.wallapop.com/item/...、/user/...)— 出品者にとってより豊富なデータ(評価、カウンター)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 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-