Skip to content

Web Clipper Adapter

Web Clipper adapter 是未命中专用来源时的通用路径,用于从普通网页抽取标题、来源、摘要和正文线索,再导入 Notion 或 Obsidian。

Extraction rules

RuleDescription
Host filtering排除搜索、邮箱、localhost 等不适合剪藏的页面
Title extraction优先使用页面标题和 Open Graph / Twitter meta
Summary extraction从 meta description、正文段落和可见文本中生成摘要
Charset handling按响应头、HTML meta、回退编码尝试解码
Noise cleanup去除 script、style、noscript、template 等噪声

Metadata fields

FieldMeaning
title网页标题
url当前页面 URL
site域名或站点名
excerpt摘要
charset推断编码
capturedAt捕获时间

normalized schema mapping

Source fieldnormalizedContent fieldDestination
location.hrefidentity.url链接
document title / meta titlecontent.title标题
meta description / paragraphcontent.excerpt摘要
visible textcontent.bodyMarkdown / Notion Blocks
hostnamemetadata.sourceSite来源站点

fallback behavior

Failurefallback behavior
页面禁止访问只保留标题和 URL
charset 解码失败使用 UTF-8 结果并提示可能乱码
正文抽取为空导出 metadata-only 条目
Notion 写入失败保留预览,不伪造成功
Obsidian API 不可达提示检查 Local REST API

Known limitations

  • 动态渲染页面可能缺少可抽取正文。
  • 需要登录的内容通常只能抽取当前 DOM 可见部分。
  • 通用抽取无法保证像专用 adapter 一样保留全部结构。