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 キーを使って各自のコピーを実行します。利用するクライアントに合った方法を選んでください。 uv をインストール済みの場合は、uvx ベースの方法を利用できます （curl -LsSf https://astral.sh/uv/install.sh | sh、または Windows では 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 などを利用できます。このプラグインは、GitHub から uvx 経由でサーバーを直接実行します。

オプション 2 — uvx（Claude Desktop または任意の MCP クライアント）

クライアントの MCP 設定に追加します（Claude Desktop の場合：Settings → Developer → Edit Config）。

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

🧰 ツール

📍 地理的な検索範囲

検索範囲はデフォルトでスウェーデン全土です。範囲は次の 3 つの方法で指定でき、優先順位は記載順です。

1. 検索ごとに指定 — search_blocket に locations（または search_all に blocket_locations）を渡します。例：["KRONOBERG", "KALMAR"]。有効な名前は list_blocket_locations() で確認できます。
2. 個人用のデフォルト値 — .env の BLOCKET_LOCATIONS に、カンマ区切りで地域名を設定します。
3. 未設定の場合 — スウェーデン全土。

Blocket のフィルターは地域（län）単位で、正確な距離（km）を指定するものではありません。 「車で 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 関連の部分はその点を踏まえてご利用ください。