Marktplaats & 2dehands

io.github.jasp-nerd由 GitHub 帳號 jasp-nerd 發布v0.2.0更新於 Oct 26, 2026

Search Marktplaats & 2dehands (NL/BE classifieds), vet sellers, compare prices, use your account.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析商業與電商

概覽

AI 產生的概覽

搜尋 Marktplaats.nl 與 2dehands.be 二手商品刊登、查核賣家、比較價格，登入後還能管理訊息、出價與收藏。

可以做什麼
  • 依分類、屬性、價格、狀況、距離與上架時間篩選並搜尋商品，查看完整廣告內容
  • 瀏覽分類樹以及各分類可用的篩選條件
  • 查看賣家信任訊號及其目前販售的所有商品
  • 以無狀態游標監控新上架商品，並統計某次搜尋的價格分布
  • 登入後：讀取收件匣與訊息串，列出自己的廣告、收藏、出價與已儲存的搜尋
  • 登入後：傳送訊息、聯絡賣家、出價、設定收藏以及續刊自己的廣告
適用情境
適合在荷蘭或比利時二手平台找東西時使用：讓助理篩選結果、判斷價格是否合理、查核賣家是否可信，或持續留意新廣告。若也想在聊天用戶端處理訊息與出價，則需要帳號相關工具。
執行需求
可使用託管的唯讀端點，或以 uvx 在本機執行（需 Python 3.10 以上）。搜尋、詳情、賣家查核、篩選、價格統計與監控不需要 API 金鑰或帳號。帳號工具需透過登入指令匯入工作階段，或設定 MARKTPLAATS_COOKIE / TWEEDEHANDS_COOKIE；macOS 上終端機可能需要「完整磁碟存取權」才能讀取瀏覽器 Cookie。
安裝前請注意
帳號工具會操作真實的平台帳號：訊息、報價與出價在確認後即送出，而出價具約束力，誤確認會造成實際支出。工作階段 Cookie 是可存取帳號的憑證，會存放在本機工作階段檔案或 Cookie 環境變數中。廣告文字與訊息由其他使用者撰寫，應視為不可信資料。此服務依賴未公開的平台介面，可能隨時變動。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Marktplaats & 2dehands，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.jasp-nerd%2Fmarktplaats-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "marktplaats-2dehands": {
      "type": "http",
      "url": "https://marktplaats-mcp.jaspnerd.dev/mcp"
    }
  }
}

README

[marktplaats-mcp: search Marktplaats and 2dehands from any AI agent]

English | Nederlands | Français

marktplaats-mcp: the Marktplaats & 2dehands MCP server

