PicSee Short Link
URL shortener with QR code generation, analytics charts, and link management via CLI.
Works with any agent that can run shell commands (OpenClaw, Claude Code, Codex, etc.).
CLI Path
CODEBLOCK0
For brevity, examples below use picsee as alias.
Quick Reference
Shorten a URL
CODEBLOCK1
Analytics
CODEBLOCK2
Generate Analytics Chart
picsee chart mylink
Fetches analytics and returns a QuickChart URL visualizing daily clicks.
Generate QR Code
CODEBLOCK4
List Links
CODEBLOCK5
INLINECODE1 queries backward from that time (default: now). Use the END of the period, e.g. 2026-03-31T23:59:59 for March 2026.
Edit a Link
picsee edit mylink --url "https://new-destination.com"
picsee edit mylink --slug newslug --title "New Title" --tags a,b,c
Requires Advanced plan.
Delete / Recover
CODEBLOCK7
Authentication
picsee auth <token>
picsee auth-status
Token source: https://picsee.io → avatar → Settings → API → Copy token.
Help
picsee help
Full Options
shorten
| Flag | Description |
|---|
| INLINECODE4 | Custom slug (3-90 chars) |
| INLINECODE5 |
Short link domain (default:
pse.is) |
|
--title <title> | Preview title (Advanced plan) |
|
--desc <desc> | Preview description (Advanced plan) |
|
--image <url> | Preview thumbnail (Advanced plan) |
|
--tags t1,t2 | Comma-separated tags (Advanced plan) |
|
--utm s:m:c:t:n | UTM params — source:medium:campaign:term:content |
list
| Flag | Description |
|---|
| INLINECODE13 | Query backward from this time (default: now) |
| INLINECODE14 |
Results per page (1-50, default 50) |
|
--keyword <kw> | Search title/description (Advanced, 3-30 chars) |
|
--tag <tag> | Filter by tag (Advanced) |
|
--url <url> | Filter by exact destination URL |
|
--slug <slug> | Filter by exact slug |
|
--starred | Starred links only |
|
--api-only | API-generated links only |
|
--cursor <mapId> | Pagination cursor |
edit
| Flag | Description |
|---|
| INLINECODE23 | New destination URL |
| INLINECODE24 |
New slug |
|
--domain <domain> | New domain |
|
--title <title> | New preview title |
|
--desc <desc> | New preview description |
|
--image <url> | New preview thumbnail |
|
--tags t1,t2 | New tags |
|
--expire <iso> | Expiration time (ISO 8601) |
Auth Modes
| Mode | API Host | Features |
|---|
| Unauthenticated | INLINECODE31 | Create short links only |
| Authenticated |
api.pics.ee | Create + analytics + list + search + edit + delete |
Auto-detected: if encrypted token exists at ~/.openclaw/.picsee_token, authenticated mode is used.
Security
- - Token encryption: AES-256-CBC, IV stored alongside ciphertext
- Key derivation:
SHA-256(random-salt + hostname + "-" + username) — the 32-byte random salt is generated once and stored at ~/.openclaw/.picsee_salt (mode 0600), making the key unpredictable even if hostname/username are known - File permissions:
0600 on both token and salt files
Agent Recipes (Post-Processing)
Download QR Code as Image
After picsee qr, download and send the image:
CODEBLOCK10
Send via message tool with filePath: "~/.openclaw/workspace/skills/picsee-short-link/tmp/<ENCODE_ID>_qr.png".
Download Chart as Image
After picsee chart, download and send the image:
CODEBLOCK11
Send via message tool with filePath: "~/.openclaw/workspace/skills/picsee-short-link/tmp/<ENCODE_ID>_chart.png".
PicSee 短链接
支持二维码生成、分析图表,并通过命令行界面管理链接的短网址工具。
适用于任何可运行 shell 命令的智能体(OpenClaw、Claude Code、Codex 等)。
CLI 路径
node ~/.openclaw/workspace/skills/picsee-short-link/cli/dist/cli.js
为简洁起见,以下示例使用 picsee 作为别名。
快速参考
缩短 URL
bash
picsee shorten https://example.com/long-url
picsee shorten https://example.com --slug mylink
picsee shorten https://example.com --slug mylink --domain pse.is --title 我的标题 --tags seo,marketing
分析
bash
picsee analytics mylink
生成分析图表
bash
picsee chart mylink
获取分析数据并返回可视化每日点击量的 QuickChart URL。
生成二维码
bash
picsee qr https://pse.is/mylink
picsee qr https://pse.is/mylink --size 500
列出链接
bash
picsee list
picsee list --limit 10
picsee list --start 2026-03-31T23:59:59 --keyword campaign
picsee list --tag seo --starred
--start 从该时间点向前查询(默认:当前时间)。请使用时间段结束时间,例如查询 2026 年 3 月使用 2026-03-31T23:59:59。
编辑链接
bash
picsee edit mylink --url https://new-destination.com
picsee edit mylink --slug newslug --title 新标题 --tags a,b,c
需要高级版。
删除 / 恢复
bash
picsee delete mylink
picsee recover mylink
身份验证
bash
picsee auth
picsee auth-status
获取 Token:https://picsee.io → 头像 → 设置 → API → 复制 Token。
帮助
bash
picsee help
完整选项
shorten
| 标志 | 说明 |
|---|
| --slug <slug> | 自定义短码(3-90 个字符) |
| --domain <domain> |
短链接域名(默认:pse.is) |
| --title | 预览标题(高级版) |
| --desc | 预览描述(高级版) |
| --image | 预览缩略图(高级版) |
| --tags t1,t2 | 逗号分隔的标签(高级版) |
| --utm s:m:c:t:n | UTM 参数 — 来源:媒介:活动:关键词:内容 |
list
| 标志 | 说明 |
|---|
| --start <time> | 从该时间点向前查询(默认:当前时间) |
| --limit <n> |
每页结果数(1-50,默认 50) |
| --keyword | 搜索标题/描述(高级版,3-30 个字符) |
| --tag | 按标签筛选(高级版) |
| --url | 按目标 URL 精确筛选 |
| --slug | 按短码精确筛选 |
| --starred | 仅显示星标链接 |
| --api-only | 仅显示 API 生成的链接 |
| --cursor | 分页游标 |
edit
| 标志 | 说明 |
|---|
| --url <url> | 新的目标 URL |
| --slug <slug> |
新的短码 |
| --domain | 新的域名 |
| --title | 新的预览标题 |
| --desc | 新的预览描述 |
| --image | 新的预览缩略图 |
| --tags t1,t2 | 新的标签 |
| --expire | 过期时间(ISO 8601 格式) |
认证模式
| 模式 | API 主机 | 功能 |
|---|
| 未认证 | chrome-ext.picsee.tw | 仅创建短链接 |
| 已认证 |
api.pics.ee | 创建 + 分析 + 列表 + 搜索 + 编辑 + 删除 |
自动检测:如果加密 Token 存在于 ~/.openclaw/.picsee_token,则使用认证模式。
安全性
- - Token 加密:AES-256-CBC,IV 与密文一同存储
- 密钥派生:SHA-256(随机盐值 + 主机名 + - + 用户名) — 32 字节随机盐值仅生成一次,存储在 ~/.openclaw/.picsee_salt(权限 0600),即使主机名/用户名已知,密钥也无法预测
- 文件权限:Token 和盐值文件均为 0600
智能体操作指南(后处理)
下载二维码图片
执行 picsee qr 后,下载并发送图片:
bash
mkdir -p ~/.openclaw/workspace/skills/picsee-short-link/tmp
curl -s -o ~/.openclaw/workspace/skills/picsee-short-link/tmp/ID>qr.png
通过 message 工具发送,参数为 filePath: ~/.openclaw/workspace/skills/picsee-short-link/tmp/ID>qr.png。
下载图表图片
执行 picsee chart 后,下载并发送图片:
bash
mkdir -p ~/.openclaw/workspace/skills/picsee-short-link/tmp
curl -s -o ~/.openclaw/workspace/skills/picsee-short-link/tmp/ID>chart.png
通过 message 工具发送,参数为 filePath: ~/.openclaw/workspace/skills/picsee-short-link/tmp/ID>chart.png。