brave-search▌
steipete/agent-scripts · updated Apr 8, 2026
Lightweight web search and content extraction via Brave Search API, no browser required.
- ›Two core commands: search.js for querying the web with configurable result counts, and content.js for extracting readable markdown from specific URLs
- ›Search results include title, link, and snippet by default; add --content flag to include full page content as markdown
- ›Ideal for documentation lookup, fact-checking, and fetching web content without the overhead of browser automation
- ›Requires BR
Brave Search
Headless web search and content extraction using Brave Search. No browser required.
Setup
Run once before first use:
cd ~/Projects/agent-scripts/skills/brave-search
npm ci
Needs env: BRAVE_API_KEY.
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
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.7★★★★★28 reviews- ★★★★★Ama Mensah· Dec 12, 2024
We added brave-search from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Pratham Ware· Dec 8, 2024
Keeps context tight: brave-search is the kind of skill you can hand to a new teammate without a long onboarding doc.
- ★★★★★Zara Perez· Dec 8, 2024
I recommend brave-search for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
- ★★★★★Yuki Iyer· Dec 8, 2024
brave-search fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Yash Thakker· Nov 27, 2024
brave-search has been reliable in day-to-day use. Documentation quality is above average for community skills.
- ★★★★★Sakura Johnson· Nov 27, 2024
Registry listing for brave-search matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Mei Huang· Nov 3, 2024
brave-search reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Benjamin Abbas· Oct 22, 2024
Registry listing for brave-search matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Dhruvi Jain· Oct 18, 2024
Solid pick for teams standardizing on skills: brave-search is focused, and the summary matches what you get after install.
- ★★★★★Sakura Garcia· Oct 18, 2024
brave-search reduced setup friction for our internal harness; good balance of opinion and flexibility.
showing 1-10 of 28