supermarket-deals

What This Skill Does

The supermarket-deals skill is a specialized agent utility designed to scrape and synthesize German supermarket flyer data via the Marktguru API. It acts as a bridge between raw retail promotional data and an AI agent's reasoning capabilities. By automatically managing temporary API keys fetched from the Marktguru homepage, the skill ensures uninterrupted access to current deals without requiring user registration. It supports multi-term searching, allowing an agent to query multiple product aliases simultaneously. Crucially, the skill performs automatic unit conversion to calculate the 'Price per Litre' (EUR/L), enabling direct, objective comparisons across disparate retailers like Lidl, REWE, and Kaufland. The output is structured to be easily parsed by AI agents, which can then apply advanced filtering logic to match complex user requirements, such as finding specific variants of a product even when promotional text is vague.

Installation

Installation is managed through the OpenClaw ecosystem. Run the following command in your terminal: clawhub install openclaw/skills/skills/benmillerat/supermarket-deals

After installation, navigate to the skill directory to build the source code: cd path/to/supermarket-deals && npm install && npm run build

It is recommended to set your default ZIP code and preferred stores to streamline future searches: node dist/index.js config set zip 85540 node dist/index.js config set stores "Lidl,REWE,EDEKA,ALDI SÜD,Kaufland"

Use Cases

This skill is perfect for price-conscious shoppers who want to automate their grocery savings strategy. Use cases include tracking price drops on bulk items, comparing the cost of beverages across different retail chains, and discovering which local stores are currently offering the best value for your weekly shopping list. Because the skill returns raw, broad data, it is ideally suited for integration with an AI agent that can summarize findings, suggest optimal store visits, and manage shopping lists based on active flyer validity dates.

Example Prompts

1. "Check the current prices for Cola Zero near zip code 80331 and tell me which store has the lowest price per litre right now."
2. "I need to buy snacks for a party. Find deals for chips and cola in my area, compare them, and highlight the three cheapest options by unit price."
3. "Search for Monster Energy deals at Lidl and Edeka. If there are no specific sales, list the standard prices found in the current flyers."

Tips & Limitations

• Timing: Prospekte typically refresh on Mondays and Thursdays. If searching on other days, the data remains consistent but may be slightly older.
• Regionality: Some regional branches do not index their flyers on Marktguru. If you find no results, broaden your search terms or include more stores.
• Caching: Results from Marktguru are cached for 15 minutes. The skill caches API keys for 6 hours; if a search fails, ensure your internet connection is stable and the key cache is not corrupted.
• AI Strategy: Always use the --json flag when connecting this skill to an agent to ensure the data is machine-readable for the reasoning engine.