Sverige Begagnad

Ping every marketplace source (Blocket, Tradera, Klaravik, Vinted, and Facebook if enabled) with a canned query and report whether each is still fetching data. USE this to verify the server works end-to-end — e.g. from a scheduled monitor — before relying on a sourcing sweep. Do NOT use it to search for items (use search_all or a per-source tool). Takes no arguments. Returns {healthy: bool, unhealthy_sources: [names], sources: {name: {ok, count, latency_ms, error}}}. A source is `ok` when it returns without error AND finds >0 results; Facebook shows status 'disabled' when ENABLE_FACEBOOK_SEARCH is unset (not counted as a failure).

List the valid Blocket category names accepted by search_blocket()'s `category` argument (and search_all's `blocket_category`). Call this first when you intend to filter a Blocket search by category. Takes no arguments. Returns {categories: [names]}.

List the valid Blocket region (län) names accepted by search_blocket()'s `locations` argument (and search_all's `blocket_locations`). Takes no arguments. Returns {locations: [names]}.

Fetch Tradera's full category tree to find `category_id` values for search_tradera(). Takes no arguments. Requires Tradera credentials. Returns {categories: <nested tree>} (or {error} if credentials are missing/invalid).

Fetch Tradera's county list (id → name) for search_tradera()'s optional `county_id` filter. Takes no arguments. Rarely needed since Tradera is national. Requires Tradera credentials. Returns {counties: [...]}

One-call sweep across ALL marketplaces — Blocket + Tradera + Klaravik + Vinted (+ Facebook Marketplace if locally enabled) — returning a single combined, normalized result set. USE this for a broad sourcing sweep when you want maximum coverage in one call. Do NOT use it when you already know the single best source for a query — call that tool directly instead (faster, fewer irrelevant results). Per-source failures are non-fatal: they are reported in `source_errors` rather than raised. Price bounds apply to the Tradera and Vinted portions. Returns {query, total_results, results: [mixed listings, each with a `source` field], source_errors}.

Search Blocket.se — Sweden's largest classifieds — for used items from private sellers and dealers. Best for LOCAL deals (usually pickup): each result carries the ad's text location plus `coordinates` (lat/lon) and `distance`, so you can apply a precise radius filter yourself (Blocket's own filter is regional/län, not km). USE for local or regional finds. Do NOT use for nationwide auctions (use search_tradera or search_klaravik), for second-hand fashion (use search_vinted), or when you want every source at once (use search_all). Returns {ads: [normalized listings], count, warning?}; each listing has source, id, title, price_sek, location, coordinates, distance, url, image_url.

Search Facebook Marketplace for local listings. DISABLED BY DEFAULT and LOCAL-ONLY: it uses an unofficial method that violates Facebook's Terms of Service, so it returns an explanatory 'disabled' error unless ENABLE_FACEBOOK_SEARCH=1 is set locally. When enabled, it is best for local private-seller deals; otherwise prefer search_blocket for local classifieds and search_all for a full sweep. Returns {listings: [...], count} when enabled, otherwise {error, message}.

Search Klaravik.se, a Swedish online AUCTION house — the strongest source for undervalued tools, machinery, and estate/house-clearance goods. National; lots either ship or need pickup/freight (many are heavy). `price_sek` is the current bid and CAN RISE before close. USE for tools, machinery, and bulky bargains. Do NOT use for fashion (use search_vinted) or when you specifically want private-seller classifieds (use search_blocket). Unofficial endpoint — may break if the site changes. Returns {items: [normalized listings], count, total_available}.

Search Tradera.com — Sweden's largest online auction house — via its official REST API. NATIONAL and ships anywhere; covers timed auctions and Buy-It-Now. `price_sek` is the current bid or Buy-It-Now price and CAN RISE before an auction ends. USE for nationwide, shippable finds and auctions. Do NOT use for local-pickup-only deals (use search_blocket) or for fashion (use search_vinted). Requires TRADERA_APP_ID and TRADERA_APP_KEY env vars (register free at api.tradera.com); without them it returns an error. Returns {items: [normalized listings], count, total_available}.

Search Vinted.se, a peer-to-peer second-hand FASHION marketplace — best for branded clothing, genuine leather/wool, bags, footwear, and outdoor apparel (e.g. Fjällräven, The North Face, Patagonia). National; items ship. Fixed prices: `price_sek` is the item price and `total_price_sek` includes Vinted's buyer-protection fee. USE for fashion and apparel. Do NOT use for furniture, tools, or electronics (use the other sources). Unofficial and bot-protected — the most fragile source; may occasionally be rate-limited and return an error. Returns {items: [normalized listings], count, total_available}.