How unbrowse-ai/unbrowse works
Unbrowse is an open-source client for a hosted website-capability service. Its main workflow is to discover a capability, run it, and wait for a verified result; when no capability matches, users can learn one from recordings or through the hosted agent workflow. The CLI and SDK expose these operations, while the repository also contains framework and editor integrations. Edges reflect README statements and shown source references; several integration internals were not sampled, so their detailed call paths are not expanded.
Main entry points: cli.ts CLI commands · client.ts REST client · cookies.ts Saved logins · unbrowse_client.py Dify tools
Components 25
CLI
- CLI commands
packages/cli/src/cli.ts - Local MCP proxy
packages/cli/src/mcp-proxy.ts
SDK workflow
- REST client
packages/sdk/src/client.ts - MCP client
packages/sdk/src/mcp.ts - Discover and registry
packages/sdk/src/client.ts - Run and resume
packages/sdk/src/client.ts - Learn from recordings
packages/sdk/src/client.ts
Local credentials
- OAuth and keys
packages/cli/src/auth.ts - Saved logins
packages/cli/src/cookies.ts - Cookie daemon
packages/cli/src/cookie-daemon.ts - Cookie database
packages/cli/src/sqlite.ts
Agent integrations
- Dify tools
plugins/dify/unbrowse_client.py - ElizaOS MCP client
plugins/elizaos/src/client.ts - ElizaOS actions
plugins/elizaos/src/unbrowse.ts - Hermes MCP client
plugins/hermes/client.py - LangChain tools
plugins/langchain/langchain_unbrowse/tools.py - LangChain MCP client
plugins/langchain/langchain_unbrowse/_client.py - LlamaIndex tools
plugins/llamaindex/llama_index/tools/unbrowse/base.py - LlamaIndex MCP client
plugins/llamaindex/llama_index/tools/unbrowse/_client.py - n8n node
plugins/n8n/nodes/Unbrowse/Unbrowse.node.ts - OpenClaw plugin
plugins/openclaw/src/plugin.ts - Raycast tools
plugins/raycast/src/lib/unbrowse.ts - Zed MCP server
plugins/zed/src/mcp_server_unbrowse.rs
Other components
- User or agent
- Hosted Unbrowse
Connections 25
- User or agent → CLI commands: runs commands
README.md - CLI commands → OAuth and keys: authenticates
packages/cli/src/cli.ts - CLI commands → REST client: calls
packages/cli/src/cli.ts - CLI commands → Local MCP proxy: starts
packages/cli/src/cli.ts - CLI commands → Saved logins: manages logins
packages/cli/src/cli.ts - Saved logins → Cookie database: stores cookies
packages/cli/src/cookies.ts - Cookie daemon → Saved logins: uses
packages/cli/src/cookie-daemon.ts - REST client → Hosted Unbrowse: sends REST requests
packages/sdk/src/client.ts - MCP client → Hosted Unbrowse: calls hosted MCP
packages/sdk/src/mcp.ts - REST client → Discover and registry: searches
packages/sdk/src/client.ts - REST client → Run and resume: starts and resumes
packages/sdk/src/client.ts - REST client → Learn from recordings: fetches learned assets
packages/sdk/src/client.ts - User or agent → Dify tools: uses tools
README.md - Dify tools → Hosted Unbrowse: calls MCP
plugins/dify/unbrowse_client.py - ElizaOS MCP client → Hosted Unbrowse: calls MCP
plugins/elizaos/src/client.ts - ElizaOS actions → ElizaOS MCP client: calls tools
plugins/elizaos/src/unbrowse.ts - Hermes MCP client → Hosted Unbrowse: calls MCP
plugins/hermes/client.py - LangChain tools → LangChain MCP client: uses
plugins/langchain/langchain_unbrowse/tools.py - LangChain MCP client → Hosted Unbrowse: calls MCP
plugins/langchain/langchain_unbrowse/_client.py - LlamaIndex tools → LlamaIndex MCP client: uses
plugins/llamaindex/llama_index/tools/unbrowse/base.py - LlamaIndex MCP client → Hosted Unbrowse: calls MCP
plugins/llamaindex/llama_index/tools/unbrowse/_client.py - n8n node → Hosted Unbrowse: integrates Unbrowse
README.md - OpenClaw plugin → Hosted Unbrowse: calls hosted MCP
plugins/openclaw/src/plugin.ts - Raycast tools → Hosted Unbrowse: calls MCP
plugins/raycast/src/lib/unbrowse.ts - Zed MCP server → Hosted Unbrowse: integrates MCP
README.md