详细分析 ▾
运行时依赖
版本
slbrow-skills 初始版本,通过 SLBrow MCP 和 HTTP API 实现浏览器自动化。- 提供 MCP 浏览器插件和直接 curl API 方法的详细使用说明。- 列出所有可用的浏览器自动化工具,包括导航、标签页管理、内容提取和浏览器历史搜索。- 包含 VAI (Seelink) 工具,用于对网页上的媒体播放器应用 AI 功能。- 提供全面的工作流模式、故障排除技巧和 Windows PowerShell curl 命令指南。- 添加快速参考和错误处理指导,以实现更流畅的操作和调试。
安装命令
点击复制技能文档
浏览器端 AI 助手技能。浏览器插件 (aiassist) 通过 MCP 协议连接到 slbrow-mcp;这些技能指导何时以及如何使用这些工具。
可通过 MCP 工具或直接使用 curl 调用 HTTP API。
前置条件
- SLBrow 服务器运行中:在
ai/slbrowmcp/slbrow-mcp/目录下执行npx slbrow或npm start - 浏览器扩展已安装并连接(Chrome/Firefox)
- MCP 插件在 aiassist 中启用:
http://127.0.0.1:5556/mcp(视联浏览器MCP),http://127.0.0.1:5556/vaimcp(视联视频AI MCP) - 默认端口:HTTP 5556,WebSocket 5555
使用方法
方法 1:MCP 工具(浏览器插件 + MCP)
启用 MCP 插件后,AI 可以访问浏览器工具。使用这些技能来指导工具选择和工作流:
- 导航:使用
page_navigate打开 URL - 分析:提取前使用
page_analyze配合 intent_hint(article、form submit、post_create) - 标签页:先使用
tab_list,然后传递tab_id定位特定标签页
方法 2:使用 curl 的 HTTP API(直接控制)
始终可用 - 使用 curl 命令直接控制浏览器,无需 MCP 插件依赖:
基本格式(PowerShell 友好——无需临时 JSON 文件):
curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{"tool":"TOOL_NAME","args":{"PARAM":"VALUE"}}'
Windows PowerShell 重要说明:
- 使用
curl.exe而非curl(PowerShell 将curl别名为Invoke-WebRequest) - 将 JSON 主体放在
-d '...'中,整个参数用单引号包裹;在 JSON 中对每个双引号使用反斜杠转义(\")。这样 shell 可以将有效 JSON 传递给 curl,无需使用--data-binary @file
常用 curl 示例:
# 创建新标签页并导航 curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{"tool":"tab_create","args":{"url":"https://www.163.com"}}'# 导航当前标签页 curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{"tool":"page_navigate","args":{"url":"https://www.example.com"}}'
# 列出所有标签页 curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{"tool":"tab_list","args":{}}'
# 分析页面内容 curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{"tool":"page_analyze","args":{"intent_hint":"article"}}'
# 提取文章内容 curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{"tool":"page_extract_content","args":{"content_type":"article"}}'
# 关闭特定标签页 curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{"tool":"tab_close","args":{"tab_id":1234567890}}'
# 搜索浏览器历史 curl.exe -X POST http://localhost:5556/api/execute -H 'Content-Type: application/json' -d '{"tool":"get_history","args":{"keywords":"search term","max_results":10}}'
响应格式:
API 返回包含 success、tool、result 和 formatted 字段的 JSON,便于解析。
可用工具
| 工具 | 描述 |
|---|---|
page_navigate | 导航当前标签页到指定 URL |
page_analyze | 分析页面元素(intent_hint:article、form submit、post_create 等) |
page_extract_content | 提取内容(content_type:article、search_results、posts) |
page_wait_for | 等待元素或文本出现(condition_type、selector、text) |
tab_create | 创建标签页(url、urls[] 或 count) |
tab_close | 关闭标签页(tab_id、tab_ids[]) |
tab_list | 列出打开的标签页及 ID |
get_history | 搜索浏览器历史(keywords、start_date、end_date、domains、max_results) |
get_selected_text | 获取选中文本(可选 tab_id) |
get_page_links | 获取页面链接(link_type:all/internal/external、domains、max_results) |
VAI 工具(Seelink)
| 工具 | 描述 |
|---|---|
get_page_seelink_player_list | 获取当前页面上的所有播放器 |
use_seelink_players_ai | 对播放器应用 AI 功能(ai_function_name:reduce_fog、face_mosaic、dark_reduce、human_outline、vechicle_outline、none) |
工作流模式
多标签页工作流:
- 使用
tab_list获取标签页 ID - 向任何工具添加
tab_id以定位后台标签页
内容提取:
- 使用
page_navigate导航到目标 URL - 使用
page_analyze配合 intent_hint 查找元素 - 使用
page_extract_content提取 article/search_results/posts
表单填写:
- 使用
page_analyze配合 intent_hint "form submit" 发现表单元素 - 记下返回的元素 ID——在后续的
page_analyze或page_extract_content中使用它们来确认状态
VAI(Seelink 播放器 AI):
- 使用
get_page_seelink_player_list获取播放器 ID 和数量 - 通过
player_position_list(从零开始的索引)或player_id_list选择目标(不要同时使用两者) - 使用选择的目标和
ai_function_name调用use_seelink_players_ai - 要对不同播放器应用不同功能,请分别为每个播放器调用
use_seelink_players_ai - 要在播放器上禁用 AI,将
ai_function_name设置为"none"
在浏览器中获取技能
浏览器插件可以从服务器获取技能并注入 AI 上下文:
GET http://127.0.0.1:5556/api/skills
返回完整的 SKILL.md 内容(text/markdown)。当 slbrow MCP 插件启用时使用,以指导工具使用。
API 参考
完整参数模式请参阅 references/api-reference.md。
其他资源
- 单页工作流检查清单:SKILL_COMPACT.md
错误处理
EXTENSION_DISCONNECTED:确保扩展已安装且服务器正在运行。首先检查http://localhost:5556/health。Tool call timeout:操作超时 >30s;使用更简单的参数重试或拆分为更小的步骤。page_analyze返回 0 个元素:页面可能仍在加载——稍等片刻后重试,或重新执行page_navigate。tab_id无效(标签页已关闭):重试前调用tab_list刷新可用的标签页 ID。- 服务器重启(会话丢失):客户端将收到 404;重新初始化 MCP 连接(刷新页面)。
curl 命令快速参考
标签页管理:
- 创建标签页:使用
url参数的tab_create - 列出标签页:使用空参数的
tab_list - 关闭标签页:使用
tab_id参数的tab_close - 导航:使用
url参数的page_navigate
内容分析:
- 分析页面:使用
intent_hint(article、form_submit、post_create)的page_analyze - 提取内容:使用
content_type(article、search_results、posts)的page_extract_content - 获取链接:使用
link_type(all、internal、external)的get_page_links
历史和文本:
- 搜索历史:使用
keywords、max_results的get_history - 获取选中文本:使用可选
tab_id的get_selected_text
Seelink AI:
- 获取播放器:
get_page_seelink_player_list - 应用 AI:使用
player_position_list或player_id_list以及ai_function_name的use_seelink_players_ai
故障排除
服务器无响应:
- 检查 SLBrow 服务器是否运行:
curl.exe http://localhost:5556/health - 确认服务器已通过
npx slbrow或npm start启动
curl 命令失败:
- 确保在 PowerShell 中使用
curl.exe - 对于
-d,使用单引号包裹的 JSON,每个 JSON 字符串分隔符使用\"(参见上方方法 2示例) - 确认服务器在端口 5556 可访问
标签页操作不工作:
- 首先使用
tab_list获取当前标签页 ID - 验证 tab_id 有效且标签页仍然存在
- 检查浏览器扩展是否已连接