Bring Recipes
/install bring-recipes
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 \x3Ctags> |
Filter tags: all, mine |
--limit \x3Cn> |
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-apiv2.0.2+ withgetInspirations()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
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bring-recipes - After installation, invoke the skill by name or use
/bring-recipes - Provide required inputs per the skill's parameter spec and get structured output
What is Bring Recipes?
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). It is an AI Agent Skill for Claude Code / OpenClaw, with 1931 downloads so far.
How do I install Bring Recipes?
Run "/install bring-recipes" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Bring Recipes free?
Yes, Bring Recipes is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Bring Recipes support?
Bring Recipes is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Bring Recipes?
It is built and maintained by darkdevelopers (@darkdevelopers); the current version is v0.1.0.