Sverige Begagnad

io.github.tudorgrigoriu90Published by GitHub account tudorgrigoriu90v0.3.1Updated Oct 24, 2026

Search Swedish second-hand marketplaces (Blocket, Tradera, Klaravik, Vinted) for used items.

Overview

AI-generated overview

Searches Swedish second-hand marketplaces (Blocket, Tradera, Klaravik, Vinted) so an assistant can find used items, prices and locations.

What you can do
  • Search Blocket listings by query, category and region, with coordinates and distance per result
  • Search Tradera by query, category, price range and county
  • Search Klaravik auctions and Vinted fashion listings
  • Run one combined search across Blocket, Tradera, Klaravik and Vinted
  • List valid Blocket categories and regions, and Tradera categories and counties
  • Ping every source with a health check to see which still return data
When to use it
Useful when you hunt for used goods in Sweden — furniture, tools, audio gear, bikes, fashion — and want the assistant to sweep several marketplaces at once, filter by price and area, and return titles, prices, locations and links.
Requirements
Runs locally over stdio, typically via uvx from PyPI (uv required) or from source with Python. Needs a free Tradera registration: TRADERA_APP_ID and TRADERA_APP_KEY. Optional BLOCKET_LOCATIONS sets default regions. Network access to the marketplace endpoints is required; Blocket needs no credentials.
Before you install
TRADERA_APP_KEY is a secret and must be supplied by you; every user runs their own copy with their own keys. Blocket, Klaravik and Vinted access is unofficial and may break or be blocked, and Vinted works best from a residential IP. Facebook Marketplace is disabled because scraping it violates its terms. Results are listings only; buying, bidding and payments happen outside the server.

Installation

In SourceWeft

  1. Open Sverige Begagnad in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

🇸🇪 Sverige Begagnad MCP

Find quality second-hand deals across Sweden — straight from your AI assistant.

An MCP server that lets Claude (or any MCP client) search Blocket, Tradera, Klaravik, and Vinted (plus optional local Facebook Marketplace) for used items worth buying, restoring, and reselling.

[PyPI] [MCP Registry] [License: MIT] [Python 3.10+] [Tradera API v4] [Blocket]


💬 What you can ask Claude

Once connected, just talk to it:

🪑 "Find String shelves (String hylla) near Växjö under 1000 SEK."

🛠️ "Search Blocket and Tradera for Festool or Makita tools I could flip for profit."

🔊 "What Bang & Olufsen speakers are on Tradera between 500 and 3000 SEK?"

🚲 "List Blocket categories, then look for quality bikes (Kronan, Crescent) in Skåne."

📈 "Do this week's sourcing sweep for Scandinavian design in Kronoberg and neighbouring counties, ranked by estimated profit."

Claude picks the right tools, applies your filters, and hands back titles, prices, locations, links, and images — from both marketplaces in one go.

✨ Features

🔎 Four marketplacesBlocket + Tradera + Klaravik + Vinted, searched together or separately, normalized into one shape
🎯 Rich filtersPrice min/max, category, county (Tradera) · region + category (Blocket)
📍 Location-awareEvery Blocket result carries coordinates + distance for precise radius filtering
🌍 General by defaultSearches all of Sweden; scope it to your area via config or per-search
🧭 Discovery toolsList categories, regions, and counties so the agent filters intelligently
🧩 Easy installOne-command Claude Code plugin, uvx, or from source — each user brings their own keys
✅ Tested liveEvery source verified end-to-end against the real APIs

📊 Source status

SourceMethodStability
TraderaOfficial REST API (v4)🟢 Solid — tested live; requires free registration
BlocketCommunity package (blocket-api)🟡 Semi-stable, unofficial — tested live
KlaravikInternal JSON endpoint🟡 Unofficial — tested live; auction current-bid prices
VintedInternal API (bot-protected)🟠 Unofficial, most fragile — works best from a residential IP
Facebook MarketplaceDisabled by default🔴 Risky, local-only — see facebook_client.py

