listonic

访问 Listonic 购物清单：列出列表/项目、添加/检查/删除项目以及管理列表。

# Listonic

Manage Listonic shopping lists via the unofficial web API.

## Setup

Create `~/.openclaw/credentials/listonic/config.json` using **one** auth mode.

### Recommended: token mode (works with Google sign-in)

```json
{
  "refreshToken": "your-refresh-token"
}
```

Tip: the script now auto-refreshes access tokens and persists updated tokens back to config.
It also accepts `refresh_token` / `access_token` keys if you paste raw OAuth payload JSON.

Optional (advanced):

```json
{
  "accessToken": "short-lived-access-token",
  "clientId": "listonicv2",
  "clientSecret": "fjdfsoj9874jdfhjkh34jkhffdfff",
  "redirectUri": "https://listonicv2api.jestemkucharzem.pl"
}
```

### Fallback: email/password mode

```json
{
  "email": "you@example.com",
  "password": "your-listonic-password"
}
```

## Workflow

1. `lists` to show available shopping lists
2. `items <list>` to inspect current items
3. `add-item <list> "Name"` to add items
4. `check-item` / `uncheck-item` to toggle completion
5. `delete-item` only when user explicitly wants removal

## Important

- This uses an **unofficial reverse-engineered API** and may break if Listonic changes it.
- For destructive operations (`delete-item`, `delete-list`), **confirm with the user first**.
- `list` arguments can be list ID or a list name (exact/partial match).

## Commands

### Show all lists
```bash
bash scripts/listonic.sh lists
```

### Show items in a list
```bash
bash scripts/listonic.sh items 12345
bash scripts/listonic.sh items "Groceries"
```

### Add item
```bash
bash scripts/listonic.sh add-item "Groceries" "Milk"
bash scripts/listonic.sh add-item "Groceries" "Flour" --amount 2 --unit kg
```

### Check / uncheck item
```bash
bash scripts/listonic.sh check-item "Groceries" 987654
bash scripts/listonic.sh uncheck-item "Groceries" 987654
```

### Delete item
```bash
bash scripts/listonic.sh delete-item "Groceries" 987654
```

### Create / rename / delete list
```bash
bash scripts/listonic.sh add-list "BBQ Party"
bash scripts/listonic.sh rename-list "BBQ Party" "BBQ"
bash scripts/listonic.sh delete-list "BBQ"
```

### Raw JSON output
```bash
bash scripts/listonic.sh --json lists
bash scripts/listonic.sh --json items "Groceries"
```

---

## 中文说明

# Listonic

通过非官方 Web API 管理 Listonic 购物清单。

## 设置

使用**一种**认证模式创建 `~/.openclaw/credentials/listonic/config.json`。

### 推荐：令牌模式（适用于 Google 登录）

```json
{
  "refreshToken": "your-refresh-token"
}
```

提示：脚本现在会自动刷新访问令牌，并将更新后的令牌持久化写回配置文件。
如果你粘贴的是原始 OAuth 载荷 JSON，它也接受 `refresh_token` / `access_token` 键。

可选（高级）：

```json
{
  "accessToken": "short-lived-access-token",
  "clientId": "listonicv2",
  "clientSecret": "fjdfsoj9874jdfhjkh34jkhffdfff",
  "redirectUri": "https://listonicv2api.jestemkucharzem.pl"
}
```

### 备选：邮箱/密码模式

```json
{
  "email": "you@example.com",
  "password": "your-listonic-password"
}
```

## 工作流

1. `lists` 显示可用的购物清单
2. `items <list>` 查看当前项目
3. `add-item <list> "Name"` 添加项目
4. `check-item` / `uncheck-item` 切换完成状态
5. 仅当用户明确希望删除时才使用 `delete-item`

## 重要提示

- 此功能使用**非官方逆向工程 API**，如果 Listonic 进行更改，可能会失效。
- 对于破坏性操作（`delete-item`、`delete-list`），**请先与用户确认**。
- `list` 参数可以是列表 ID 或列表名称（精确/部分匹配）。

## 命令

### 显示所有列表
```bash
bash scripts/listonic.sh lists
```

### 显示列表中的项目
```bash
bash scripts/listonic.sh items 12345
bash scripts/listonic.sh items "Groceries"
```

### 添加项目
```bash
bash scripts/listonic.sh add-item "Groceries" "Milk"
bash scripts/listonic.sh add-item "Groceries" "Flour" --amount 2 --unit kg
```

### 勾选 / 取消勾选项目
```bash
bash scripts/listonic.sh check-item "Groceries" 987654
bash scripts/listonic.sh uncheck-item "Groceries" 987654
```

### 删除项目
```bash
bash scripts/listonic.sh delete-item "Groceries" 987654
```

### 创建 / 重命名 / 删除列表
```bash
bash scripts/listonic.sh add-list "BBQ Party"
bash scripts/listonic.sh rename-list "BBQ Party" "BBQ"
bash scripts/listonic.sh delete-list "BBQ"
```

### 原始 JSON 输出
```bash
bash scripts/listonic.sh --json lists
bash scripts/listonic.sh --json items "Groceries"
```