SmartClip 系列教程之三:给你的 AI Agent 也配上剪藏插件

大家好,我是麦可。
今天给大家介绍一个比较牛的特性,可以解放双手,让你的 AI Agent 来操作 SmartClip 完成网页剪藏。
大家可能或多或少已经用过 WebFetch、Playwright、Firecrawl、Scrapling、jina、Agent Reach 这些网页抓取工具。
我找到了一篇知乎文章,文章对这些工具做了一些对比分析,这里就不赘述了,你可以通过下面这篇原文来了解:Claude Code 网页抓取5种方案深度对比:从螺丝刀到装修公司的选型指南 - 知乎
直接给结论:以上这些网页抓取工具要么可能不支持某些网页,要不抓取数据不全,要么抓取的数据有干扰,要么按次数按 token 收费。
SmartClip 绝对是你更好的选择,因为在剪藏这一块专业强大,专为剪藏而生。只要你的浏览器安装了这个插件,在浏览器上你能手动剪藏的网页就能给你自动抓取到。不仅能抓取到数据,还能帮你保存到你指定的笔记软件中,例如 Notion、Obsidian、思源笔记、flomo、飞书、Joplin 等等。
虽然 SmartClip 绝大部分功能都是免费的,但是这个 AI Agent 剪藏功能是会员功能,我相信对于一些对自己有帮助的体验好的产品大家是愿意付费支持的,而且付费支持能激励我在 SmartClip 上持续投入开发更多好用的功能。
目前 SmartClip 还没有上线支付功能,如需购买会员需添加我的个人微信购买,目前提供早鸟特惠买断制会员方案,对于早鸟的优惠价是人民币 168 元,添加微信时请备注:"SmartClip早鸟购买"。
您也可以通过在【谷歌商店的 SmartClip 评论区】留下 您使用过程中觉得最好用的功能或者体验并打出五星好评,需要真实有价值不要违背意愿哈。然后截图在公众号后台私信给我,我会根据留言的价值赠送您月卡、季卡,及其真实有触动的也可赠送年卡。
我相信能打动我的,说明真的帮到您了,这样的评论就像付费支持一样,能够给我精神层面的激励。
配置方式
一、打开 SmartClip MCP 开关
安装最新版本的 SmartClip 插件(v0.2.1,版本最低需 >= v0.1.2),打开插件设置页-【通用配置】-【开启 MCP 服务】。点击这里的【复制 Token】,配置 MCP 时需要用到。

二、SmartClip-MCP 配置
参考下面这段代码,将插件中复制的 token 作为 your-secret-token 复制粘贴到您的 AI Agent 的 MCP 配置文件中,Claude Code、OpenCode、Gemini、Cursor 这些工具也同样适用。
{
"mcpServers":{
"smartclip":{
"command":"npx",
"args":["-y","smartclip-mcp"],
"env":{
"SMARTCLIP_MCP_SESSION_TOKEN":"your-secret-token"
}
}
}
}注意:当前 smartclip-mcp 会绑定
18365端口,且仅支持一对一连接,如果你用 Claude Code 连接了 MCP,那你的 OpenClaw 就连不了了,需要关闭其中一个。
三、安装 SmartClip Skills
在终端执行以下命令:
npm install -g smartclip-agent-extension切换到你的项目工作目录,执行下面这个命令会进入交互式安装的引导:
smartclip-agent-extension交互式安装
🚀 SmartClip Agent Skills 安装向导
请选择安装范围:
[1] 全局安装 - 安装到用户主目录 (推荐)
Mac/Linux: ~/.agents/skills 等
Windows: %USERPROFILE%\.agents\skills 等
[2] 项目安装 - 安装到当前项目目录
当前目录: /path/to/your/project
[q] 退出
请选择 (默认: 1):选择范围后,会继续提示选择目标目录:
请选择要安装到的目录(输入序号,多个用逗号分隔):
[1] Standard (.agents/skills) (默认)
推荐 - 标准通用目录
[2] Claude Code (.claude/skills)
Claude Code 客户端
[3] Gemini CLI (.gemini/skills)
Gemini CLI 客户端
[a] 全部安装
[q] 退出
请选择 (默认: 1):非交互模式
# 全局安装(推荐)
smartclip-agent-extension --global
# 项目安装
smartclip-agent-extension --project
# 全局安装到默认目录
smartclip-agent-extension --global --default
# 项目安装到所有目录
smartclip-agent-extension --project --all
# 指定范围和目录
smartclip-agent-extension --global --targets .agents/skills,.claude/skills全局安装路径:
-
Mac/Linux:
~/.agents/skills,~/.claude/skills,~/.gemini/skills -
Windows:
%USERPROFILE%\.agents\skills,%USERPROFILE%\.claude\skills,%USERPROFILE%\.gemini\skills
项目安装路径:
- 当前目录下的
.agents/skills,.claude/skills,.gemini/skills
确认安装结果
检查您的技能目录(根据你的选择)是否出现以下技能:
-
smartclip-read— 获取网页剪藏内容(给当前上下文用) -
smartclip-save— 获取网页剪藏内容,保存到笔记库 -
smartclip-daily— 批量处理任务池内容(结合 NotionMpClipper 或者 ObClipper 使用场景) -
smartclip-troubleshooting— 排查配置连接问题
四、验证可用性
验证 MCP 连接
如果你是给 Claude Code 安装的,并且是安装到具体项目中,就在项目目录打开 Claude Code。然后输入 /mcp 后回车:
/mcp
验证技能是否可用
输入 /skills 后回车:
/skills
验证 smartclip-read 网页抓取
通过 smartclip-read + 网页链接来抓取网页内容:
/smartclip-read https://sspai.com/post/108047
验证 smartclip-save 网页剪藏
通过 smartclip-save + 网页链接来剪藏网页内容保存到笔记:
/smartclip-save https://sspai.com/post/108047
检查 Obsidian 中是否保存成功:

smartclip-daily 是处理任务池批量剪藏的,这个任务池目前是给移动端的 NotionMpClipper 和 ObClipper 剪藏用户联动使用的,后续可能会扩展支持其他自动批量剪藏场景,例如用户的各类平台收藏夹等等,后面再录视频讲解。
smartclip-troubleshooting 是辅助排查问题的,不过我试了一下,目前没有那么复杂需要用这个辅助排查,大家遇到问题了可以输入 /smartclip-troubleshooting 试试。
五、常见问题
Agent 剪藏功能当前刚发布出来,还处于 beta 状态,你在使用过程中可能会遇到一些问题,这里列举一些常见问题供参考,也欢迎你通过 faq@smartclip.app 反馈问题给我。
Q1:是不是有点费 token?
确实有一点,没有包月套餐的话还是手工剪藏好。
Q2:为什么会连接失败?
token 不要填错了或者漏填。
如果浏览器长时间闲置,连接可能会断开,可以在插件中关闭开关后重新打开。
目前同时只能连接一个 MCP 客户端,如果 OpenClaw 连接了,那 Claude Code 就连不上,需关闭其中一个。
可以在插件的 MCP 开关下方查看失败原因。
Q3:有没有通用的解决连接问题的方案?
如果你第一次连接上了,后续出现连接失败的话,一般来说,重启可以解决你的问题:
把插件的 MCP 开关关闭重新打开。
把连接过 MCP 的客户端都关闭,重新打开你的客户端。
Q4:OpenClaw 和国产龙虾们怎么配置?
把这篇文章链接给你的龙虾,让他帮你配就好了。
感谢每一位用户的支持与反馈,让 SmartClip 越来越好!
SmartClip — 让知识管理更高效