# Brave Search

> Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.

- Skill: `majiayu000/brave-search-8` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/brave-search-8`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/brave-search-8/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/brave-search-8

---


# Brave Search

Headless web search and content extraction using Brave Search. No browser required.
This skill exists to provide a reliable, reusable web lookup tool that behaves consistently across agents and projects, even though Codex can search when explicitly enabled; it standardizes the search/extract workflow so it is portable and predictable.

## Setup

Run once before first use:

```bash
cd /home/vnkbr/.codex/skills/brave-search
npm ci
```

Needs env: `BRAVE_API_KEY`.
If missing, `./search.js` exits with a missing key error.

Alt install: if this repo is mirrored elsewhere, `cd <that>/skills/brave-search` before `npm ci`.

## Search

```bash
./search.js "query"                    # Basic search (5 results)
./search.js "query" -n 10              # More results
./search.js "query" --content          # Include page content as markdown
./search.js "query" -n 3 --content     # Combined
```

## Extract Page Content

```bash
./content.js https://example.com/article
```

Fetches a URL and extracts readable content as markdown.

## Output Format

```
--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Snippet: Description from search results
Content: (if --content flag used)
  Markdown content extracted from the page...

--- Result 2 ---
...
```

## How to run

```bash
./search.js "steipete" -n 1
```

Success looks like: a `--- Result 1 ---` block with a non-empty Title/Link.