🔑 Get Tradera credentials (required for all install methods)

  1. Register (free) at https://api.tradera.com/register.
  2. Accept the Terms of Use + Logo Terms of Use.
  3. Create an application and copy the numeric App ID and the App Key (GUID secret). You'll supply these as TRADERA_APP_ID / TRADERA_APP_KEY.

Blocket needs no credentials. Facebook Marketplace is off by default.

📦 Installation

Every user runs their own copy with their own Tradera keys — pick whichever method fits your client. uvx-based methods need uv installed (curl -LsSf https://astral.sh/uv/install.sh | sh, or winget install astral-sh.uv on Windows) — no cloning or virtualenv needed.

Option 1 — Claude Code plugin (easiest)

bash
claude plugin marketplace add tudorgrigoriu90/sverige-begagnad-mcpclaude plugin install sverige-begagnad@sverige-begagnad-marketplace

Then export your keys (the plugin passes them through to the server):

bash
export TRADERA_APP_ID=...      # Windows PowerShell: $env:TRADERA_APP_ID="..."export TRADERA_APP_KEY=...export BLOCKET_LOCATIONS=      # optional; empty = all of Sweden

Restart Claude Code — you'll have search_blocket, search_tradera, search_all, and more. The plugin runs the server via uvx straight from GitHub.

Option 2 — uvx (Claude Desktop or any MCP client)

Add to your client's MCP config (Claude Desktop: Settings → Developer → Edit Config):

json
{  "mcpServers": {    "sverige-begagnad": {      "command": "uvx",      "args": ["sverige-begagnad-mcp"],      "env": {        "TRADERA_APP_ID": "...",        "TRADERA_APP_KEY": "...",        "BLOCKET_LOCATIONS": ""      }    }  }}

uvx fetches the published package from PyPI on first run and caches it. Restart the client.

Option 3 — From source (development)

bash
git clone https://github.com/tudorgrigoriu90/sverige-begagnad-mcpcd sverige-begagnad-mcppython -m venv .venvsource .venv/bin/activate   # Windows: .venv\Scripts\activatepip install -e .cp .env.example .env        # then fill in your keys

Point your client at the venv's sverige-begagnad-mcp command (or python -m sverige_begagnad_mcp.server) with cwd set to the repo.

✅ Verify it works (optional)

From a source checkout with keys set (in .env or the environment):

bash
# Tradera — official REST API v4 (https://api.tradera.com/v4, header auth)python -m sverige_begagnad_mcp.tradera_client
# Blocket — unofficial community APIpython -c "import asyncio; from sverige_begagnad_mcp.blocket_client import search_blocket; print(asyncio.run(search_blocket('String hylla')))"

Both are tested live. If Tradera's shape ever drifts, the OpenAPI spec is at https://api.tradera.com/openapi.json.


🧰 Tools

ToolPurpose
search_blocket(query, category?, locations?, max_pages?)Search Blocket
list_blocket_categories()Valid category names
list_blocket_locations()Valid region (län) names
search_tradera(query, category_id?, price_min?, price_max?, county_id?)Search Tradera
list_tradera_categories()Category tree → category_id
list_tradera_counties()County ids for the optional county_id filter
search_klaravik(query)Search Klaravik auctions (current-bid prices)
search_vinted(query, price_min?, price_max?)Search Vinted fashion listings
search_facebook_marketplace(...)Disabled by default (local-only)
search_all(query, blocket_category?, blocket_locations?, tradera_category_id?, price_min?, price_max?)Blocket + Tradera + Klaravik + Vinted in one call
health_check()Ping every source and report which are still fetching data

📍 Geographic scope

Searches default to all of Sweden. Three ways to set the area, in order of precedence:

  1. Per-search — pass locations to search_blocket (or blocket_locations to search_all), e.g. ["KRONOBERG", "KALMAR"]. Use list_blocket_locations() for valid names.
  2. A personal default — set BLOCKET_LOCATIONS in .env to a comma-separated list of region names.
  3. Nothing set — all of Sweden.

Blocket's filter is regional (län), not a precise km radius. For a tight "within X min drive" filter, let Claude do the final check per listing — each result includes the ad's text location plus coordinates (lat/lon) and Blocket's own distance. Tradera is national with shipping, so it has no radius concept (there's an optional county_id filter, rarely needed).

