Wallabag
Overview
Use this skill to operate a Wallabag instance through its API with deterministic shell commands. Keep credentials in environment variables and never hardcode secrets.
Runtime Requirements
- - Required binaries:
bash, INLINECODE1 - Required for
tag add and tag remove: INLINECODE4
Required Environment
Set these variables before running commands:
- - INLINECODE5
- INLINECODE6
- INLINECODE7
- INLINECODE8
- INLINECODE9
Example:
CODEBLOCK0
Command Interface
Main command:
CODEBLOCK1
Subcommands:
- - INLINECODE10
- INLINECODE11
- INLINECODE12
- INLINECODE13
- INLINECODE14
- INLINECODE15
- INLINECODE16
- INLINECODE17
Workflow
- 1. Run
auth to verify OAuth credentials. - Use
create to add bookmarks. - Use
list and get to retrieve bookmarks. - Use
update or tag commands to adjust metadata. - Use
delete only when removal is required.
Operational Rules
- - Keep tokens in process memory only. Do not persist token state to disk.
- INLINECODE25 does not print access tokens unless
--show-token is explicitly passed. - Return JSON output unchanged where possible.
- Emit actionable error messages on stderr and non-zero exit codes.
- Prefer
tag add and tag remove when only tag mutation is needed.
Example Prompts
- - "Use $wallabag to save https://example.com with tags ai,read-later"
- "Use $wallabag to list starred entries tagged tech"
- "Use $wallabag to remove tag inbox from entry 123"
References
Read API specifics from references/wallabag-api.md when endpoint details are needed.
Wallabag
概述
使用此技能通过确定性 shell 命令操作 Wallabag 实例的 API。将凭据保存在环境变量中，切勿硬编码密钥。
运行时要求
- - 必需二进制文件：bash、curl
- tag add 和 tag remove 命令需要：jq
必需环境变量
运行命令前设置以下变量：
- - WALLABAGBASEURL
- WALLABAGCLIENTID
- WALLABAGCLIENTSECRET
- WALLABAGUSERNAME
- WALLABAGPASSWORD
示例：
bash
export WALLABAGBASEURL=https://wallabag.example.com
export WALLABAGCLIENTID=...
export WALLABAGCLIENTSECRET=...
export WALLABAG_USERNAME=...
export WALLABAG_PASSWORD=...
命令接口
主命令：
bash
scripts/wallabag.sh <子命令> [选项]
子命令：
- - auth [--show-token]
- list [--search <文本>] [--tag <名称>] [--archive 0|1] [--starred 0|1] [--page <页码>] [--per-page <每页数量>]
- get --id <条目ID>
- create --url <网址> [--title <标题>] [--tags 标签1,标签2]
- update --id <条目ID> [--title <标题>] [--tags 标签1,标签2] [--archive 0|1] [--starred 0|1]
- delete --id <条目ID>
- tag add --id <条目ID> --tags 标签1,标签2
- tag remove --id <条目ID> --tag 标签
工作流程
- 1. 运行 auth 验证 OAuth 凭据。
- 使用 create 添加书签。
- 使用 list 和 get 检索书签。
- 使用 update 或 tag 命令调整元数据。
- 仅在需要删除时使用 delete。
操作规则
- - 令牌仅保留在进程内存中。不要将令牌状态持久化到磁盘。
- 除非显式传递 --show-token，否则 auth 不会打印访问令牌。
- 尽可能保持 JSON 输出不变。
- 在 stderr 上输出可操作错误信息，并返回非零退出码。
- 仅需修改标签时，优先使用 tag add 和 tag remove。
示例提示
- - 使用 $wallabag 保存 https://example.com，标签为 ai,read-later
- 使用 $wallabag 列出标记为 tech 的星标条目
- 使用 $wallabag 从条目 123 中移除标签 inbox
参考
需要端点详情时，请从 references/wallabag-api.md 中读取 API 具体信息。
