AGENTS DOCUMENTATION
让本地智能体按边界使用搜索
这份手册说明 Agent Bridge 的前置条件、两种接入方式、可调用动作与常见恢复路径。智能体获得的是受限能力和结构化结果，不是扩展内存储的密钥。
安装扩展确认运行环境
在将运行调用的 Chrome、Edge、Chromium、Firefox 或其他受支持浏览器中安装并启用双面搜。Agent Skill 需要 Python 3.11+；使用 engine-search 不需要 AI 服务密钥，调用 search 时才需要先配置目标 provider。
开启两层门控
打开扩展 Options → 通用 → Agent Bridge，先开启总开关。若需要通过真实浏览器检索传统搜索引擎，再单独开启 engine-search 子开关。两项能力默认关闭。
Agent Bridge每次 Agent 调用使用新的回环端口、令牌与请求标识，完成、失败或超时后即失效。
路径 A：由扩展交付的 Agent Skill
在同一设置区域点击“下载配套 Agent Skill”。扩展会写入当前浏览器对应的 Bridge 地址；解压后保持 scripts 与 reference 目录完整，并放入你的 Agent 技能目录。
Agent Skill
python scripts/juso_search.py list-providers
python scripts/juso_search.py list-engines
python scripts/juso_search.py search "latest AI research" --provider tavily路径 B：面向 MCP 原生客户端的 Server
通过 pip install juso-search 安装 MCP Server（需要 Python 3.10+）。它使用 stdio；在客户端的 MCP 配置中显式设置 JUSO_BROWSER_PATH 与 Chrome 的 JUSO_EXTENSION_ID，profile 与 timeout 可按需配置。
MCP configuration
{
"mcpServers": {
"juso": {
"command": "juso-search",
"env": {
"JUSO_EXTENSION_ID": "…",
"JUSO_BROWSER_PATH": "…"
}
}
}
}Firefox若使用 Firefox，改为设置 JUSO_BRIDGE_URL（完整 moz-extension://…/bridge.html 地址）；Firefox 的 Bridge 地址按安装实例生成，下载配套 Agent Skill 可自动写入正确值。
阅读 MCP Server 配置 先发现，再明确调用
先用 list-providers 与 list-engines 发现当前可用能力；search 必须显式指定 provider；实例搜索先调用 list-instances，再用 search-instance 指定 instance id。engine-search 只返回普通结果元数据，不承诺 AI 摘要或知识面板。
失败时先检查边界，而不是绕过它若出现 extension_did_not_claim，请检查扩展是否安装并启用、Agent Bridge 总开关是否开启，以及启动的浏览器是否使用了正确 profile。若 engine-search 返回 extract-failed，先检查其独立子开关；验证页、同意页、挑战页与不支持的结果布局也会返回结构化失败，而不是空成功。