# fairprice

Adopt this skill: https://proskills.md/skills/other/meshpilot-xyz-grocery-shopping-sg-skills-fairprice

Page: https://proskills.md/skills/other/meshpilot-xyz-grocery-shopping-sg-skills-fairprice
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: fairprice/SKILL.md
size: 3361
upstream: https://github.com/meshpilot-xyz/grocery-shopping-sg-skills/blob/main/fairprice/SKILL.md

````text
---
name: fairprice
description: "Search and browse NTUC FairPrice grocery products — prices, ratings, nutrition. Use when the user asks about FairPrice, NTUC, grocery prices, Singapore supermarket, product search, or wants to look up grocery items."
allowed-tools: Bash
license: MIT
compatibility: "Requires Python 3.10+ and uv (or pip with requests installed). No API keys needed."
metadata:
  version: "1.2"
---

# fairprice — NTUC FairPrice Product Search

Search and browse products on NTUC FairPrice (Singapore's largest supermarket).

## Base Command

```bash
uv run scripts/fp.py <command> [args...]
```

Shorthand in this doc:
```
fp <command>   # means the full path above
```

## Important Notes

1. All data is public — no API keys needed.
2. Data comes from FairPrice's public API — always fresh.
3. Prices are in SGD (Singapore Dollars).
4. Output is clean markdown.

## Command Shorthand

| User says | Command |
|-----------|---------|
| search milk, find milk | `fp search milk` |
| cheapest rice | `fp search rice --sort PRICE_ASC` |
| popular peanut butter | `fp search "peanut butter" --sort POPULARITY` |
| halal snacks | `fp search snacks --dietary Halal` |
| organic milk | `fp search milk --dietary Organic` |
| show me product 13164212 | `fp product 13164212` |

## Quick Reference

### Search
```bash
fp search "peanut butter"                          # Basic search
fp search milk --sort POPULARITY                   # Sort by popularity
fp search rice --sort PRICE_ASC                    # Cheapest first
fp search milk --brand Meiji                       # Filter by brand
fp search rice --country Thailand                  # Filter by origin
fp search snacks --dietary Halal                   # Dietary filter
fp search milk --min-price 5 --max-price 15        # Price range
fp search milk --count 5                           # Limit results
fp search milk --sort PRICE_ASC --dietary Organic  # Combined filters
```

### Product Details
```bash
fp product 13164212                                # By product ID
```

## Common Workflows

### Quick product lookup
1. `fp search "peanut butter"` — find products
2. Pick a product ID from results
3. `fp product <id>` — full details

### Price comparison
1. `fp search milk --sort PRICE_ASC --count 10` — cheapest milk
2. Compare prices, sizes, and brands in the table
3. `fp product <id>` for details on best value

### Dietary-specific shopping
1. `fp search snacks --dietary Halal` — halal options
2. `fp search cereal --dietary "Gluten-Free"` — gluten-free
3. `fp search milk --dietary Organic` — organic

### Budget shopping
1. `fp search rice --sort PRICE_ASC --max-price 10`
2. Review cheapest options
3. Check details for value-per-unit

## Sort Options

- `RELEVANCE` — default
- `POPULARITY` — most popular first
- `PRICE_ASC` — cheapest first
- `PRICE_DESC` — most expensive first
- `NEW` — newest first
- `RATING_DESC` — highest rated first

## Dietary Filters

Halal, Organic, Healthier Choice, Vegetarian, Gluten-Free, Trans-Fat Free, Lactose-Free, Hypoallergenic

## Error Handling

- **No results**: try different search terms or remove filters
- **Product not found**: verify the product ID from search results
- **Timeout**: transient network issue, retry the command

For full command details, see `references/command-reference.md`.
````

## File: README.md
upstream: https://github.com/meshpilot-xyz/grocery-shopping-sg-skills/blob/main/README.md

````text
# Singapore Grocery Skills for Claude Code & OpenClaw

> **Disclaimer:** This project is provided strictly for **educational and research purposes only**. The authors are **not liable** for any misuse, damages, or consequences arising from the use of this software. Product data, prices, and availability are sourced from third-party platforms and may not be accurate or up to date. This project is not affiliated with, endorsed by, or sponsored by NTUC FairPrice, RedMart, Lazada, or any of their subsidiaries. Use at your own risk.

## Available Skills

| Skill | Supermarket | Commands |
|-------|-------------|----------|
| [fairprice](fairprice/) | [NTUC FairPrice](https://www.fairprice.com.sg) | `search`, `product` |
| [redmart](redmart/) | [RedMart (Lazada)](https://redmart.lazada.sg) | `search`, `product` |

## Installation

### Install all skills

```bash
git clone https://github.com/MeshPilot-xyz/grocery-shopping-sg-skills.git
cd grocery-shopping-sg-skills
bash install.sh
```

The installer will prompt you to choose your platform:
- **Claude Code** — installs to `~/.claude/skills/`
- **OpenClaw** — installs to `~/.openclaw/skills/`

### Install with flags

```bash
bash install.sh --claude              # All skills for Claude Code
bash install.sh --openclaw            # All skills for OpenClaw
bash install.sh --claude fairprice    # FairPrice only for Claude Code
bash install.sh --openclaw redmart    # RedMart only for OpenClaw
```

### Requirements

- Python 3.10+
- [Claude Code](https://claude.com/claude-code) or [OpenClaw](https://openclaw.ai)
- Chromium (auto-installed by Playwright for the RedMart skill)

## Usage

Once installed, your agent automatically detects the skills. Just ask naturally:

```
> search for milk on fairprice
> cheapest eggs on redmart
> compare rice prices
```

### FairPrice

```bash
fp search "peanut butter" --sort POPULARITY
fp search milk --dietary Halal --sort PRICE_ASC
fp product 13231240
```

**Features:** Search with brand/country/dietary filters, product details with rating distribution.

### RedMart

```bash
rm search eggs --sort PRICE_ASC
rm search chicken --sort SAVINGS --max-price 15
rm product 301088929 527120220
```

**Features:** Search with price filters, stock levels, product attributes. Uses headless Chromium via Playwright.

## Sort Options

| FairPrice | RedMart | Description |
|-----------|---------|-------------|
| RELEVANCE | - | Default relevance |
| POPULARITY | POPULARITY | Most popular |
| PRICE_ASC | PRICE_ASC | Cheapest first |
| PRICE_DESC | PRICE_DESC | Most expensive first |
| NEW | - | Newest first |
| RATING_DESC | - | Highest rated first |
| - | SAVINGS | Biggest savings first |

## ⭐ Star History

[![Star History Chart](https://api.star-history.com/svg?repos=MeshPilot-xyz/grocery-shopping-sg-skills&type=Date)](https://star-history.com/#MeshPilot-xyz/grocery-shopping-sg-skills&Date)

## Scraping & Bot Detection Notice

The **RedMart skill** uses a headless browser (Playwright) that modifies browser fingerprints (e.g. masking `navigator.webdriver`) to retrieve product data from Lazada's platform. This may violate Lazada's Terms of Service. Use this tool responsibly:

- **Do not** use it for high-volume automated scraping or commercial data collection.
- **Do not** use it to circumvent access controls beyond public product listings.
- Be aware that Lazada may block, rate-limit, or take action against automated access at any time.
- This tool is intended for **personal, low-volume product lookups only**.

Both skills send a browser-like `User-Agent` string instead of identifying as a script. This is necessary because the target APIs reject requests from non-browser clients (returning 403 or empty responses). The spoofed UA mimics a standard Chrome browser to ensure the public product data remains accessible.

## License

MIT
````
