blocket-cli 0.1.0

Fast CLI for searching Blocket.se — optimized for agents and scripting

blocket-cli

Fast CLI for searching Blocket.se — Sweden's largest marketplace.

Designed for agents, scripts, and quick terminal lookups. Minimal dependencies, structured output.

Install

pip install blocket-cli

Or with uv:

uv tool install blocket-cli

Usage

Search listings

blocket search "soffa"
blocket search "iphone 15" -l stockholm --price-max 8000
blocket search "mountainbike" -c sports --sort price-asc -n 10
blocket search "ps5" -c electronics -o json | jq '.results[:3]'

Get ad details

blocket ad 20851738
blocket ad 20851738 -o json

Browse filters

blocket categories
blocket locations

Output formats

Flag	Format	Use case
(default)	Human-readable table	Terminal browsing
-o json	Compact JSON	Piping to jq, API consumption
-o jsonl	One JSON object per line	Streaming, log processing

Search options

Option	Description
-l, --location	Filter by Swedish county (e.g. stockholm, skane)
-c, --category	Filter by category (e.g. electronics, furniture)
--price-min	Minimum price in SEK
--price-max	Maximum price in SEK
--sort	Sort order (relevance, price-asc, price-desc, date)
-n, --limit	Max results to display
-p, --page	Page number
-o, --output	Output format (table, json, jsonl)

Agent integration

The JSON output is designed for LLM agents and automation:

# Structured search results
blocket search "cykel" -l stockholm --price-max 5000 -o json

# Stream results line by line
blocket search "soffa" -o jsonl

# Filter by category
blocket search "lampa" -c furniture -o json | jq '[.results[] | {title: .heading, price: .price.amount, location}]'

License

MIT