Ego Browser Search

What it does

When your agent uses it

• Searching content that sits behind a login wall
• Extracting results from JavaScript-rendered or single-page sites
• Paging through or expanding a dynamic search that one request cannot cover
• Fetching data from a known same-origin API through the browser

Example prompts

• “Turn on professional search mode, then search Zhihu for discussions about vector databases.”
• “Fetch the full text of this login-walled article through my browser session.”
• “Page through this search results site and give me everything as JSON.”
• “Pull the data from the site's same-origin API endpoint instead of scraping the page.”

Requirements

• macOS with the ego browser runtime and its ego-browser command, or the WebBridge browser extension
• Professional search mode switched on by you
• Python 3 to run ego_search.py

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1同站多轮：--site zhihu.com（或 --task-space site:zhihu.com --keep-space）
2. 2单次取证：默认即可（跑完关空间）
3. 3quality.login_likely_ok=false → 在 ego App 或用户 Chrome 人工登录后重试
4. 4不要把登录态 body 写入 public cache；汇总用 merge

What it can do on your machine

Read from SKILL.md and the folder at commit a6657b0. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 7 files in scripts/ (Python), which the agent can run.

  Shell commands in SKILL.md call:

  • python3

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • zhihu.com
  • cn.bing.com

  Also links to:

  • lite.ego.app
  • kimi.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ego Browser Search loads about 2.1k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 109 tokens; SKILL.md has 473 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~109

When it runs · the whole SKILL.md, loaded when a task matches

~2.1k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from taxueseek/argo at commit a6657b0, republished under its MIT licence (© taxueseek). 473 words, ~2,123 tokens.

name

ego-search

description

ego-search 是 argo 的浏览器态搜索增强子技能，基于真实 Chromium 浏览器运行时，提供 登录态继承、JS 渲染、反爬（尽力而为，未验证可穿透重度防护）、动态交互与同源接口数据直取（api 模式）能力。专业搜索 模式默认关闭，需用户明确要求并执行开启指令后启用。当 argo 的 API/HTML 引擎覆盖不到 时启用：登录墙后的内容（知乎/小红书/微博/X/公众号）、JS 渲染与 SPA 页面、反爬与 Cloudflare 保护页（尽力而为，重度防护可能失败）、需要交互（翻页/展开/滚动加载）的动态搜索、SPA/XHR 接口数据直取、 以及需要真实登录态才能搜到的私有内容。输出对齐 argo 统一 JSON schema，可直接进入 evidence 评分与 RRF 融合。Triggers include 浏览器搜索、登录后才能搜到、JS 渲染页面、 SERP 补充、动态内容抓取、登录态抓取、API 数据直取、接口数据。

metadata.version

1.6.0

metadata.date

2026-08-07

metadata.upstream

ego lite（ego-browser）+ WebBridge 扩展桥（双运行时）

metadata.parent

argo

metadata.pro_mode

默认关闭，手动开启（enable/disable）

metadata.cache

登录态结果 cache_eligible=false，禁止写入 argo 公共缓存

metadata.architecture

dual_runtime_complete

metadata.security

URL 守卫 + 任务空间收尾 + 专业模式闸门 + 登录墙质量信号

triggers

专业搜索模式, 开启专业搜索模式, 浏览器搜索, 登录态, 登录墙, JS渲染, SERP, 动态内容, 反爬（尽力而为）, 浏览器抓取, API数据直取, 接口数据

# 开启（必须由用户明确要求「开启专业搜索模式」后执行）
python3 sub-skills/ego-search/scripts/ego_search.py enable
# 关闭
python3 sub-skills/ego-search/scripts/ego_search.py disable
# 查看状态
python3 sub-skills/ego-search/scripts/ego_search.py status

常规检索（快、省 token）
  → 结果不足 / 正文拿不到 / 需要登录态
    → ego-search search|fetch|act|api（pro-mode 开启）
      → 更复杂多步 → ego-browser nodejs heredoc
高后果结论 → 证据核验

# 首次使用：先开启专业搜索模式（需用户确认；开启后长期生效）
python3 sub-skills/ego-search/scripts/ego_search.py enable

# 探测运行时与专业模式（--fix 幂等启 WebBridge 桥）
python3 sub-skills/ego-search/scripts/ego_search.py status [--fix]

# 浏览器态搜索（真实 SERP，输出 argo JSON schema）
#   --runtime auto(默认: 有 ego 用 ego，否则 webbridge) | ego | webbridge
python3 sub-skills/ego-search/scripts/ego_search.py search "AI agent 浏览器自动化" --engine bing --n 8

# 强制登录态站点搜索（如知乎/小红书，需登录态）
python3 sub-skills/ego-search/scripts/ego_search.py search "site:zhihu.com AI 搜索" --engine bing

# 浏览器态正文提取（JS 渲染/反爬/登录墙页面）
python3 sub-skills/ego-search/scripts/ego_search.py fetch "https://example.com/article" --focus 关键词

# 同源 API 数据直取（登录态站点接口）
python3 sub-skills/ego-search/scripts/ego_search.py api "https://www.zhihu.com/api/v4/search_v3?t=general&q=AI代理&limit=5" --origin "https://www.zhihu.com"

# 指定任务空间名（同一目标的多轮操作复用同名空间）
python3 sub-skills/ego-search/scripts/ego_search.py search "竞品分析" --task-space "竞品调研"

{
  "query": "AI agent 浏览器自动化",
  "engine": "ego_browser_bing",
  "source": "ego-browser",
  "url": "https://cn.bing.com/search?q=...",
  "results": [
    {"title": "...", "url": "https://...", "snippet": "..."}
  ],
  "count": 8,
  "fetch_method": "browser",
  "login_state_used": true,
  "auth_partition": "login",
  "cache_eligible": false
}

{
  "api_url": "https://www.zhihu.com/api/v4/search_v3?t=general&q=...",
  "page_url": "https://www.zhihu.com/",
  "page_title": "(1 条消息) 首页 - 知乎",
  "data": { "paging": {...}, "data": [...] },
  "data_type": "json",
  "fetch_method": "browser_api"
}

© taxueseek, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts, references) in sub-skills/ego-search of taxueseek/argo.

• SKILL.md
• references/browser-runtime.md
• references/install.md
• references/original-ego-upgrade.md
• scripts/ego_search.py
• scripts/merge.py
• scripts/quality.py
• scripts/runtime.py
• scripts/safety.py
• scripts/serp_spec.py
• scripts/webbridge_adapter.py
• tests/test_query_normalize.py

Open the folder on GitHubat commit a6657b0