本机 Agent 互联网运行时
WebFA 在本机跑真实浏览器，通过 MCP 把网页交给外部 Agent。Agent 决策，Runtime 执行。
webfa.open_url → webfa.observe → webfa.act → webfa.observe
| 工具 | 做什么 |
|---|---|
webfa.open_url |
打开网址，可指定 Profile |
webfa.observe |
返回当前页可操作对象、状态和可用动作 |
webfa.act |
对指定对象执行它声明的操作（填写、选择、提交、打开） |
webfa.get_tabs |
列出标签页 |
webfa.switch_tab |
切换标签页 |
observe 给的是页面对象，不是 DOM / selector / 坐标。act 不能越权做对象没声明的事。Cookie、令牌、密码、整页 HTML、CDP 默认不给 Agent。
登录用 CLI 预置，Agent 不填密码、验证码、2FA：
webfa login github
webfa login --url https://example.com/login不同 Profile 可并发；同一 Profile 同时只能有一个可写 Session。不绕过验证码、反爬、风控。关掉 Runtime，进行中的会话不会接着跑。
Python 3.12+，本机 Chrome 或 Edge。
git clone https://github.com/FeiZhuLulu/webFA.git
cd webFA
python -m venv .venv
.\.venv\Scripts\activate
pip install -e ".[dev]"
webfa doctor
webfa mcp-config --agent-id my-agent连上 MCP 后会自动拉起本机 Runtime（默认 http://127.0.0.1:8787）。每个 Agent 用自己的 WEBFA_AGENT_ID。
OpenCode · Kimi Code · Claude Code · Codex
python -m pytest -q