🇸🇪 Sverige Begagnad MCP

💬 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

📊 Source status

🔑 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 methodfits your client. uvx-based methods need uvinstalled (curl -LsSf https://astral.sh/uv/install.sh | sh, orwinget install astral-sh.uv on Windows) — no cloning or virtualenv needed.

Option 1 — Claude Code plugin (easiest)

claude plugin marketplace add tudorgrigoriu90/sverige-begagnad-mcp
claude plugin install sverige-begagnad@sverige-begagnad-marketplace

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

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):

{
  "mcpServers": {
    "sverige-begagnad": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/tudorgrigoriu90/sverige-begagnad-mcp", "sverige-begagnad-mcp"],
      "env": {
        "TRADERA_APP_ID": "...",
        "TRADERA_APP_KEY": "...",
        "BLOCKET_LOCATIONS": ""
      }
    }
  }
}

Once published to PyPI, the args simplify to just ["sverige-begagnad-mcp"]. Restart the client.

Option 3 — From source (development)

git clone https://github.com/tudorgrigoriu90/sverige-begagnad-mcp
cd sverige-begagnad-mcp
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .
cp .env.example .env        # then fill in your keys

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

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

# Tradera — official REST API v4 (https://api.tradera.com/v4, header auth)
python -m sverige_begagnad_mcp.tradera_client

# Blocket — unofficial community API
python -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 athttps://api.tradera.com/openapi.json.

🧰 Tools

📍 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 tosearch_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 resultincludes the ad's text location plus coordinates (lat/lon) and Blocket's owndistance. Tradera is national with shipping, so it has no radius concept (there'san optional county_id filter, rarely needed).

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

BLOCKET_LOCATIONS=KRONOBERG,KALMAR,JONKOPING,HALLAND,SKANE

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.

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, minimally
restore, and resell at a profit.

METHOD: Search with SWEDISH terms. Run MANY targeted searches — by BRAND and by
CATEGORY — 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, so
include shippable Tradera items too.

QUALITY: recognized brand or top craftsmanship (String, Artek, Fritz Hansen, Louis
Poulsen, Iittala, Orrefors, Bang & Olufsen, Braun, Marantz, Bahco, Hilti, Festool,
Makita, Kronan, Crescent…); "bra skick"/"nyskick" or minor cosmetic wear; asking
price 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 NOT
invent sold prices). Net = resale − (purchase + restoration + pickup/courier), with
stated assumptions (~80 SEK pickup fuel, ~70 SEK courier, 0–150 SEK materials).
Include only items with estimated net profit ≥ 300 SEK. Note that Tradera auction
prices 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, net
profit with assumptions, 2–3 restoration steps, and a risk note. End with a 2–3
sentence 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 (sessioncookies or headless-browser scraping) explicitly violate Facebook's Terms of Service.The src/sverige_begagnad_mcp/facebook_client.py module is intentionally left as astub, with an explanation of how you could implement it yourself, at your own risk.

🛠️ Maintenance & publishing

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

📄 License

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