playbooks

home / skills / openclaw / skills / erz-entsorgung-recycling-zurich

erz-entsorgung-recycling-zurich skill

/skills/mbjoern/erz-entsorgung-recycling-zurich

This skill helps you fetch Zurich waste collection dates from the OpenERZ API for trash, cardboard, paper, organic, and more.

npx playbooks add skill openclaw/skills --skill erz-entsorgung-recycling-zurich

Review the files below or copy the command above to add this skill to your agents.

Files (2)
SKILL.md
2.0 KB
---
name: openerz
description: Abfuhrkalender für Zürich via OpenERZ API. Nutze bei Fragen zu Kehricht, Karton, Papier, Grüngut, Sonderabfall oder Entsorgungsterminen im Raum Zürich.
---

# OpenERZ – Abfuhrkalender Zürich

API für Entsorgungstermine in Zürich.

## Benutzer-Defaults

- Region: `zurich`
- Area/PLZ: `8003`

## API-Endpunkt

```
https://openerz.metaodi.ch/api/calendar
```

## Parameter

| Parameter | Beschreibung | Beispiel |
|-----------|--------------|----------|
| `region` | Region (immer `zurich` für Stadt Zürich) | `zurich` |
| `area` | PLZ oder Gebiet | `8003` |
| `types` | Komma-separiert: waste, cardboard, paper, organic, special, mobile, incombustibles, chipping, metal, etram, cargotram, textile | `paper,cardboard` |
| `start` | Startdatum (YYYY-MM-DD) | `2026-01-14` |
| `end` | Enddatum (YYYY-MM-DD) | `2026-01-31` |
| `sort` | Sortierung (date, -date) | `date` |
| `limit` | Max. Anzahl Ergebnisse | `10` |

## Abfalltypen

| Typ | Beschreibung |
|-----|--------------|
| `waste` | Kehricht |
| `cardboard` | Karton |
| `paper` | Papier |
| `organic` | Grüngut/Bioabfall |
| `special` | Sonderabfall (Sammelstelle) |
| `mobile` | Mobile Sondersammlung |
| `incombustibles` | Unbrennbares |
| `chipping` | Häckselservice |
| `metal` | Altmetall |
| `etram` | E-Tram |
| `cargotram` | Cargo-Tram |
| `textile` | Textilien |

## Beispielanfragen

Nächste Abholungen:
```bash
curl "https://openerz.metaodi.ch/api/calendar?region=zurich&area=8003&start=$(date +%Y-%m-%d)&limit=5&sort=date"
```

Nur Papier/Karton:
```bash
curl "https://openerz.metaodi.ch/api/calendar?region=zurich&area=8003&types=paper,cardboard&start=$(date +%Y-%m-%d)&limit=5"
```

## Antwortformat

```json
{
  "_metadata": {"total_count": 5, "row_count": 5},
  "result": [
    {
      "date": "2026-01-15",
      "waste_type": "waste",
      "zip": 8003,
      "area": "8003",
      "station": "",
      "region": "zurich",
      "description": ""
    }
  ]
}
```

Bei `mobile` oder `special` enthält `station` den Sammelort.

Overview

This skill provides Zurich waste collection calendars via the OpenERZ API. It returns upcoming disposal and recycling pickup dates for Kehricht, Karton, Papier, Grüngut, Sonderabfall and other services in the city of Zurich. Use it to fetch date-filtered, type-specific schedules for a given postal area.

How this skill works

The skill queries the OpenERZ API endpoint with parameters for region (zurich), area (postal code), waste types, date range, sorting and result limits. Responses include a list of events with date, waste_type, zip/area, station (for mobile/special collections) and an optional description. It supports filtering by multiple waste types in a comma-separated list and returns JSON metadata with counts.

When to use it

  • Check next pickup dates for a specific Zurich postal code (area).
  • Filter pickups by waste type (paper, cardboard, organic, etc.).
  • Build a local reminder or calendar integration for disposal days.
  • Query mobile collection or special waste collection locations.
  • Fetch a short upcoming list for display in apps or dashboards.

Best practices

  • Always set region=zurich and the correct area (postal code) to get valid results.
  • Use start and end dates in YYYY-MM-DD format to limit the time window.
  • Combine types as a comma-separated string to query multiple streams in one request.
  • Apply limit and sort=date to keep responses compact and chronological.
  • Handle empty descriptions and use the station field for mobile/special events.

Example use cases

  • Show the next 5 collections for 8003: start=today, limit=5, sort=date.
  • Display only paper and cardboard pickups for a neighbourhood: types=paper,cardboard.
  • Find the location of a mobile hazardous waste collection: types=mobile or special and read station.
  • Populate a household calendar with upcoming Grüngut (organic) and Kehricht dates.
  • Provide a neighbourhood dashboard that highlights imminent collection types.

FAQ

What region value should I use for Zurich?

Use region=zurich for all queries covering the city of Zurich.

How do I request multiple waste types?

Send types as a comma-separated list, for example types=paper,cardboard.