# Youdaonote Clip

> 当用户想要"剪藏网页"、"保存文章到有道云笔记"、"clip 链接"、"收藏网页"、"把这个网址存到笔记"、"查看最近收藏"、"recent 笔记"时，使用此 skill。

- **Type:** Skill
- **Install:** `agentstack add skill-hviktortsoi-youdaonote-claude-skills-youdaonote-clip`
- **Verified:** Pending review
- **Seller:** [HViktorTsoi](https://agentstack.voostack.com/s/hviktortsoi)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [HViktorTsoi](https://github.com/HViktorTsoi)
- **Source:** https://github.com/HViktorTsoi/youdaonote-claude-skills/tree/main/skills/youdaonote-clip

## Install

```sh
agentstack add skill-hviktortsoi-youdaonote-claude-skills-youdaonote-clip
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 有道云笔记 · 网页剪藏 Skill

## 前置条件

使用前确认 CLI 已安装并配置好 API Key：

```bash
# 安装 CLI（macOS/Linux）
curl -fsSL https://artifact.lx.netease.com/download/youdaonote-cli/install.sh | bash

# 配置 API Key（从 https://mopen.163.com/#/dashboard 获取）
youdaonote config set apiKey YOUR_API_KEY

# 验证
youdaonote recent
```

## 安装信息

| 项目 | 路径 |
|------|------|
| CLI 二进制 | `~/.local/bin/youdaonote` |
| 配置文件 | `~/.youdaonote.json` |
| PATH 配置 | 安装脚本自动写入 `~/.zshrc`，新终端生效 |

> 若当前终端尚未 source `~/.zshrc`，请用完整路径调用：`~/.local/bin/youdaonote `

## 主要操作

### 剪藏网页

```bash
# 基本剪藏
youdaonote clip "https://example.com/article"

# 剪藏到指定目录（需要目录 ID）
youdaonote clip "https://example.com/article" -f 

# 保存剪藏原始 HTML 数据到本地文件
youdaonote clip-save --file result.json
```

### 查看最近收藏

```bash
# 查看最近 15 条收藏
youdaonote recent

# 查看最近 N 条收藏
youdaonote recent -l 30

# 以 JSON 格式输出
youdaonote recent -c
```

## 工作流程

1. 用户提供网址 → 运行 `youdaonote clip "URL"` 执行剪藏
2. 用户要查看收藏 → 运行 `youdaonote recent` 列出最近收藏
3. 如剪藏失败（网络超时等）→ 告知用户可设置环境变量 `YOUDAONOTE_MCP_TIMEOUT=120` 增大超时时间
4. 如遇到 URL 含 `&` 字符 → 提醒用户用引号包裹 URL

## 错误处理

- `API Key 未配置`：引导用户运行 `youdaonote config set apiKey YOUR_API_KEY`
- `命令未找到`：先尝试完整路径 `~/.local/bin/youdaonote`，若仍失败则重新安装 CLI
- `剪藏失败`：检查网络、确认 URL 可访问、尝试增大超时

## 环境变量

| 变量 | 说明 | 示例 |
|------|------|------|
| `YOUDAONOTE_API_KEY` | API 密钥（优先级高于 config） | `export YOUDAONOTE_API_KEY="xxx"` |
| `YOUDAONOTE_MCP_TIMEOUT` | 请求超时秒数（默认 60） | `export YOUDAONOTE_MCP_TIMEOUT=120` |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [HViktorTsoi](https://github.com/HViktorTsoi)
- **Source:** [HViktorTsoi/youdaonote-claude-skills](https://github.com/HViktorTsoi/youdaonote-claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-hviktortsoi-youdaonote-claude-skills-youdaonote-clip
- Seller: https://agentstack.voostack.com/s/hviktortsoi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.