brave-search

Search the web and extract page content as Markdown via the Brave Search API.

2|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/cameronmaske/agent-stuff --skill brave-search-cameronmaske
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brave-search
Source: https://github.com/cameronmaske/agent-stuff/tree/main/skills/brave-search
Command: npx skills add https://github.com/cameronmaske/agent-stuff --skill brave-search-cameronmaske

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides browserless web search and content extraction using the Brave Search API, enabling fast discovery of relevant results and quick summarization of pages as Markdown-ready text.

Core Features & Use Cases

  • Headless web search: Query the Brave API to retrieve titles, links, and snippets for documentation, research, or fact gathering.
  • Content extraction: Optionally fetch and convert page content to Markdown for quick summaries.
  • Use Case: Build lightweight research dashboards that present search results with concise summaries and links.

Quick Start

  • Set BRAVE_API_KEY in your shell and export it (e.g., export BRAVE_API_KEY="your-api-key").
  • Install dependencies in the skill directory: npm install.
  • Run a basic search: {baseDir}/search.js "your query"
  • Optional: fetch content with: {baseDir}/search.js "your query" --content

Frequently Asked Questions about brave-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run web searches from the command line without a browser?

You can run browserless web searches from the CLI by executing the search.js script with your query string. The Skill uses the Brave Search API to retrieve titles, links, and snippets directly in your terminal.

How do I extract web page content as markdown for research summaries?

To extract web page content as markdown, run the search.js script with the --content flag. This fetches the page and converts the content to markdown-ready text for quick summarization.

What do I need to set up before using the Brave Search API for content extraction?

Before using the Brave Search API, you must set and export the BRAVE_API_KEY environment variable in your shell and run npm install in the skill directory to install required dependencies.

Can I use this for automated documentation discovery and fact gathering?

Yes, you can automate documentation discovery and fact gathering by querying the Brave API. The script returns search results with titles, links, and snippets across multiple domains.

Does headless web search require a browser instance to fetch search results?

No, headless web search does not require a browser instance. The Skill queries the Brave Search API directly to retrieve search results and optionally fetch page content without opening a browser.

What are the limitations of using a CLI search tool for research dashboards?

The main limitation is dependency on the Brave Search API key and npm environment setup. Additionally, content extraction is optional and depends on the API's ability to fetch and convert external pages to markdown.