Metadata-Version: 2.5
Name: scrapebadger-cli
Version: 0.15.0
Summary: ScrapeBadger CLI — Twitter, Vinted, Google, and Web Scraping from the command line
Author: ScrapeBadger Team
License: MIT
Keywords: ai-tools,cli,mcp,scrapebadger,twitter,vinted,web-scraping
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Requires-Dist: httpx>=0.26.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.12.0
Requires-Dist: websockets>=12.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.2.0; extra == 'dev'
Description-Content-Type: text/markdown

# ScrapeBadger CLI

Command-line interface for ScrapeBadger — Twitter, Vinted, and Web Scraping.

## Install

```bash
pip install scrapebadger-cli
# or: uv tool install scrapebadger-cli
```

The installed command is `scrapebadger`. To run without installing:

```bash
uvx --from scrapebadger-cli scrapebadger --help
```

## Quick Start

```bash
scrapebadger auth --api-key sb_live_...
scrapebadger twitter user elonmusk
scrapebadger twitter search "AI agents" --output table
scrapebadger vinted search "nike shoes" --market de
scrapebadger web scrape https://example.com --js
```

## Vinted mobile data (0.14.0+)

```sh
scrapebadger vinted mobile-operations
scrapebadger vinted mobile sold-comparables --market fr --params '{"catalog_id":"1242","brand_id":"53","status_id":"2"}'
scrapebadger vinted search "nike" --sizes 206 --materials 43
```

The catalog lists 76 public read operations with parameter types and examples.
Each mobile read costs 1 credit; discovery is free. Sold comparables are a
Vinted-selected sample, not a complete sales history or guaranteed final sale prices.

### Vinted image search

```bash
scrapebadger vinted search-by-image --image photo.jpg --market nl --price-to 50
scrapebadger vinted search-by-image --image-url https://example.com/photo.webp --brand-ids 53
```

Provide exactly one of `--image`, `--image-url` or `--image-base64`. JPEG, PNG and
WebP up to 5 MiB are supported. Returns active listings in visual ranking order;
10 credits per successful request. Filter with `--catalog-ids`, `--brand-ids`,
`--status-ids`, `--color-ids`, `--size-ids`, `--material-ids` and price bounds.
Resend the same image and `--time` from pagination when requesting `--page 2`.
