# Send Headless Brave Browser to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "brave-headless", "name": "Headless Brave Browser", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/kelexine/brave-headless", "canonicalUrl": "https://clawhub.ai/kelexine/brave-headless", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/brave-headless", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=brave-headless", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "package-lock.json", "package.json", "ARCHITECTURE.md", "SKILL.md", "scripts/search.js", "scripts/circuit-breaker.js" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/brave-headless" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/brave-headless", "downloadUrl": "https://openagent3.xyz/downloads/brave-headless", "agentUrl": "https://openagent3.xyz/skills/brave-headless/agent", "manifestUrl": "https://openagent3.xyz/skills/brave-headless/agent.json", "briefUrl": "https://openagent3.xyz/skills/brave-headless/agent.md" } } ``` ## Documentation ### brave-search Headless web search and content extraction via the Brave Search API. ### Setup Run once before first use: cd npm ci Required environment variable: export BRAVE_API_KEY="your-key-here" Get a free API key at brave.com/search/api. ### Search node scripts/search.js "query" # Basic (5 results) node scripts/search.js "query" -n 10 # Up to 20 results node scripts/search.js "query" --content # Include page content node scripts/search.js "query" -n 3 --content # Combined node scripts/search.js "query" --json # Newline-delimited JSON node scripts/search.js --help # Full options + env vars ### Extract page content node scripts/content.js https://example.com/article node scripts/content.js https://example.com/article --json node scripts/content.js https://example.com/article --max-length 8000 ### Output format (plain text) --- Result 1 --- Title: Page Title URL: https://example.com/page Snippet: Description from Brave Search Content: # Page Title Extracted markdown content... --- Result 2 --- ... Pass --json to get one JSON object per line instead, suitable for piping. ### Exit codes CodeMeaning0Success1Invalid input or configuration error2Page had no extractable content (content.js)130Interrupted (SIGINT) ### Configuration (environment variables) All behaviour is configurable without touching code: VariableDefaultDescriptionBRAVE_API_KEY—Required. Brave Search subscription tokenLOG_LEVELinfodebug · info · warn · error · silentLOG_JSONfalseEmit logs as newline-delimited JSON to stderrFETCH_TIMEOUT_MS15000Per-page fetch timeoutSEARCH_TIMEOUT_MS10000Brave API call timeoutMAX_CONTENT_LENGTH5000Max chars of extracted contentMAX_RETRY_ATTEMPTS3Retry attempts on transient errorsRETRY_BASE_DELAY_MS500Base delay for exponential backoffRETRY_MAX_DELAY_MS30000Backoff delay capCONCURRENCY_LIMIT3Parallel page fetches when --content is setCB_FAILURE_THRESHOLD5Consecutive failures before circuit opensCB_RESET_TIMEOUT_MS60000Circuit breaker reset window All variables are validated at startup — misconfigured runs fail immediately with a descriptive list of every bad value rather than crashing mid-execution. ### Architecture See references/ARCHITECTURE.md for a full module breakdown. scripts/ ├── search.js ← Search CLI entry point ├── content.js ← Content extraction CLI entry point ├── content-fetcher.js ← HTTP fetch + Readability + DOM fallback ├── config.js ← Schema-validated env config ├── circuit-breaker.js ← Fault isolation (CLOSED → OPEN → HALF_OPEN) ├── retry.js ← Exponential backoff with full jitter ├── concurrency.js ← Bounded parallel execution pool ├── utils.js ← htmlToMarkdown, smartTruncate, parseURL ├── logger.js ← Structured leveled logger → stderr └── errors.js ← Typed error hierarchy ## Trust - Source: tencent - Verification: Indexed source record - Publisher: kelexine - Version: 0.2.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/brave-headless) - [Send to Agent page](https://openagent3.xyz/skills/brave-headless/agent) - [JSON manifest](https://openagent3.xyz/skills/brave-headless/agent.json) - [Markdown brief](https://openagent3.xyz/skills/brave-headless/agent.md) - [Download page](https://openagent3.xyz/downloads/brave-headless)