name: bring-recipes
description: Use when user wants to browse recipe inspirations from Bring! shopping app. For discovering recipes, viewing recipe details (name, author, type, images), or filtering by tags. Note - cannot import ingredients (API limitation).

Bring! Recipe Browser CLI

Overview

CLI for browsing Bring! recipe inspirations. Browse-only tool - the Bring! Inspirations API does not provide ingredient lists.

When to Use

Use this skill when:

• User wants to discover Bring! recipes
• Browsing recipe inspirations
• Viewing recipe metadata (names, authors, types, images, links)
• Filtering recipes by tags (all, mine)
• Need JSON output of recipes for scripting

Don't use when:

• User wants to add ingredients to shopping list (API limitation)
• Managing shopping lists directly
• Need full recipe details with ingredients

Quick Reference

| Command | Purpose |
|---------|---------|
| bring-recipes list | Browse recipe inspirations (default) |
| bring-recipes filters | Show available filter tags |
| bring-recipes list --filter mine | Show your personal recipes |
| bring-recipes list --json | JSON output for scripting |

Environment variables:

export BRING_EMAIL="your@email.com"
export BRING_PASSWORD="yourpassword"

Installation

cd skills/bring-recipes
npm install

Common Workflows

Browse all recipes:

node index.js list --limit 10

Filter your recipes:

node index.js list --filter mine

Get JSON for scripting:

node index.js list --json | jq -r '.[] | .content.name'

Check available filters:

node index.js filters

Flags Reference

| Flag | Description |
|------|-------------|
| -f, --filter <tags> | Filter tags: all, mine |
| --limit <n> | Max recipes (default: 10) |
| --json | JSON output |
| --no-color | Disable colors |
| -q, --quiet | Minimal output |
| -v, --verbose | Debug output |

API Limitations

⚠️ Critical: The Bring! getInspirations() API returns only metadata:

• ✅ Recipe names, authors, types
• ✅ Images, links, tags, like counts
• ❌ Ingredient lists (not provided)

This is a Bring! API limitation, not a CLI bug. The CLI is designed for browsing and discovering recipes only.

Recipe Types

• TEMPLATE - Bring! templates (e.g., "Sunday Brunch")
• RECIPE - Parsed recipes from partners
• POST - Promotional content

Common Mistakes

Expecting ingredients:
The API does not provide ingredient lists. Use the CLI for discovery, then manually add items.

Looking for seasonal filters:
The API has no seasonal tags. Only "all" and "mine" filters are available.

Assuming all recipes have names:
POST types may be "Untitled Recipe" - this is normal API behavior.

Implementation Notes

• Uses node-bring-api v2.0.2+ with getInspirations() API
• Requires Node.js 18.0.0+
• No seasonal filtering (API limitation)
• Browse-only functionality
• JSON mode available for automation

Real-World Use

• Recipe discovery: Browse what's available in Bring!
• Inspiration browsing: See trending recipes and templates
• Personal collection: Filter your saved recipes
• Integration: JSON output for external tools