skills.rest
BumpyClock
BumpyClockCOMMUNITY
Explore all skills by this author →
GitHub

brave-search

Search the web via Brave Search API and return structured results.

1|1|Updated Jun 2, 2025
Search Tags:#markdown#api#readability#headless#web-search#content-extraction#brave-search
One-click install
npx skills add https://github.com/BumpyClock/dotfiles --skill brave-search-bumpyclock
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: brave-search
Source: https://github.com/BumpyClock/dotfiles/tree/main/.ai_agents/skills/brave-search
Command: npx skills add https://github.com/BumpyClock/dotfiles --skill brave-search-bumpyclock

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Brave Search enables browserless web discovery and content extraction, empowering agents to locate relevant information quickly and convert fetched pages into readable Markdown for seamless ingestion.

Core Features & Use Cases

  • Headless web search: Queries Brave Search API to retrieve titles, links, and concise snippets without a browser.
  • Content extraction: Optionally fetches pages and converts readable content into Markdown for easy summarization and reuse.
  • Structured results: Outputs are formatted with Title, Link, Snippet, and optional Content to support automated workflows.
  • Use Case: Ideal for building AI agents that gather API references, documentation, or current events and present them in a consistent, digestible format.

Quick Start

Install dependencies and run a Brave search query using your BRAVE_API_KEY to begin returning results.

Frequently Asked Questions about brave-search

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

FAQPage Schema
How do I perform a headless web search and extract page content without a browser?▼

Headless web search without a browser queries the Brave Search API to retrieve titles, links, and snippets, then optionally converts readable page content into Markdown using readability and conversion libraries.

Can I convert fetched web pages into Markdown for automated AI workflows?▼

Yes, fetched web pages can be converted into Markdown. The process uses Readability and Turndown to extract readable content and format it as structured Markdown for automated AI ingestion.

Do I need a Brave API key to retrieve structured web search results?▼

Yes, you need a Brave API key. The Skill requires this key to authenticate queries to the Brave Search API and return structured outputs containing titles, links, snippets, and optional content.

What is the best way to gather API references and documentation autonomously?▼

Gathering API references and documentation autonomously is achieved by using a headless search tool that queries the web via API and extracts readable content into Markdown, ensuring consistent structured results for agents.

Does browserless content extraction work with JavaScript-heavy web pages?▼

The content extraction handles standard web pages by applying Readability with JSDOM to parse readable text into Markdown. Highly dynamic JavaScript-rendered pages may not be fully captured without a dedicated browser environment.

Related Skills

Explore More Software Engineering Skills→
ratacatratacat
49

brave-search

Search the Brave Search API for web results, images, and news with citations.

Community
Advanced
48Nauts-Operator48Nauts-Operator
3

rag-implementation

Build Retrieval-Augmented Generation systems with vector databases and semantic search.

Community
Advanced
appautomatonappautomaton
18

html-to-markdown

Converts HTML or live web pages into structured Markdown with metadata and link inventories.

Official
Intermediate
augustsclaugustscl
2

tavily-search

Search the web via the Tavily API and return JSON, Markdown, or Brave-like results.

Community
Intermediate