🗺️ Example: my own Växjö / Älmhult setup

Personal scope lives only in .env (gitignored — not a shipped default):

dotenv
BLOCKET_LOCATIONS=KRONOBERG,KALMAR,JONKOPING,HALLAND,SKANE
🤖 Power user: a full weekly "sourcing agent" prompt

Paste this as your instructions to turn the tools into a profit-ranked weekly sweep. It runs many targeted Swedish searches, filters by radius/quality, estimates profit, and returns a ranked shortlist. Tune the brands, region, and thresholds to taste.

text
ROLE: You are a sourcing assistant for a personal, quality-focused loppis (flip).Each week, search Blocket and Tradera for second-hand items to buy, minimallyrestore, and resell at a profit.
METHOD: Search with SWEDISH terms. Run MANY targeted searches — by BRAND and byCATEGORY — across both sources; deduplicate. Prices are in SEK.
AREA: within ~35 km straight-line of Växjö (56.88, 14.81) or Älmhult (56.55, 14.14),computed from each Blocket result's `coordinates`. Tradera ships nationally, soinclude shippable Tradera items too.
QUALITY: recognized brand or top craftsmanship (String, Artek, Fritz Hansen, LouisPoulsen, Iittala, Orrefors, Bang & Olufsen, Braun, Marantz, Bahco, Hilti, Festool,Makita, Kronan, Crescent…); "bra skick"/"nyskick" or minor cosmetic wear; askingprice clearly below market; only minimal restoration (clean, polish, light sand,small off-the-shelf parts).
PROFIT: estimate resale value (use web search for comparables if available — do NOTinvent sold prices). Net = resale − (purchase + restoration + pickup/courier), withstated assumptions (~80 SEK pickup fuel, ~70 SEK courier, 0–150 SEK materials).Include only items with estimated net profit ≥ 300 SEK. Note that Tradera auctionprices may rise before close.
OUTPUT: ranked by net profit descending, max 15. For each: title + link + location(distance from Växjö or "ships nationally"), asking vs. estimated market price, netprofit with assumptions, 2–3 restoration steps, and a risk note. End with a 2–3sentence read on the week's trends. Don't pad with weak candidates.

🚫 Facebook Marketplace — why it's disabled

There is no public API for Facebook Marketplace. The only known methods (session cookies or headless-browser scraping) explicitly violate Facebook's Terms of Service. The src/sverige_begagnad_mcp/facebook_client.py module is intentionally left as a stub, with an explanation of how you could implement it yourself, at your own risk.

🛠️ Maintenance & publishing

Maintainer notes
  • If a source breaks: Blocket → check https://pypi.org/project/blocket-api/ for a newer version; Tradera → the OpenAPI spec at https://api.tradera.com/openapi.json.
  • PyPI (enables the short uvx sverige-begagnad-mcp): python -m build then twine upload dist/*. Bump version in pyproject.toml and src/sverige_begagnad_mcp/__init__.py first.
  • Plugin marketplace: the .claude-plugin/marketplace.json + plugins/ dirs make this repo itself the marketplace — no extra hosting.
  • MCP Registry: server.json is ready; publish with the mcp-publisher CLI after the PyPI release (see the Registry publishing guide).

📄 License

MIT — each user runs their own copy with their own credentials. Note that Blocket has no official API; this uses an unofficial community package, so treat the Blocket half accordingly.

Source: README.md at commit cc182c3

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts