SuperAPI AI 工具集

obsidian-web-clipper

办公与效率

查看项目

更新于 10-16 07:24

技能介绍

用途:帮助用户创建、导入或调试 Obsidian Web Clipper 模板。该浏览器扩展把网页内容保存为 Obsidian 库中的 Markdown 笔记,模板以 JSON 配置,定义抓取哪些元数据、如何格式化笔记以及自动匹配哪些站点。模板可单独导入导出,也可整份设置备份导入导出;生成模板时应输出可直接导入的合法 JSON。

主要能力:处理 JSON 字段、行为、变量、过滤器、逻辑、属性与触发器;支持选择器、schema 与解释器变量;可把 AI 提示词改写为解释器变量;提供可导入的完整示例。

使用方式:先了解用户库的约定,包括库级文档(CLAUDE.md、AGENTS.md、README)、已有模板文件夹、同类示例笔记、此前导出的 clipper 设置文件,以及 YAML 属性排序配置(如 Linter)。若库有属性排序,模板 properties 数组应镜像该顺序。约定不可知或用户不确定时,采用最小化的中立选择,并标注所做假设。交付前逐项检查 map、template 与 replace 链的过滤器与转义陷阱;若用户可访问扩展,先让其试导入 JSON 再继续迭代;迭代时一次只改一处,便于定位解析错误。

限制:单页范围,一次剪藏只能看到触发页面的 DOM,扩展不是智能体,不能爬取、跟随链接或访问其他 URL;选择器、schema 与解释器变量都只针对该页面解析,跨页数据无法在一次剪藏中收集。注意:完整设置导出会以明文包含解释器 API 密钥(interpreter_settings.providers[].apiKey),不要引用,并提醒用户勿将其存入版本控制。模板解析错误在导入前是静默的,导入报错信息通常很简略。

参考:模板语法见 references/template-syntax.md,完整示例与提示词改写见 references/article-template.md;更全的过滤器签名、预设变量列表与 schema 变量边界情况可查阅 clipper 仓库 docs/ 与官方 Obsidian 帮助文档的 Web Clipper 部分,官方人类可读文档为 https://obsidian.md/help/web-clipper(子页 /filters、/logic 等),该站为 JS 渲染,直接抓取会得到空壳,建议从 GitHub 读取。