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)
CODEBLOCK0
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):
CODEBLOCK1
Fallback: email/password mode
CODEBLOCK2
Workflow
- 1.
lists to show available shopping lists - INLINECODE4 to inspect current items
- INLINECODE5 to add items
- INLINECODE6 /
uncheck-item to toggle completion - INLINECODE8 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. - INLINECODE11 arguments can be list ID or a list name (exact/partial match).
Commands
Show all lists
CODEBLOCK3
Show items in a list
CODEBLOCK4
Add item
CODEBLOCK5
Check / uncheck item
CODEBLOCK6
Delete item
CODEBLOCK7
Create / rename / delete list
CODEBLOCK8
Raw JSON output
CODEBLOCK9
Listonic
通过非官方网页 API 管理 Listonic 购物清单。
设置
使用一种认证模式创建 ~/.openclaw/credentials/listonic/config.json。
推荐：令牌模式（适用于 Google 登录）
json
{
refreshToken: your-refresh-token
}
提示：脚本现在会自动刷新访问令牌，并将更新后的令牌持久化回配置文件。
如果你粘贴原始的 OAuth 负载 JSON，它也接受 refreshtoken / accesstoken 键。
可选（高级）：
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 显示可用的购物清单
- items
查看当前项目
- add-item
Name 添加项目
- check-item / uncheck-item 切换完成状态
- delete-item 仅在用户明确要求删除时使用
重要提示
- - 此工具使用非官方逆向工程 API，如果 Listonic 更改其 API，可能会失效。
- 对于破坏性操作（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
