brave-search

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

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/nielpattin/.dotfiles --skill brave-search-nielpattin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brave-search
Source: https://github.com/nielpattin/.dotfiles/tree/main/.pi/agent/skills/brave-search
Command: npx skills add https://github.com/nielpattin/.dotfiles --skill brave-search-nielpattin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @mozilla/readability, jsdom, turndown, turndown-plugin-gfm, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a way to search the web and extract content directly from search results without needing to open a web browser, streamlining information gathering.

Core Features & Use Cases

  • Web Search: Perform targeted searches using the Brave Search API.
  • Content Extraction: Retrieve and format the main content of web pages as Markdown.
  • Use Case: Quickly find API documentation or factual information for a coding task by searching directly within your current workflow, and get concise summaries or full content snippets.

Quick Start

Search the web for 'how to use brave search api' and include the content of the results.

Frequently Asked Questions about brave-search

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

FAQPage Schema
How do I extract web content as Markdown without opening a browser?

Web content extraction as Markdown is performed by querying the Brave Search API and parsing retrieved pages using Readability and Turndown. The extracted main text is formatted directly as Markdown, streamlining information gathering without a browser.

What do I need to perform programmatic web searches with the Brave Search API?

To perform programmatic web searches, you need a valid BRAVE_API_KEY environment variable and specific npm dependencies installed. These prerequisites allow the scripts to query the Brave Search API and extract page content.

Can I retrieve API documentation directly within my coding workflow?

Retrieving API documentation directly within your coding workflow is supported by executing targeted web searches and extracting page content. The Skill queries the Brave Search API to fetch factual information and returns concise summaries or full content snippets.

Does web scraping with Readability and jsdom work for extracting main page content?

Web scraping with Readability and jsdom works for extracting main page content by evaluating the Document Object Model. Readability isolates the primary text, while jsdom provides the environment to parse the HTML structure before conversion.

What are the limitations of using the Brave Search API for web scraping?

Limitations of using the Brave Search API for web scraping include the strict requirement of a valid BRAVE_API_KEY and reliance on npm dependencies. If the target page lacks a clear text structure, Readability may fail to extract the main content effectively.

What is the best way to convert extracted HTML content to GitHub Flavored Markdown?

The best way to convert extracted HTML content to GitHub Flavored Markdown is by using Turndown alongside the turndown-plugin-gfm. This combination translates the parsed HTML from jsdom into structured Markdown for programmatic information retrieval.