dokobot

Dokobot — Read Web Pages with a Real Browser

Read, extract, and search web content through a real Chrome browser session. Unlike headless scrapers, Dokobot uses your actual browser with full JavaScript rendering — so it works on SPAs, dynamic sites, and complex web applications.

Also useful for multilingual tasks: translate web pages (网页翻译), summarize articles (文章总结), and extract content (内容提取) in any language. Supports web search (联网搜索) and reading from social platforms like Twitter/X, Reddit, YouTube, GitHub, LinkedIn, Facebook, Instagram, WeChat articles (微信公众号), Weibo (微博), Zhihu (知乎), Xiaohongshu (小红书), and Bilibili (B站).

Supports two modes: local (free, unlimited, via local bridge) and remote (via cloud API with DOKO_API_KEY).

Prerequisites

• @dokobot/cli installed globally (npm install -g @dokobot/cli)
• Chrome browser with Dokobot extension installed
• For local mode: bridge installed (dokobot install-bridge)
• For remote mode: DOKO_API_KEY set via dokobot config, Remote Control enabled in extension
• If no API Key is set, ask the user to create one at the Dokobot dashboard: https://dokobot.ai/dashboard/api-keys, then run dokobot config

Discovering commands

Run dokobot --help to list available commands. Run dokobot <command> --help to see full usage, flags, and defaults for any command.

dokobot --help
dokobot read --help
dokobot search --help

Always refer to --help output for the authoritative list of parameters and defaults. Do NOT assume flags or defaults from memory.

Core commands

Command	Description	Example
read <url>	Read a web page and return text	dokobot read 'https://dokobot.ai/about'
search <query>	Web search	dokobot search 'latest news'
download images <url>	Download images from a web page (supports private/lazy-loaded images)	dokobot download images --local 'https://dokobot.ai/about'
list	List connected devices	dokobot doko list
close <id>	Close an active read session	dokobot doko close <SESSION_ID>

Behavioral guidance

These are things --help does not cover:

Local vs Remote mode

• --local: Free and unlimited. Reads through the local bridge without any server. Requires dokobot install-bridge and Chrome with the extension.
• Remote (default): Reads through the cloud API. Requires DOKO_API_KEY and Remote Control enabled in the extension.
• Prefer --local when the user has Chrome open locally. Use remote when accessing browsers on other machines.

Session continuity

When a read result includes canContinue and sessionId, pass the session ID to continue reading from where it stopped:

dokobot read '<URL>' --session-id <SESSION_ID> --screens 5

Close a session explicitly with:

dokobot doko close <SESSION_ID>

Concurrency

Multiple read requests can run in parallel (each opens a separate browser tab). Recommended maximum: 5 concurrent calls.

Error handling

• 401: Invalid API Key — ask user to check DOKO_API_KEY
• 403: API Key scope insufficient
• 422: Operation failed or was cancelled by user (read only)
• 503: No extension connected (read only) — check read command requirements
• 504: Timed out — retry with a longer --timeout

Troubleshooting

If a command fails unexpectedly, check the CLI version and update if needed:

dokobot --version
dokobot update

To report a bug or request a feature:

dokobot feedback -t bug -m "description of the issue"

Security & Permissions

• Local-first architecture: In local mode (--local), all data flows directly between the CLI and your browser via a local Unix socket. No data leaves your machine.
• End-to-end encryption: In remote mode, page content is encrypted on the browser before transmission and decrypted only on the CLI. The server never sees plaintext page content.
• User-provisioned credentials: DOKO_API_KEY is created and managed by the user. The skill never generates, stores, or exfiltrates credentials.
• Explicit opt-in: Remote Control must be manually enabled in the browser extension by the user. Local mode requires no API key or server.
• Read-only by default: the read and search commands only extract content. They do not modify pages, submit forms, or execute scripts.