brave-search

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

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/okbest2024/openclaw-backup --skill brave-search-okbest2024
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brave-search
Source: https://github.com/okbest2024/openclaw-backup/tree/main/workspace/skills/brave-search
Command: npx skills add https://github.com/okbest2024/openclaw-backup --skill brave-search-okbest2024

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @mozilla/readability, jsdom, turndown, turndown-plugin-gfm.

What problem does it solve?

Quickly locate relevant web information and extract readable content without a browser, streamlining research and knowledge gathering.

Core Features & Use Cases

  • Headless web search using the Brave Search API to return concise results with titles, links, and snippets.
  • Optional content extraction to Markdown for offline reading or documentation.
  • Use Case: Build AI assistants that fetch up-to-date references and summarize pages for user queries.

Quick Start

Run search.js with a query to fetch Brave Search results and optionally fetch page content.

Frequently Asked Questions about brave-search

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

FAQPage Schema
How do I perform headless web search and extract page content to Markdown using Node.js?

To perform headless web search and extract content to Markdown, run the search script with a query using Node.js. It fetches Brave Search results and applies Readability and Turndown to convert web pages into structured Markdown text.

Do I need a Brave API key to fetch web search results programmatically?

Yes, you need a Brave API key to fetch web search results programmatically. You must configure the BRAVE_API_KEY environment variable to authenticate your requests and retrieve structured search results.

Can I configure the number of web search results returned by the Brave Search API?

Yes, you can configure the number of web search results returned by the Brave Search API. The script supports configurable result counts so you can limit or expand the titles, links, and snippets retrieved for your specific query.

What is the best way to extract readable content from search results for AI assistants?

The best way to extract readable content for AI assistants is using Readability and Turndown. These libraries strip clutter from web pages fetched via Brave Search and convert the remaining text into clean Markdown for offline reading or summarization.

Does this headless search approach work with GitHub Flavored Markdown?

Yes, the headless search approach supports GitHub Flavored Markdown by using the turndown-plugin-gfm dependency. It ensures extracted web content is properly formatted with GFM features like tables and task lists during content conversion.

Why use Readability and jsdom for web content extraction instead of raw HTML parsing?

Using Readability and jsdom for web content extraction isolates the main article text from website boilerplate. This provides a clean DOM structure for Turndown to convert into readable Markdown, avoiding noise from raw HTML parsing.