← 返回 Skills 市场
Listonic
作者
Jeremy Mahieu
· GitHub ↗
· v1.0.1
· MIT-0
976
总下载
1
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install listonic
功能描述
Access Listonic shopping lists: list lists/items, add/check/delete items, and manage lists.
使用说明 (SKILL.md)
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)
{
"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):
{
"accessToken": "short-lived-access-token",
"clientId": "listonicv2",
"clientSecret": "fjdfsoj9874jdfhjkh34jkhffdfff",
"redirectUri": "https://listonicv2api.jestemkucharzem.pl"
}
Fallback: email/password mode
{
"email": "[email protected]",
"password": "your-listonic-password"
}
Workflow
liststo show available shopping listsitems \x3Clist>to inspect current itemsadd-item \x3Clist> "Name"to add itemscheck-item/uncheck-itemto toggle completiondelete-itemonly 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. listarguments can be list ID or a list name (exact/partial match).
Commands
Show all lists
bash scripts/listonic.sh lists
Show items in a list
bash scripts/listonic.sh items 12345
bash scripts/listonic.sh items "Groceries"
Add item
bash scripts/listonic.sh add-item "Groceries" "Milk"
bash scripts/listonic.sh add-item "Groceries" "Flour" --amount 2 --unit kg
Check / uncheck item
bash scripts/listonic.sh check-item "Groceries" 987654
bash scripts/listonic.sh uncheck-item "Groceries" 987654
Delete item
bash scripts/listonic.sh delete-item "Groceries" 987654
Create / rename / delete list
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 scripts/listonic.sh --json lists
bash scripts/listonic.sh --json items "Groceries"
安全使用建议
This skill appears to do what it says: a local CLI that talks to Listonic and stores your auth in ~/.openclaw/credentials/listonic/config.json. Before installing: (1) Prefer the token/refreshToken mode rather than supplying your email/password. (2) Be aware tokens (and rotated refresh tokens) are saved in plaintext at the given path — avoid placing them on shared machines. (3) Inspect the bundled scripts yourself if you want to confirm network endpoints; the code calls Listonic domains and includes a hard-coded client_id/client_secret and a non-Listonic redirect URI (likely from reverse-engineering). (4) If you are uncomfortable giving credentials, do not add them; the tool cannot work without valid credentials.
功能分析
Type: OpenClaw Skill
Name: listonic
Version: 1.0.1
The skill is a functional integration for managing Listonic shopping lists using a reverse-engineered API. It handles authentication (OAuth tokens or email/password) and persists refreshed tokens to its own configuration file in `~/.openclaw/credentials/listonic/`. The implementation in `scripts/listonic.py` uses standard Python libraries, lacks suspicious execution or exfiltration logic, and includes safety instructions in `SKILL.md` for destructive operations.
能力评估
Purpose & Capability
Name/description (manage Listonic lists) match the included Python CLI and shell wrapper. Required binary is python3, and the skill reads/writes a per-skill config file for tokens/passwords — all consistent with an API client.
Instruction Scope
SKILL.md instructs creating a local config at ~/.openclaw/credentials/listonic/config.json and running the provided scripts. The runtime instructions and the code operate only on that config path and the Listonic API; they do not request unrelated system files or external endpoints unrelated to Listonic functionality.
Install Mechanism
No external install/downloads are performed. This is an instruction-only skill with bundled code files executed locally. No remote installers, package downloads, or archive extraction are used.
Credentials
The skill requests no environment variables, only a local credentials file (token or email/password). It persistently stores tokens (including rotated refresh tokens) in plaintext at ~/.openclaw/credentials/listonic/config.json — expected for a client but something users should be aware of. The code includes a hard-coded default client_id/client_secret and a default redirect URI; embedding these values is plausible for a reverse-engineered web client but worth noting.
Persistence & Privilege
always is false and the skill only writes to its own config path. It auto-refreshes and persists tokens for convenience; it does not request system-wide settings or other skills' credentials.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install listonic - 安装完成后,直接呼叫该 Skill 的名称或使用
/listonic触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- Added auto-refresh for access tokens and automatic persistence of updated tokens back to the config.
- Improved compatibility with OAuth JSON payloads by also accepting refresh_token and access_token keys.
- No breaking changes to commands or workflows.
v1.0.0
- Initial release: Manage Listonic shopping lists from the command line using an unofficial API.
- Supports listing, adding, checking/unchecking, and deleting items and lists.
- Allows flexible authentication via refresh token, access token, or email/password.
- Includes JSON output mode and confirmation prompts for destructive actions.
- Compatible with both list names and IDs for commands.
元数据
常见问题
Listonic 是什么?
Access Listonic shopping lists: list lists/items, add/check/delete items, and manage lists. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 976 次。
如何安装 Listonic?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install listonic」即可一键安装,无需额外配置。
Listonic 是免费的吗?
是的,Listonic 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Listonic 支持哪些平台?
Listonic 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Listonic?
由 Jeremy Mahieu(@jeremymahieu)开发并维护,当前版本 v1.0.1。
推荐 Skills