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="[email protected]"
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