核心用法
YoudaoNote Clip 是一款专注于网页内容永久保存的 Agent Skill,通过触发词「剪藏网页」「保存网页」「收藏网页」激活。该技能采用三级路由智能判断机制:路径 A 专用于 Twitter/X 推文(通过 Apify API 提取),路径 B 覆盖知乎、公众号、掘金等国内主流内容平台(服务端直接抓取),路径 C 作为通用兜底方案(浏览器动态渲染提取)。所有路径最终 converged 到统一的 clip-note.sh 执行层,将结构化数据通过 MCP SSE 协议推送至有道云笔记服务。
使用时仅需提供目标 URL,Skill 会自动选择最优提取策略。对于 SPA 单页应用、懒加载图片、JS 动态生成的内容,路径 C 的浏览器注入方案(inject-sdk.fn.js)可确保内容完整性。技能强制串行执行,同一请求中的多个 URL 将逐个处理,以稳定性为首要目标。
显著优点
可靠性设计突出:三级降级机制(快速路径 → 浏览器提取 → web_fetch 兜底)确保极端场景下仍可获取内容;图片下载配置 50MB 上限和 15 秒超时,防止资源滥用;调试模式完整脱敏,不记录敏感内容。
安全编码规范:零外部 npm 依赖,仅使用 Node.js 内置模块(https/fs/crypto 等),彻底规避依赖树攻击风险;敏感信息(YOUDAONOTE_API_KEY、APIFY_API_TOKEN)全部通过环境变量注入,无硬编码风险;浏览器注入脚本为本地内联代码,不加载外部 CDN。
平台适配深度:针对 Twitter/X 单独维护 Apify 集成方案,针对国内内容生态优化服务端抓取策略,技术债务可控。
潜在缺点与局限性
不支持并发处理:多 URL 场景下必须串行执行,批量剪藏效率受限。第三方服务依赖:Apify 服务可用性直接影响 Twitter 内容获取,有道云 MCP 服务状态决定保存成败。图片安全风险:任意 URL 图片下载虽有限速限容,但仍可能接触恶意资源。浏览器注入透明度:虽然仅读取 DOM 不修改页面,但代码注入行为本身对部分用户可能敏感。
适合的目标群体
- 有道云笔记深度用户,需要系统化沉淀网络阅读内容
- 研究人员、记者、自媒体从业者,依赖网页存档建立知识库
- 技术团队需将网页剪藏集成到自动化工作流(配合
mcporterCLI 工具) - 对数据本地化处理无强制要求、接受云端存储方案的隐私不敏感用户
使用风险
网络稳定性风险:Apify API 调用、有道 MCP SSE 连接、图片下载均涉及外部网络请求,任一环节超时或失败将导致剪藏中断。API 密钥管理:YOUDAONOTE_API_KEY 和 APIFY_API_TOKEN 需用户自行在 OpenClaw 配置中维护,密钥泄露将导致云端数据暴露。内容隐私边界:剪藏内容上传至有道云笔记第三方服务器,敏感信息不宜通过此 Skill 处理。调试日志泄露:开启 YOUDAONOTE_CLIP_DEBUG 后,URL、标题等元数据将写入本地文件系统,共享环境需谨慎。服务变更风险:Apify Actor 或有道云笔记 API 格式调整可能导致功能失效,需关注社区更新。