使用说明
ZenLink MCP
通过ZenLink实现浏览器自动化的MCP服务器——通过Zen浏览器(基于Firefox)为Claude Desktop和其他MCP客户端提供原生浏览器控制。
v2.0.0版本 发布了约50种用于并行代理工作的新工具:真正的多标签并行、标签卸载器防御、会话保存/恢复、可读性+Markdown提取、请求拦截、Cookie/存储和编排原语(广播、同步屏障、标签池、命名标签)。看 更改日志.md 查看完整列表。
安装
pip install zenlink-mcp
需求
- ZenLink浏览器扩展 v2.0.0版本+ 安装在Zen浏览器中
- ZenLink桥运行(
python native/bridge.py)
刀具表面(75+刀具)
下面的每个标签感知工具都接受一个可选 tab_id 参数——将其传递给驱动特定选项卡而不窃取焦点,这是并行多选项卡工作的基础。
核心
zen_status, zen_health, zen_tabs, zen_new_tab, zen_close_tab, zen_switch_tab, zen_navigate, zen_screenshot
内容提取(一次阅读,成本低廉)
zen_page_text, zen_page_info, zen_readability, zen_markdown, zen_query, zen_html, zen_links, zen_images, zen_meta, zen_structured_data, zen_bounds, zen_computed_style, zen_dom, zen_forms, zen_iframes, zen_explain_selector, zen_full_page_metrics
交互
zen_click, zen_trusted_click, zen_double_click, zen_type, zen_fill, zen_form_fill, zen_set_editable_content, zen_select_option, zen_check, zen_focus, zen_blur, zen_keypress, zen_submit_form, zen_drag, zen_hover, zen_scroll, zen_find, zen_highlight, zen_click_and_wait_navigation
视觉的
zen_screenshot, zen_element_screenshot, zen_full_page_screenshot
选项卡和窗口管理
zen_pin_tab, zen_mute_tab, zen_duplicate_tab, zen_reload_tab, zen_back, zen_forward, zen_get_zoom, zen_set_zoom, zen_windows, zen_create_window, zen_close_window, zen_focus_window, zen_move_tab, zen_detach_tab
网络、Cookie、状态
zen_cookies, zen_storage (本地/会话), zen_clipboard, zen_downloads, zen_clear_browsing_data, zen_intercept, zen_capture_network, zen_wait_for_network_idle, zen_wait_for_url, zen_wait_for_title, zen_watch_console, zen_console_logs
会话(认证一次使用多次)
zen_save_session, zen_load_session, zen_list_sessions, zen_delete_session
编排(并行多选项卡)
zen_keep_alive, zen_keep_alive_stop, zen_wake_tab, zen_broadcast, zen_sync_barrier, zen_tag_tab, zen_resolve_tag, zen_list_tags, zen_untag_tab, zen_tab_pool, zen_pool_acquire, zen_pool_release, zen_parallel
批处理/脚本编写
zen_batch (与 parallel, if, while, try, sequence, retry, ${$N.field} 变量替换)
可观察性/政策
zen_logs, zen_audit, zen_set_policy, zen_get_policy, zen_retry, zen_reload_extension
等待图元
zen_wait_for_element, zen_wait_for_result, zen_wait_for_url, zen_wait_for_title, zen_wait_for_network_idle
工作流程
zen_workflows, zen_workflow, zen_cache, zen_wp_html
zen_wait_for_element
等待CSS选择器出现并在页面上可见。找到后立即返回,而不是在固定时间内休眠——使用此选项代替 sleep 当等待动态/JS渲染的内容时。
{"action": "waitForElement", "selector": ".tracking-events", "timeout": 10000}
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
selector |
string | 必需 | 要等待的CSS选择器 |
timeout |
int | 10000 | 最大等待时间(毫秒) |
poll_interval |
int | 200 | 检查的频率(毫秒) |
退货 { ok: true, found: true, elapsed: 342, ref: "r12", tag: "div" } 关于成功,或 { ok: false, found: false, error: "Timed out after 10000ms" } 超时。
zen_batch
在一个请求中运行多个命令。支持所有操作,包括 waitForElement, trustedClick,以及 sleep:
[
{"action": "navigate", "url": "https://example.com"},
{"action": "waitForElement", "selector": ".results", "timeout": 8000},
{"action": "pageText"}
]
Claude桌面设置
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"zenlink": {
"command": "zenlink-mcp"
}
}
}
更新日志
看 更改日志.md 完整的历史。v2.0.0的亮点:
- 约50个新的MCP工具,涵盖内容提取、交互、网络、会话和编排
- 真正的并行多标签工作通过
zen_parallel+zen_keep_alive - 会话保存/恢复用于身份验证,一次使用多个流
zen_intercept阻止分析/广告(代理运行时页面加速3-10倍)zen_readability+zen_markdown用于令牌高效的页面提取- 通过热重新加载
zen_reload_extension
链接
mcp名称:io.github。JayQuan McCleary/zenlink mcp