Sverige Begagnad

💬 可以向 Claude 提出什么请求

连接后，直接告诉它：

🪑 “在 Växjö 附近寻找 1000 SEK 以下的 String 搁架（String hylla）。”

🛠️ “在 Blocket 和 Tradera 上搜索 Festool 或 Makita 工具，看看哪些可以转卖获利。”

🔊 “Tradera 上有哪些价格在 500 至 3000 SEK 之间的 Bang & Olufsen 扬声器？”

🚲 “列出 Blocket 类别，然后在 Skåne 寻找优质自行车（Kronan、Crescent）。”

📈 “本周在 Kronoberg 及邻近县搜寻斯堪的纳维亚设计商品，并按预估利润排序。”

Claude 会选择合适的工具、应用你的筛选条件，并一次性返回来自两个市场的标题、价格、地点、链接和图片。

✨ 功能

📊 来源状态

🔑 获取 Tradera 凭据（所有安装方式均需要）

1. 在 https://api.tradera.com/register 免费注册。
2. 接受使用条款和徽标使用条款。
3. 创建应用并复制数字 App ID 和 App Key （GUID 密钥）。请将它们设为 TRADERA_APP_ID / TRADERA_APP_KEY。

Blocket 不需要凭据。Facebook Marketplace 默认关闭。

📦 安装

每位用户都使用自己的 Tradera 密钥运行自己的副本 — 根据你的客户端选择合适的方式。基于 uvx 的安装方式需要先安装 uv （在 Windows 上运行 curl -LsSf https://astral.sh/uv/install.sh | sh，或 winget install astral-sh.uv）— 无需克隆仓库或创建虚拟环境。

选项 1 — Claude Code 插件（最简单）

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

然后导出你的密钥（插件会将它们传递给服务）：

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

重启 Claude Code — 你将获得 search_blocket、search_tradera、search_all， 以及更多工具。该插件会通过 uvx 直接从 GitHub 运行服务。

选项 2 — uvx（Claude Desktop 或任何 MCP 客户端）

添加到客户端的 MCP 配置中（Claude Desktop：设置 → 开发者 → 编辑配置）：

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

uvx 会在首次运行时从 PyPI 获取已发布的软件包并缓存。重启客户端。

选项 3 — 从源代码运行（开发）

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

将客户端指向虚拟环境中的 sverige-begagnad-mcp 命令（或 python -m sverige_begagnad_mcp.server），并将 cwd 设为仓库目录。

# 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')))"

🧰 工具

📍 地理范围

搜索范围默认为整个瑞典。设置区域有三种方式，按优先级排序：

1. 单次搜索 — 将 locations 传给 search_blocket（或将 blocket_locations 传给 search_all），例如 ["KRONOBERG", "KALMAR"]。使用 list_blocket_locations() 获取有效名称。
2. 个人默认值 — 在 .env 中将 BLOCKET_LOCATIONS 设为以逗号分隔的地区名称列表。
3. 未设置 — 整个瑞典。

Blocket 的筛选条件基于地区（län），而不是精确的公里半径。若要严格筛选“驾车 X 分钟以内”的结果，请让 Claude 对每条商品信息进行最终检查 — 每个结果都包含广告中提到的位置，以及 coordinates（纬度/经度）和 Blocket 自身提供的 distance。Tradera 面向全国并支持配送，因此没有半径概念（可选的 county_id 筛选条件很少用到）。

BLOCKET_LOCATIONS=KRONOBERG,KALMAR,JONKOPING,HALLAND,SKANE

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 — 禁用原因

Facebook Marketplace 没有公共 API。已知的唯一方法（会话 Cookie 或无头浏览器抓取）都明确违反 Facebook 的服务条款。 src/sverige_begagnad_mcp/facebook_client.py 模块被有意保留为存根，其中解释了如何自行实现，但风险自负。

🛠️ 维护与发布

📄 许可证

MIT — 每位用户都使用自己的凭据运行自己的副本。请注意，Blocket 没有官方 API；此项目使用的是非官方社区软件包，因此请谨慎使用 Blocket 部分。