Brave Search

Headless web search and content extraction using Brave Search. No browser required.

Setup

Run once before first use:

cd "${CODEX_HOME:-~/.codex}/skills/brave-search"
npm ci

Needs env: BRAVE_API_KEY (primary) or BRAVE_AI_API_KEY (fallback).

The script tries BRAVE_API_KEY first, then BRAVE_AI_API_KEY if the first is missing or rate-limited. If both fail, it falls back to HTML scraping.

Search

./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

./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 ---
...

When to Use

• Searching for documentation or API references
• Looking up facts or current information
• Fetching content from specific URLs
• Any task requiring web search without interactive browsing

Attribution

This skill was copied from steipete/agent-scripts. Upstream: https://github.com/steipete/agent-scripts License: MIT (see LICENSE)