marktplaats-mcp is an MCP server for Marktplaats.nl (Netherlands) and 2dehands.be (Belgium), the Dutch and Belgian second-hand classifieds (tweedehands, petites annonces d'occasion). Search listings, filter on category attributes, vet sellers, compare prices and watch for new ads from Claude, ChatGPT, Cursor, Codex, Gemini or any other MCP client. With your own login it also reads and sends messages, places bids and manages your favorites and ads. No API key.

[PyPI version] [Python versions] [License: MIT] [CI] [Live API canary] [Downloads] [MCP registry]

🚀 Get started

No install: paste a URL. The hosted, read-only server runs at https://marktplaats-mcp.jaspnerd.dev/mcp. Add it as a custom connector in claude.ai (Settings → Connectors, works on the Free plan and mobile), ChatGPT, Mistral Le Chat, Perplexity or the Gemini app.

Claude Code: one command.

bash
claude mcp add --scope user marktplaats -- uvx marktplaats-mcp

Any other client. Install uv (brew install uv, or winget install --id=astral-sh.uv -e on Windows), then add the standard MCP config:

json
{ "mcpServers": { "marktplaats": { "command": "uvx", "args": ["marktplaats-mcp"] } } }

One click: [Add to Cursor] [Install in VS Code] [Add to LM Studio] [Add to Kiro]

Step-by-step instructions for 40 clients (Cursor, VS Code, Codex, Gemini CLI, Cline, Windsurf, JetBrains, Zed, opencode, Goose, ...), with the config path per OS and a link to each client's official guide: docs/clients.md.

Then ask: "Find a racefiets under €500 within 25 km of 1011 AB, frame 57-61 cm, and tell me if the sellers look legit."

[marktplaats-mcp trailer: an AI agent searches for a racefiets and vets the seller, rendered as a retro CRT terminal session]

👤 Use your own account (messages, favorites, bids, your ads)

Marktplaats has no public API and its login uses SMS two-factor authentication, so this server never asks for your password. It copies the session from a browser you are already logged into:

bash
uvx --from 'marktplaats-mcp[login]' marktplaats-mcp login

The session is stored in ~/.config/marktplaats-mcp/session.json, readable by your user only. Restart your MCP client and the account tools appear.

bash
marktplaats-mcp login --site 2dehands  # also import your 2dehands.be sessionmarktplaats-mcp login --read-only      # never send, bid or change favoritesmarktplaats-mcp login --window         # open a browser window and log in there insteadmarktplaats-mcp login --paste          # paste a Cookie header from DevTools insteadmarktplaats-mcp status                 # is the stored session still valid?marktplaats-mcp logout                 # delete it
If login says it could not read your browser's cookies
  • macOS: the system blocks command-line tools from reading browser data and does not ask. Once, open System Settings → Privacy & Security → Full Disk Access, add the terminal app you use (Terminal, iTerm, Warp, or VS Code), then quit and reopen it. Then run the login command again.
  • Windows: Chrome and Edge lock their cookie file while they run; the tool copies it first, so this normally just works. If it doesn't, close the browser and run the login again, or use --paste.
  • Linux: Chromium browsers store the cookie key in your keyring (GNOME Keyring or KWallet), which must be unlocked; Firefox needs nothing. Snap or Flatpak browsers keep their profile elsewhere, so use --paste there.
  • Everywhere: marktplaats-mcp login --paste never needs permissions. In your browser on marktplaats.nl press F12 → Network, click any request, copy the Cookie request header and paste it.

Or set MARKTPLAATS_COOKIE / TWEEDEHANDS_COOKIE (the request Cookie header) in your client's config. Sessions last weeks; when one expires the tools tell you to log in again.

Sending, contacting a seller and bidding return a preview first and only act when called again with confirm=true. Bids are binding on Marktplaats; the tool refuses bids below the minimum. Automated ad placement is forbidden by Marktplaats' terms and deliberately not implemented. See Safety model.

🧰 Tools

ToolWhat it doesAccountWrites
search_listingsSearch with query, category, subcategory, category-specific attributes, price range, condition, delivery (pickup/shipping), distance from a postcode, recency, negative keywords, sorting and pagination
get_listing_detailsFull ad: description, attributes, status (active/closed), exact listing time, view and favorite counts, bidding state and minimum bid, shipping, images, seller response rate and account age. Accepts pasted URLs
get_seller_profileTrust signals: verified bank account, identity, phone, business verification, payment method, review score and count, lowest bid the seller accepts
list_seller_listingsEverything one seller has on offer: spot dealers posing as private sellers and duplicate ads
list_categoriesThe category tree (names and ids) used for filtering, also available as an MCP resource
list_category_filtersDiscover the filters for a category (brand, frame height, mileage, fuel, RAM, ...) with their valid values and counts
check_new_listingsNewest-first monitoring with a stateless cursor: returns only ads placed after since, never skips one
analyze_pricesMedian, quartiles, min, max and mean asking prices for a search, plus the cheapest matches
get_my_accountSession check, unread messages and notifications✅
list_conversations, get_conversationYour inbox and full message threads✅
list_my_listings, list_favorites, list_my_bids, list_saved_searchesYour ads (views, favorites, highest bid, expiry), favorites, bids and saved searches✅
send_message, contact_sellerReply in a thread, or ask a seller a question or make a non-binding offer. Preview first, confirm=true to send✅✅
place_bidBid on a listing. Preview first, refuses bids below the minimum, marked destructive✅✅
set_favorite, extend_my_listingSave/unsave a listing; renew one of your expiring ads✅✅

Read-only tools carry the matching MCP annotations, so clients skip confirmation prompts for them and ask for the write tools. Every tool returns structured output with a real schema. Two prompts, bargain_hunt and vet_listing, encode the common workflows.

What you can say, and what happens

You sayThe agent calls
"Is €450 a fair price for an iPhone 15 128 GB in good condition?"analyze_prices → median, quartiles and the three cheapest ads
"Find a used Golf, 2018-2022, under 100,000 km, petrol, from a private seller"list_category_filters("Auto's") → search_listings(attributes={"Bouwjaar": "2018-2022", "Kilometerstand": "-100000", "Brandstof": "Benzine", "Adverteerder": "Particulier"})
"Is this seller trustworthy? What else are they selling?"get_listing_details → get_seller_profile → list_seller_listings
"Tell me when new bakfiets ads appear near Antwerp"check_new_listings(site="2dehands", postcode="2000", distance_km=25) with the returned cursor on every poll
"Ask the seller whether it's still available and offer €120"contact_seller(..., offer_euros=120) preview → you confirm → sent
"Reply to Piet that I can pick it up Saturday"list_conversations → send_message preview → you confirm → sent

🔒 Safety model

  • No credentials by default. Searching, details, seller checks, filters, price statistics and monitoring need no account.
  • Your session stays yours. The local server reads the cookie from your browser or a file only you can read, sends it only to marktplaats.nl / 2dehands.be, and never logs it. The hosted endpoint refuses to start with account credentials configured.
  • Writes are explicit. Sending and bidding preview first and require confirm=true; bids below the minimum are refused; login --read-only or MARKTPLAATS_READ_ONLY=1 disables writes entirely; every confirmed write is logged locally.
  • Untrusted content is labelled. Listing text and messages are written by other users; the server tells the model to treat them as data, never as instructions.
  • Polite to the marketplace. Requests are spaced (MARKTPLAATS_MIN_INTERVAL_MS, default 200), retried with backoff and Retry-After, and search pages are cached for a minute. The hosted endpoint is rate-limited per client and globally.
  • No affiliate links, no tracking. Listing URLs are returned exactly as the marketplaces publish them.

❓ FAQ

Is there an MCP server for Marktplaats?

Yes, this one. Free, open source (MIT), no API key. Paste the hosted URL into claude.ai or run uvx marktplaats-mcp.

Does it work with 2dehands.be and Belgium?

Yes. Every tool takes site="2dehands", and language="nl" or "fr" narrows Belgian results to one language.

Do I need a Marktplaats account or API key?

No. Only the account tools need your own login, and they use your existing browser session rather than a password.

Can AI read and send my Marktplaats messages, or place bids?

Yes, with the local server after marktplaats-mcp login. Sending and bidding show a preview and only act after you confirm.

Where are my login credentials stored?

In ~/.config/marktplaats-mcp/session.json on your machine, readable by your user only, or in the environment variables you set yourself. They are only ever sent to marktplaats.nl / 2dehands.be. marktplaats-mcp logout removes them.

Can I use it without installing anything?

Yes: the hosted endpoint https://marktplaats-mcp.jaspnerd.dev/mcp works in claude.ai, including the Free plan and mobile apps. It offers the read-only tools.

Does it work with ChatGPT, Cursor, Gemini, VS Code and Cline?

Yes. See docs/clients.md for step-by-step instructions per client. Any client that runs stdio servers can use uvx marktplaats-mcp; clients that support remote servers can use the hosted URL.

Is this official or affiliated with Marktplaats?

No. It is an independent open source project with no ties to Marktplaats, 2dehands or Adevinta. It uses the same public JSON endpoints the websites use; that API is undocumented and may change, which is why a live canary runs every day.

Why do I sometimes see fewer results than the limit, or total_count looks high?

Paid promotions (DAGTOPPER, TOPADVERTENTIE) are filtered out by default; pass include_sponsored=true to see them. total_count is the marketplace's raw count before that filtering.

Which Python versions are supported?

3.10 and up. CI tests 3.11 through 3.13 on Linux, macOS and Windows.

📚 Docs

🗺️ Roadmap

  • Cross-site search (NL and BE in one call)
  • Saved-search creation from the agent
  • Claude Desktop extension bundle (MCPB)

🤝 Contributing

PRs welcome. See CONTRIBUTING.md for the dev setup: uv sync --all-groups, then uv run pytest. uv run python scripts/e2e_smoke.py runs the live canary.

This project reuses proven ideas from marktplaats-py, marktplaats-monitor, marktplaats-2dehands-mcp and PonClick/marktplaats-mcp. Details in THIRD_PARTY_NOTICES.md.

If this saved you a trip to Marktplaats, a star helps other people find it.

📄 License

MIT © 2026 jasp-nerd

mcp-name: io.github.jasp-nerd/marktplaats-mcp

來源：README.md，提交 41e0558

工具

8

search_listings

Search listings

Search second-hand listings on Marktplaats or 2dehands with filters for category, category-specific attributes, price range, condition, delivery, recency and distance from a postal code. Paid promotions are filtered out unless include_sponsored is set.

輸入參數sitelimitqueryoffsetcompactexcludesort_bycategorydeliverylanguagepostcodeprice_to另有 9 個

get_listing_details

Get listing details

Fetch the full advertisement: complete description, attributes, status (active/closed), exact listing time, view and favorite counts, bidding state, shipping, images, and seller signals such as response rate and account age.

輸入參數sitelisting_id必填max_images

get_seller_profile

Get seller profile

Look up a seller's trust signals: verified bank account / identity / phone number, business verification, payment method, review score and count. Null means the marketplace does not report that signal. Use list_seller_listings to see everything the seller currently offers.

輸入參數siteseller_id必填

list_seller_listings

List a seller's listings

Everything one seller currently has on offer. Useful to spot dealers posing as private sellers, duplicate or suspicious ads, and bundle deals.

輸入參數sitelimitqueryoffsetcompactsort_byseller_id必填sort_order

list_categories

List categories

Browse the category tree (shared by marktplaats.nl and 2dehands.be) to find names/ids for search_listings' category and subcategory filters.

輸入參數parent

list_category_filters

List category filters

Discover the filters available for a category or search (brand, frame height, mileage, fuel, RAM, ...), with their valid values and how many ads match each. Pass the labels to search_listings' 'attributes' parameter.

輸入參數sitequerycategorymax_optionssubcategory

check_new_listings

Check new listings

Poll for listings placed after a given moment (newest first, paid promotions filtered out). Stateless: store the returned 'cursor' and pass it as 'since' on the next call. When the result is truncated the cursor only advances to the oldest ad returned, so nothing is ever skipped.

輸入參數sitelimitquerysinceexcludecategorydeliverylanguagepostcodeprice_toconditionattributes另有 3 個

analyze_prices

Analyze prices

Price statistics (min, quartiles, median, max, mean) over the most relevant asking prices for a search, plus the cheapest matches. Free, bidding-only and reserved ads are excluded and outliers beyond 1.5x the interquartile range are trimmed. Most reliable with a subcategory plus attributes (e.g. subcategory 'Mobiele telefoons | Apple iPhone', attributes {'Model': 'iPhone 15', 'Opslagcapaciteit': '128 GB'}) instead of free text, which drags in accessories.

輸入參數sitequery必填excludecategorydeliverylanguagepostcodeprice_toconditionattributesprice_fromdistance_km另有 2 個

版本歷史

2
  1. v0.2.0最新Sep 20, 2026
  2. v0.1.1Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分