# Send Supermarket Deals (DE) to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "supermarket-deals",
    "name": "Supermarket Deals (DE)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/benmillerat/supermarket-deals",
    "canonicalUrl": "https://clawhub.ai/benmillerat/supermarket-deals",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/supermarket-deals",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=supermarket-deals",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "package-lock.json",
      "package.json",
      "src/api.ts",
      "src/config.ts"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/supermarket-deals"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/supermarket-deals",
    "downloadUrl": "https://openagent3.xyz/downloads/supermarket-deals",
    "agentUrl": "https://openagent3.xyz/skills/supermarket-deals/agent",
    "manifestUrl": "https://openagent3.xyz/skills/supermarket-deals/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/supermarket-deals/agent.md"
  }
}
```
## Documentation

### 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

ColumnDescriptionDescriptionProduct description from flyerStoreRetailer nameSizeVolume × quantity (e.g. 6×0.33l, 1.5l)PriceTotal priceEUR/LPrice per litre (calculated or from API reference price)ValidDeal validity datesURLDirect 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)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: benmillerat
- Version: 1.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/supermarket-deals)
- [Send to Agent page](https://openagent3.xyz/skills/supermarket-deals/agent)
- [JSON manifest](https://openagent3.xyz/skills/supermarket-deals/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/supermarket-deals/agent.md)
- [Download page](https://openagent3.xyz/downloads/supermarket-deals)