核心用法
YoudaoNote Clip 是一款专注于高成功率网页剪藏的自动化技能,通过三级路由策略适配不同站点特性:
- 路径 A(Twitter):调用 Apify 服务抓取推文元数据与内容
- 路径 B(国内快速站点):知乎、公众号、掘金等支持服务端直接抓取的站点,优先走轻量化流程
- 路径 C(通用浏览器提取):默认路径,使用浏览器自动化提取页面内容,失败时自动降级为
web_fetchMarkdown 抓取
关键约束:
- 严禁并发:多 URL 必须串行处理,确保每篇完整保存后再处理下一篇
- 先响应后执行:收到请求立即回复"正在保存中..."
- 路径 C 不可跳过:browser 提取为强制首步,禁止直接用 web_fetch 替代
显著优点
1. 可靠性优先设计:多级降级机制(浏览器 → web_fetch)确保极端场景仍可保存
2. 站点精细化适配:针对 Twitter 单独设计 Apify 链路,国内主流内容平台走优化路径
3. 调试可追溯:完整日志体系(按 key 分目录存储),支持 YOUDAONOTE_CLIP_DEBUG 环境变量开启调试
4. 响应规范化:固定 Markdown 表格格式输出,包含标题、来源、时间三要素
潜在局限
- 速度牺牲可靠性:串行处理导致批量剪藏效率受限
- 外部依赖较重:需配置
YOUDAONOTE_API_KEY、APIFY_API_TOKEN,且依赖 Node.js、jq、mcporter 等二进制工具 - 浏览器资源占用:路径 C 需启动浏览器实例,在资源受限环境可能超时
- 内容完整性风险:降级至 web_fetch 时,动态渲染内容(SPA、懒加载)可能丢失
适合人群
- 有道云笔记重度用户,追求"保存成功"而非"保存最快"
- 需要批量归档参考文章、研究资料的知识工作者
- 技术内容消费者(Twitter 技术讨论、知乎/掘金技术文章)
常规风险
- Token 泄露:
APIFY_API_TOKEN和有道 API Key 需妥善保管 - 剪藏内容版权:自动保存可能涉及未经授权的内容分发
- 服务可用性:Apify、有道云服务故障将中断特定路径
- 隐私数据:剪藏页面可能含敏感个人信息,存储至云端笔记需合规考量