Pp Daraz

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/commerce/daraz/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Daraz.pk — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the daraz-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install daraz --cli-only

2. Verify: daraz-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/commerce/daraz/cmd/daraz-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

daraz-pp-cli searches Daraz.pk listings, reads reviews, and extracts product detail like any scraper — then keeps it in a local SQLite store so it can do what one-shot scrapers cannot: track price history (price-history), rank genuine deals over fake discounts (deals, value), diff a saved search over time (since), and vet sellers (seller stats). Read-only, no login required.

When to Use This CLI

Use daraz-pp-cli for shopper-side Daraz.pk research: finding products, comparing prices and sellers, reading reviews, and tracking whether a price is genuinely low over time. It is ideal for agents that need structured, filterable product data and offline price intelligence from a single keyword.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to place orders, manage a cart, or checkout — it is read-only.
• Do not use it for order tracking, wishlists, or account actions that require a logged-in Daraz session.
• Do not use it for seller/merchant operations — that is the separate Daraz Open Platform.
• Do not use it for non-Pakistan marketplaces; it targets daraz.pk.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local price intelligence

• price-history — See a product's recorded price trend and its lowest-ever price from your local store.

  Reach for this to judge whether a current price is actually low for that item, not just discounted on paper.

  daraz-pp-cli price-history 599201597 --agent

• watch — Record current prices for every item matching a search into the local store so price history builds over time.

  Run periodically on a query you care about; then price-history shows the trend for any item it captured.

  daraz-pp-cli watch "gaming laptop"

• since — Diff a saved search against its last local snapshot to show new listings and price moves since you last checked.

  Use to monitor a market over time instead of re-reading a full result list each run.

  daraz-pp-cli since "gaming mouse" --agent

Smart ranking

• deals — Rank a search by a composite of discount, rating, and units sold to surface genuinely good deals.

  Use when the goal is the best-value item for a query, not raw listing order.

  daraz-pp-cli deals "laptop" --agent --select name,price,discountPct,rating

• value — Flag inflated original-price discounts by comparing each item's claimed original price to the local median for that query.

  Use to avoid misleading discounts; it is the inverse of deals.

  daraz-pp-cli value "power bank" --agent

• compare — Find the same item across sellers and show the cheapest and best-rated side by side.

  Use to pick the best seller/listing for an item before buying.

  daraz-pp-cli compare "airpods pro" --agent

Seller trust

• seller stats — Aggregate a seller's catalog from the local store: average rating, price range, listing count, discount pattern.

  Use to vet a seller's track record before trusting a listing.

  daraz-pp-cli seller stats 1066739 --agent

Command Reference

products — Search Daraz product listings

• daraz-pp-cli products — Search products by keyword with sort and price filtering

reviews — Read product reviews and rating distribution

• daraz-pp-cli reviews — List reviews for a product by its numeric item ID

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

daraz-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Agent-friendly search with field selection

daraz-pp-cli deals "wireless earbuds" --agent --select name,price,discountPct,rating,url

deals returns a flat, ranked array of listings, so --select trims each row to just the fields an agent needs and keeps payloads small.

Find the best-value items, not the biggest fake discount

daraz-pp-cli deals "power bank" --agent --select name,price,discountPct,rating

Ranks by a discount-times-rating-times-sales composite computed locally.

Start tracking a query's prices

daraz-pp-cli watch "gaming laptop"

Records current prices for the search so price-history builds a real trend over time.

See what changed in a market since last check

daraz-pp-cli since "gaming mouse" --agent

Diffs the current search against the last local snapshot for new listings and price moves.