菜单
Use this skill when the user wants to search the web without a full browser session: find URLs, titles, and metadata for a query. Prefer it over a browser when you just need search results, not page content. Returns structured results with titles, URLs, authors, and dates.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/browserbase/skills --skill search命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications. Supports remote Browserbase sessions with Browserbase Identity, Verified browsers, automatic CAPTCHA solving, and residential proxies — ideal for protected websites and JavaScript-heavy pages.
Self-improving browser automation via the auto-research loop. Iteratively runs a browsing task, reads the trace, and improves the navigation skill (strategy.md) until it reliably passes. Supports parallel runs across multiple tasks using sub-agents. Use when you want to build or improve browser automation skills for specific website tasks.
Migrate browser-use (Python) browser-automation scripts to Stagehand v3 (TypeScript) on Browserbase. Use when the user wants to convert, port, rewrite, or migrate a browser-use Agent script to Stagehand, map browser-use features/APIs to Stagehand primitives (act/extract/observe/agent), or move agentic browser automation onto Browserbase with more determinism. Triggers on "browser-use", "browser_use", or "Agent(task=...)".
正在显示 SKILL.md
基于 SOC 职业分类
| name | search |
| description | Use this skill when the user wants to search the web without a full browser session: find URLs, titles, and metadata for a query. Prefer it over a browser when you just need search results, not page content. Returns structured results with titles, URLs, authors, and dates. |
| compatibility | Requires BROWSERBASE_API_KEY. Examples use `curl`; no browser session or CLI install needed. |
| license | MIT |
| allowed-tools | Bash |
Search the web and return structured results — no browser session required.
Get your API key from: https://browserbase.com/settings
export BROWSERBASE_API_KEY="your_api_key"
| Use Case | Search API | Browser Skill |
|---|---|---|
| Find URLs for a topic | Yes | Overkill |
| Get page titles and metadata | Yes | Overkill |
| Read full page content | No | Yes |
| JavaScript-rendered pages | No | Yes |
| Form interactions | No | Yes |
| Speed | Fast | Slower |
Rule of thumb: Use Search to find relevant URLs and metadata. Use the Browser skill when you need to visit and interact with the pages. Use Fetch to retrieve page content without JavaScript rendering.
curl -X POST "https://api.browserbase.com/v1/search" \
-H "Content-Type: application/json" \
-H "X-BB-API-Key: $BROWSERBASE_API_KEY" \
-d '{"query": "browserbase web automation"}'
| Field | Type | Default | Description |
|---|---|---|---|
query | string | required | The search query |
numResults | integer (1-25) | 10 | Number of results to return |
Returns JSON with:
| Field | Type | Description |
|---|---|---|
requestId | string | Unique identifier for the search request |
query | string | The search query that was executed |
results | array | List of search result objects |
Each result object contains:
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the result |
url | string | URL of the result |
title | string | Title of the result |
author | string? | Author of the content (if available) |
publishedDate | string? | Publication date (if available) |
image | string? | Image URL (if available) |
favicon | string? | Favicon URL (if available) |
Note: The
@browserbasehq/sdkdoes not have a search method yet. Use cURL or direct HTTP calls.
curl -X POST "https://api.browserbase.com/v1/search" \
-H "Content-Type: application/json" \
-H "X-BB-API-Key: $BROWSERBASE_API_KEY" \
-d '{"query": "web scraping best practices", "numResults": 5}'
| Status | Meaning |
|---|---|
| 400 | Invalid request body (check query and parameters) |
| 403 | Invalid or missing API key |
| 429 | Rate limit exceeded (retry later) |
| 500 | Internal server error (retry later) |
numResults when you only need a few top resultsFor detailed examples, see EXAMPLES.md. For API reference, see REFERENCE.md.