allegro-cli 0.1.0

CLI for browsing Allegro offers, managing cart, and tracking packages — human-readable and LLM-agent friendly

allegro-cli

CLI for browsing Allegro offers, managing your cart, and tracking packages. Designed to be both human-readable and LLM-agent friendly.

All output is available as aligned text tables, JSON, or TSV — pick what suits your workflow or pipe it into other tools.

Install

From GitHub Releases (recommended):

pip install https://github.com/pkonowrocki/allegro-cli/releases/latest/download/allegro_cli-0.1.0-py3-none-any.whl

From source (latest):

pip install git+https://github.com/pkonowrocki/allegro-cli.git

For development:

git clone https://github.com/pkonowrocki/allegro-cli.git
cd allegro-cli
pip install -e ".[dev]"

Setup

Import cookies from your browser:

allegro login

Paste cookies from Chrome DevTools (Application > Cookies > allegro.pl). Both the DevTools table format and raw cookie header strings are accepted.

Alternatively, set cookies directly:

allegro config set --cookies 'cookie1=value1; cookie2=value2'

Usage

Search

allegro search "laptop"
allegro search "laptop" --category 491
allegro search "laptop" --category laptopy-491 --sort pd --price-min 2000 --price-max 5000
allegro search "laptop" --columns "id,name,sellingMode.price.amount,parameters"

Flag	Description
--category	Category ID or slug (e.g. 491, laptopy-491)
--sort	Sort order: p (price asc), pd (price desc), m (relevance), n (newest)
--price-min	Minimum price in PLN
--price-max	Maximum price in PLN
--page	Page number (default: 1)
--columns	Comma-separated columns to display

Offer details

allegro offer 12345678
allegro offer 12345678 --columns "name,sellingMode.price.amount,parameters"

Offer pages include a parameters field with product specifications (e.g. processor, RAM, screen size) extracted automatically from the listing.

Cart

allegro cart list
allegro cart add OFFER_ID SELLER_ID --quantity 2
allegro cart remove OFFER_ID SELLER_ID

Packages

allegro packages

Configuration

allegro config show
allegro config set --output-format json
allegro config set --flaresolverr-url http://localhost:8191/v1

Output formats

All commands support --format text (default), --format json, and --format tsv.

allegro search "laptop" --format json     # full JSON array
allegro search "laptop" --format tsv      # tab-separated, pipe-friendly
allegro search "laptop"                   # aligned text table (default)
allegro offer 12345678 --format json      # full offer with parameters

Use --columns to select specific fields (dot-notation supported):

allegro search "laptop" --columns "id,name,sellingMode.price.amount"
allegro offer 12345678 --columns "name,parameters"

Set a persistent default:

allegro config set --output-format json

Anti-bot handling

Allegro uses anti-bot protection (DataDome). The CLI first tries a direct request with your cookies via curl_cffi (Chrome TLS fingerprint). If that gets a 403, it falls back to FlareSolverr:

docker run -d --name flaresolverr -p 8191:8191 ghcr.io/flaresolverr/flaresolverr:latest

Development

pip install -e ".[dev]"
pytest