ma-browser

ma-browser - 信息获取与浏览器自动化

核心价值

通过浏览器 + 用户登录态，可以获取：

• 公域信息：任意公开网页、搜索结果、新闻资讯
• 私域信息：内部系统、企业应用、登录后页面、个人账户数据

还可以代替用户执行浏览器操作：表单填写、按钮点击、数据提取、截图保存、批量操作。

运行在用户真实浏览器中，复用已登录的账号，不触发反爬检测。

快速开始

ma-browser open <url>        # 打开页面（新 tab）
ma-browser snapshot -i       # 获取可交互元素
ma-browser click @5          # 点击元素
ma-browser fill @3 "text"    # 填写输入框
ma-browser close             # 完成后关闭 tab

Site 系统 — 把任何网站变成命令行 API

site 系统是 ma-browser 的核心特性，通过 adapter 将网站功能 CLI 化，覆盖 36+ 平台。

# 常用命令
ma-browser site list                          # 列出所有 adapter
ma-browser site search <query>                # 搜索 adapter
ma-browser site <name> [args...]              # 运行 adapter
ma-browser site update                        # 更新社区 adapter 库

# 使用示例
ma-browser site twitter/search "Claude Code"  # 搜索推文
ma-browser site zhihu/hot                     # 知乎热榜
ma-browser site github/repo owner/repo        # 仓库信息
ma-browser site youtube/transcript <video_id> # 获取字幕
ma-browser site reddit/thread <url>           # 帖子详情
ma-browser site eastmoney/stock "茅台"         # 股票查询
ma-browser site weibo/hot                     # 微博热搜
ma-browser site arxiv/search "transformer"    # 论文搜索

adapter 自动处理 tab 管理（查找匹配域名的 tab 或新建），自动检测登录错误并提示。

详细用法和 36 平台完整列表：参见 references/site-system.md 创建自定义 adapter：参见 references/adapter-development.md

fetch — 带登录态的 curl

在浏览器上下文中执行 fetch，自动携带 Cookie 和登录态。

ma-browser fetch <url>                                    # GET 请求
ma-browser fetch <url> --method POST --body '{"k":"v"}'   # POST 请求
ma-browser fetch <url> --headers '{"Auth":"Bearer xxx"}'  # 自定义请求头
ma-browser fetch <url> --output data.json                 # 保存到文件
ma-browser fetch /api/me.json                             # 相对路径（用当前 tab 的 origin）

自动域名路由：绝对路径自动查找匹配 tab 或新建；相对路径使用当前 tab。

详细用法：参见 references/fetch-and-network.md

Tab 管理规范

操作完成后必须关闭自己打开的 tab。

# 单 tab 场景
ma-browser open https://example.com    # 打开新 tab
ma-browser snapshot -i
ma-browser click @5
ma-browser close                        # 完成后关闭

# 多 tab 场景
ma-browser open https://site-a.com     # tabId: 123
ma-browser open https://site-b.com     # tabId: 456
# ... 操作 ...
ma-browser tab close                    # 关闭当前 tab
ma-browser tab close                    # 关闭剩余 tab

# 指定 tab 操作
ma-browser open https://example.com --tab current  # 在当前 tab 打开（不新建）
ma-browser open https://example.com --tab 123      # 在指定 tabId 打开