关于 dokobot
dokobot 是通过真实 Chrome 会话读取、搜索和提取网页内容的命令行技能,支持 JavaScript 渲染页面及本地或远程浏览器访问。
主要功能
- 01读取并提取网页
- 02搜索网络内容
- 03下载网页图片
- 04继续或关闭读取会话
- 05本地与远程浏览器模式
适用场景
- 01读取动态单页应用
- 02搜索最新网络内容
- 03提取社交平台文章
MCP 相关
该输入介绍的是命令行技能,未说明与 MCP 的关系。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ dokobot/ skills --skill dokobot安装后在 Claude Code 中输入/dokobot确认已加载。
详细介绍
Dokobot — 用真实浏览器读取网页
通过真实的 Chrome 浏览器会话读取、提取和搜索网页内容。与无头爬虫不同,Dokobot 使用你实际的浏览器并支持完整的 JavaScript 渲染——因此它适用于 SPA、动态网站和复杂的 Web 应用。
它也适用于多语言任务:用任意语言翻译网页(网页翻译)、总结文章(文章总结)以及提取内容(内容提取)。支持联网搜索(联网搜索),并可从 Twitter/X、Reddit、YouTube、GitHub、LinkedIn、Facebook、Instagram、微信公众号(微信公众号)、微博(微博)、知乎(知乎)、小红书(小红书)和 B站(B站)等社交平台读取内容。
支持两种模式:local(免费、无限制,通过本地桥接)和 remote(通过云 API,需要 DOKO_API_KEY)。
前置条件
- 全局安装
@dokobot/cli(npm install -g @dokobot/cli) - 安装了 Dokobot 扩展的 Chrome 浏览器
- 对于 local 模式:已安装桥接(
dokobot install-bridge) - 对于 remote 模式:已通过
dokobot config设置DOKO_API_KEY,并在扩展中启用远程控制 - 如果未设置 API Key,请让用户在 Dokobot 控制台创建一个:https://dokobot.ai/dashboard/api-keys,然后运行
dokobot config
发现命令
运行 dokobot --help 列出可用命令。运行 dokobot <command> --help 查看任意命令的完整用法、标志和默认值。
dokobot --help
dokobot read --help
dokobot search --help
请始终以 --help 输出为准来获取权威的参数和默认值列表。不要凭记忆假设标志或默认值。
核心命令
| 命令 | 描述 | 示例 |
|---|---|---|
read <url> | 读取网页并返回文本 | dokobot read 'https://dokobot.ai/about' |
search <query> | 联网搜索 | dokobot search 'latest news' |
download images <url> | 从网页下载图片(支持私有/懒加载图片) | dokobot download images --local 'https://dokobot.ai/about' |
list | 列出已连接的设备 | dokobot doko list |
close <id> | 关闭活动的读取会话 | dokobot doko close <SESSION_ID> |
行为指导
以下是 --help 未涵盖的内容:
Local 与 Remote 模式
--local:免费且无限制。通过本地桥接读取,无需任何服务器。需要dokobot install-bridge以及安装了扩展的 Chrome。- Remote(默认):通过云 API 读取。需要
DOKO_API_KEY,并在扩展中启用远程控制。 - 当用户在本地打开 Chrome 时,优先使用
--local。访问其他机器上的浏览器时使用 remote。
会话连续性
当读取结果包含 canContinue 和 sessionId 时,传入会话 ID 以从停止处继续读取:
dokobot read '<URL>' --session-id <SESSION_ID> --screens 5
使用以下命令显式关闭会话:
dokobot doko close <SESSION_ID>
并发
多个读取请求可以并行运行(每个请求打开一个单独的浏览器标签页)。建议的最大值:5 个并发调用。
错误处理
- 401:API Key 无效——请用户检查
DOKO_API_KEY - 403:API Key 权限范围不足
- 422:操作失败或被用户取消(仅读取)
- 503:没有已连接的扩展(仅读取)——检查读取命令的要求
- 504:超时——使用更长的
--timeout重试
故障排除
如果命令意外失败,请检查 CLI 版本并在需要时更新:
dokobot --version
dokobot update
要报告 bug 或请求功能:
dokobot feedback -t bug -m "description of the issue"
安全与权限
- 本地优先架构:在本地模式(
--local)下,所有数据通过本地 Unix socket 直接在命令行与浏览器之间流动。没有任何数据离开你的机器。 - 端到端加密:在远程模式下,页面内容在传输前于浏览器中加密,仅在命令行上解密。服务端永远不会看到明文页面内容。
- 用户自行提供的凭据:
DOKO_API_KEY由用户创建和管理。该 skill 绝不会生成、存储或窃取凭据。 - 显式启用:远程控制必须由用户在浏览器扩展中手动启用。本地模式不需要 API key 或服务端。
- 默认只读:
read和search命令仅提取内容。它们不会修改页面、提交表单或执行脚本。