brave-search

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

37|4|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/MerkyorLynn/Lynn --skill brave-search-merkyorlynn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brave-search
Source: https://github.com/MerkyorLynn/Lynn/tree/main/skills2set/brave-search
Command: npx skills add https://github.com/MerkyorLynn/Lynn --skill brave-search-merkyorlynn

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It solves the problem of quickly finding relevant web pages and turning messy HTML into clean, readable Markdown without using a browser.

Core Features & Use Cases

  • Brave Search querying: Retrieves multiple web results for a given query, optionally including extracted page content.
  • Readable content extraction: Fetches a URL and converts the main article content into Markdown using readability heuristics.
  • Use case: When you need up-to-date documentation or factual background, run a search for the topic and then extract the most relevant page(s) into Markdown so an agent can summarize or cite them.

Quick Start

Provide an AI task like: "Search the web for OAuth best practices and return 5 results with extracted Markdown content when available."

Frequently Asked Questions about brave-search

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

FAQPage Schema
How do I extract readable content from a web page URL and convert HTML to Markdown?

Web page content extraction works by fetching the URL and applying readability heuristics to isolate the main article text. It then converts that HTML into clean Markdown, removing page clutter so downstream agents can parse the content easily.

Can I fetch web search results and full page content for agent-based tasks without a browser?

Yes, you can perform non-interactive web access by querying a search API to retrieve multiple results. It optionally fetches full page content for each result, converting the HTML into Markdown text suitable for agent analysis and documentation lookups.

Do I need a Brave Search API key to use web search and readability parsing for documentation lookups?

Yes, a Brave Search API key configuration is required. You must provide this key to authenticate search queries, retrieve result snippets, and enable the optional full-page content extraction for your documentation lookup workflows.

What's the best way to convert messy HTML into clean Markdown for fact-finding workflows?

Converting messy HTML into Markdown is best handled by fetching the target URL and using readability heuristics to extract the primary article content. This process strips away navigation and scripts, outputting structured Markdown for fact-finding tasks.

Why does web content extraction return snippets instead of full Markdown text?

Web content extraction defaults to returning search result snippets to save bandwidth and processing time. You must explicitly enable the optional full-page content extraction parameter if you need the complete readable Markdown text from the fetched URLs.

Does this web search and content extraction tool support GitHub Flavored Markdown?

Yes, the content extraction process supports GitHub Flavored Markdown. It utilizes a dedicated GFM plugin during the HTML to Markdown conversion phase, ensuring that tables, lists, and other formatted elements render correctly for downstream analysis.