# bring-shopping

> Use when running the OpenClaw/ClawHub Bring! skill to fetch inspirations, suggest seasonal dishes, and add ingredients to a Bring shopping list. Covers login, inspiration filters, inspiration fetch, recipe parsing, and list insertion.

- Author: Damian
- Repository: Dolverin/node-bring-api
- Version: 20260201193335
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/Dolverin/node-bring-api
- Web: https://mule.run/skillshub/@@Dolverin/node-bring-api~bring-shopping:20260201193335

---

---
name: bring-shopping
description: Use when running the OpenClaw/ClawHub Bring! skill to fetch inspirations, suggest seasonal dishes, and add ingredients to a Bring shopping list. Covers login, inspiration filters, inspiration fetch, recipe parsing, and list insertion.
---

# Bring App

## Overview
Build a Bring! CLI-focused skill that uses the updated `node-bring-api` to fetch inspirations (recipes), highlight seasonal dishes, and add user-selected ingredients to a shopping list.

## Quick start workflow
1. List inspiration filters and identify seasonal tags.
2. Fetch inspirations using those tags.
3. Summarize 3-7 seasonal dishes.
4. Ask which dishes to add to a list, then add their ingredients (not the dish name).

Use `references/bring-inspirations.md` for endpoint details and headers.
These scripts load `node-bring-api` from:
1) `BRING_NODE_API_PATH` (if set), or
2) `../../node-bring-api/build/bring.js` relative to this skill, or
3) the installed `bring-shopping` package.

## Tasks

### 1) Discover available filters (season, diet, cuisine)
Run:
```
node scripts/bring_inspirations.js --filters
```
- Read the JSON and pick tags that look seasonal (e.g., winter/sommer/fruehling/herbst).
- If unsure, ask the user to pick from the filter list.

### 2) Fetch inspirations
Run:
```
node scripts/bring_inspirations.js --tags "<comma-separated-tags>" --limit 20
```
- If the user did not specify tags, default to `mine`.
- Inspect the JSON and extract a short list of suggested dishes with any available metadata.
- Capture `content.contentSrcUrl` for each dish (needed to load ingredients).

### 3) Suggest seasonal dishes
- Return 3-7 options.
- Include dish name and 1 short sentence (if available in the JSON).
- Ask the user which dishes should be added to the list.

### 4) Add selected dishes to a list (ingredients only)
If the user confirms, list available lists if needed:
```
node scripts/bring_list.js --lists
```
Add ingredients from the selected dish content URL(s):
```
node scripts/bring_list.js --list <list-uuid> --content-url "https://api.getbring.com/rest/v2/bringtemplates/content/<uuid>"
```
Or resolve by list name:
```
node scripts/bring_list.js --list-name "Einkauf" --content-url "https://api.getbring.com/rest/v2/bringtemplates/content/<uuid>"
```

## Environment
These scripts default to ENV values:
- `BRING_EMAIL`
- `BRING_PASSWORD`
- `BRING_COUNTRY` (default `DE`)
- `BRING_NODE_API_PATH` (optional path to `build/bring.js`)

If ENV is not set, pass `--email` and `--password` explicitly.

## Notes
- Keep the skill output in German for Germany by default.
- Do not add items without explicit user confirmation.
- Always add ingredients instead of the dish name when using inspirations.

## Resources

### scripts/
- `scripts/bring_inspirations.js`: Log in and call inspirations and filter endpoints.
- `scripts/bring_list.js`: List available shopping lists and add items.

### references/
- `references/bring-inspirations.md`: Endpoint details and headers.