How do I install the Supermarket Deals skill?

Run npx skillmds@latest add dvcrn/supermarket-deals in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Supermarket Deals safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Supermarket Deals?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Supermarket Deals free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Supermarket Deals?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Supermarket Deals by dvcrn — Agent Skill

Name: Supermarket Deals
Rating: 4.2 (5 reviews)
Author: dvcrn

File contents

supermarket-deals

Search German supermarket flyers for product deals via the Marktguru API. Results are ranked by best price per litre.

What this skill does

Fetches Marktguru API keys automatically from the homepage (no registration needed, keys are cached 6h)
Searches current Prospekte (flyers) by product query + ZIP code
Supports multiple search terms in one call (merged + deduplicated)
Filters by store, ranks by EUR/L
Returns a direct Marktguru link for each deal
The skill is intentionally "dumb" — it fetches and formats data. Your agent applies smart filtering and formatting for notifications.

Setup

cd path/to/supermarket-deals
npm install
npm run build

Optionally set your defaults:

node dist/index.js config set zip 85540
node dist/index.js config set stores "Lidl,REWE,EDEKA,ALDI SÜD,Kaufland"

Usage

# Single search term
node dist/index.js search "Cola Zero" --zip 85540

# Multiple terms (merged + deduped, useful for product aliases)
node dist/index.js search "Cola Zero" "Coke Zero" --zip 85540

# Broad search — let your agent do the filtering
node dist/index.js search "Cola" --zip 85540

# Filter by specific stores
node dist/index.js search "Monster Energy" --zip 80331 --stores "Lidl,ALDI SÜD"

# JSON output for agent/cron use
node dist/index.js search "Cola" --zip 85540 --json

# Show config
node dist/index.js config

Agent pattern (recommended)

Use a broad search term and let your agent filter intelligently:

node dist/index.js search "Cola" --zip 85540 --json

Then instruct your agent to:

Include deals where description says "versch. Sorten" (these bundle all variants incl. Zero)
Include deals that explicitly mention Coca-Cola, Coke Zero, etc.
Exclude deals that only mention Powerade, Fuze Tea, Sprite-only, etc.
Rank by EUR/L and highlight the best deal

This approach catches deals that Marktguru lists as generic "Cola category" without naming every variant.

Output columns

Column	Description
Description	Product description from flyer
Store	Retailer name
Size	Volume × quantity (e.g. `6×0.33l`, `1.5l`)
Price	Total price
EUR/L	Price per litre (calculated or from API reference price)
Valid	Deal validity dates
URL	Direct link to Marktguru offer page

Notes

Prospekte refresh on Mondays and Thursdays
Results are cached by Marktguru for ~15 minutes
Some regional store branches may not submit flyers to Marktguru — broad queries catch more
API keys rotate and are fetched fresh at runtime (cached 6h in ~/.supermarket-deals/keys.json)

---name: supermarket-dealsdescription: Search German supermarket flyers (Aldi, Lidl, REWE, EDEKA, Kaufland) for product deals via Marktguru. Results ranked by best price per litre (EUR/L). No API key needed.---# supermarket-dealsSearch German supermarket flyers for product deals via the Marktguru API. Results are ranked by best price per litre.## What this skill does- Fetches Marktguru API keys automatically from the homepage (no registration needed, keys are cached 6h)- Searches current Prospekte (flyers) by product query + ZIP code- Supports multiple search terms in one call (merged + deduplicated)- Filters by store, ranks by EUR/L- Returns a direct Marktguru link for each deal- The skill is intentionally "dumb" — it fetches and formats data. Your agent applies smart filtering and formatting for notifications.## Setup```bashcd path/to/supermarket-dealsnpm installnpm run build```Optionally set your defaults:```bashnode dist/index.js config set zip 85540node dist/index.js config set stores "Lidl,REWE,EDEKA,ALDI SÜD,Kaufland"```## Usage```bash# Single search termnode dist/index.js search "Cola Zero" --zip 85540# Multiple terms (merged + deduped, useful for product aliases)node dist/index.js search "Cola Zero" "Coke Zero" --zip 85540# Broad search — let your agent do the filteringnode dist/index.js search "Cola" --zip 85540# Filter by specific storesnode dist/index.js search "Monster Energy" --zip 80331 --stores "Lidl,ALDI SÜD"# JSON output for agent/cron usenode dist/index.js search "Cola" --zip 85540 --json# Show confignode dist/index.js config```## Agent pattern (recommended)Use a broad search term and let your agent filter intelligently:```node dist/index.js search "Cola" --zip 85540 --json```Then instruct your agent to:- Include deals where description says "versch. Sorten" (these bundle all variants incl. Zero)- Include deals that explicitly mention Coca-Cola, Coke Zero, etc.- Exclude deals that only mention Powerade, Fuze Tea, Sprite-only, etc.- Rank by EUR/L and highlight the best dealThis approach catches deals that Marktguru lists as generic "Cola category" without naming every variant.## Output columns| Column | Description ||--------|-------------|| Description | Product description from flyer || Store | Retailer name || Size | Volume × quantity (e.g. `6×0.33l`, `1.5l`) || Price | Total price || EUR/L | Price per litre (calculated or from API reference price) || Valid | Deal validity dates || URL | Direct link to Marktguru offer page |## Notes- Prospekte refresh on Mondays and Thursdays- Results are cached by Marktguru for ~15 minutes- Some regional store branches may not submit flyers to Marktguru — broad queries catch more- API keys rotate and are fetched fresh at runtime (cached 6h in `~/.supermarket-deals/keys.json`)

Frequently asked questions

Supermarket Deals