promo-codeslisted
Install: claude install-skill titouannwtt/claude-tools
# promo-codes
Objective: give the user a short list of public, fixed promo codes for a merchant, best first. The codes are **only listed, never tested**: the user tries them.
The script searches, extracts and ranks (zero model tokens). Your role: run it, add what it cannot reach (Reddit, X), present the result.
## Commands
Script: `~/.claude/skills/promo-codes/scripts/promo.py`. One JSON object on stdout.
1. **Check the setup**: `python3 <script> doctor`
2. **Search**: `python3 <script> find "<merchant>" --domain example.com --lang fr --max 10`
- `--domain` also reads the official pages (`/pricing`, `/students`, `/education`, `/referral`, `/partners`, robots.txt respected) and reports non-code offers (student, annual, referral, trial). Pass it whenever you know the site.
- `--lang fr|en`: language of the queries (English is always included). `--product "<plan>"` narrows the queries.
- `--no-youtube`, `--no-web`, `--no-hn` switch a source off; `--github` adds public GitHub issues (off by default).
3. **Add a page you found yourself**: `python3 <script> extract --text <file> --url <url> --merchant "<merchant>" [--title "<page title>"] [--date YYYY-MM-DD] > extra1.json` (`--merchant` is required: only codes near the merchant name are kept).
4. **Merge and rerank**: `python3 <script> rank --input find.json extra1.json extra2.json [--domain example.com]`
Save the `find` output to a file (`> find.json`) to be able to rerank it. Read `summary`, `codes`, `official_offer