Setting the skill. One moment.
Skills
Skill 16 of 18
Use this skill when the user wants to search the web without a full browser session: find URLs, titles, and metadata for a query.
2 minutes · 361 words · 11 sections
Install
npx skills add browserbase/skills --skill searchnpx skills add browserbase/skills/plugin marketplace add browserbase/skillsThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
18 skills · 104 min
Get your API key from: https://browserbase.com/settings (opens in a new tab)
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 (opens in a new tab). For API reference, see REFERENCE.md (opens in a new tab).
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.
The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.
Bashskills/search/SKILL.mdmain, last pushed 9 September 2026.SKILL.md, not by matching a directory convention. One layout observed: skills/*/SKILL.md.h1 and no skipped levels:.claude-plugin/marketplace.json by Browserbase, declaring 6 plugins. It is read for editorial metadata only — never as the skill index, which is always the repository tree./browserbase/skills.md, and each skill at its own .md URL.3 files · 9 KB
Everything this skill ships beside its prose. All of it is set here, as subchapters of skill 16.
Everything else published alongside the skill.