← 返回 Skills 市场

Bring! Shoppinglist

Name: Bring! Shoppinglist
Author: joekravelli

作者 JoeKravelli · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install bring-app

功能描述

Manage Bring! shopping lists via CLI to add, remove, complete, and view items or lists using the Bring! API.

使用说明 (SKILL.md)

Bring! Shopping List Skill

Manage Bring! shopping lists using the bring-api Python package via a bundled CLI script.

Setup (one-time)

Install the Python dependency:
```
python3 -m pip install bring-api
```
Configure credentials — set env vars BRING_EMAIL and BRING_PASSWORD, or create ~/.openclaw/credentials/bring.json:
```
{
  "email": "[email protected]",
  "password": "your_password"
}
```
(Optional) Set a default list via env var BRING_LIST (matches list title, case-insensitive).

Usage

All commands use the bundled script scripts/bring.py.

List all shopping lists

python3 scripts/bring.py list

Show items in a list

python3 scripts/bring.py items
python3 scripts/bring.py items --list "Einkauf"

Add an item

python3 scripts/bring.py add "Milch"
python3 scripts/bring.py add "Milch" --spec "fettarm"
python3 scripts/bring.py add "Zitronen" --list "Party"

Remove an item

python3 scripts/bring.py remove "Milch"
python3 scripts/bring.py remove "Milch" --list "Einkauf"

Complete (check off) an item

python3 scripts/bring.py complete "Milch"
python3 scripts/bring.py complete "Milch" --list "Einkauf"

Common Patterns

When the user says "add X to shopping list", extract the item name and optional spec, then call add.
When the user says "remove X from shopping list", call remove.
When the user says "check off X" or "done with X", call complete.
When the user says "show shopping list" or "what's on the list", call items.
If the user has multiple lists, use --list "Name" to target the right one.
If unsure which list, call list first and ask the user to confirm.

Troubleshooting

Authentication failed: Check email/password in ~/.bring.json or env vars. Bring! uses the email from the app account settings.
List not found: List names are case-insensitive but must match exactly. Use list to see available names.
Item not found: Item matching is case-insensitive. If duplicates exist, the first match is used.
ModuleNotFoundError: Run python3 -m pip install bring-api.

API Reference

Based on miaucl/bring-api (unofficial Bring! API, MIT license).

The CLI wraps these core API methods:

load_lists() → all shopping lists
get_list(listUuid) → items in one list
batch_update_list(listUuid, item, ADD) → add item
batch_update_list(listUuid, item, REMOVE) → remove item
batch_update_list(listUuid, item, COMPLETE) → check off item

License

This skill uses the MIT-licensed bring-api package. Bring! trademarks belong to Bring! Labs AG. This is not affiliated with or endorsed by Bring! Labs AG.

安全使用建议

This appears safe to review as a normal Bring! shopping-list integration, not as malware. Before installing, verify the dependency, correct the script path if needed, store credentials carefully, and make sure the agent confirms the target list before changing items.

功能分析

Type: OpenClaw Skill Name: bring-app Version: 1.0.0 The skill provides a legitimate CLI interface for managing Bring! shopping lists using the 'bring-api' library. It handles authentication via environment variables or a local configuration file (~/.openclaw/credentials/bring.json) and performs standard list operations (add, remove, complete, list) without any evidence of data exfiltration, malicious execution, or prompt injection.

能力标签

cryptocan-make-purchases

能力评估

ℹ Purpose & Capability

The bundled code is coherent with the stated purpose: it lists, adds, removes, and completes Bring! shopping-list items. These are account mutations, so user intent and list selection matter.

ℹ Instruction Scope

The SKILL.md tells the agent to ask for confirmation if the target list is unclear, but the script itself defaults to the first Bring! list when no list or BRING_LIST value is supplied.

ℹ Install Mechanism

There is no install spec, while SKILL.md asks the user to run an unpinned `pip install bring-api`. SKILL.md also references `scripts/bring.py`, but the manifest provides `bring.py` at the package root.

ℹ Credentials

Bring! email/password use is expected for this integration, but registry metadata declares no required env vars or primary credential even though the skill and code require credentials to function.

ℹ Persistence & Privilege

The script does not create background processes or hidden persistence, but it supports a persistent local credential file at `~/.openclaw/credentials/bring.json`.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install bring-app
安装完成后，直接呼叫该 Skill 的名称或使用 /bring-app 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

- Initial release: manage Bring! shopping lists via CLI using the bring-api Python package. - Supports adding, removing, completing, and listing items on any Bring! shopping list. - Easy authentication setup via environment variables or credentials file. - Includes commands for listing all shopping lists and specifying target lists by name. - Troubleshooting tips and full usage examples provided in documentation.

元数据

Slug bring-app

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题