brave-search

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

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/josorio7122/pi-flow --skill brave-search-josorio7122
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brave-search
Source: https://github.com/josorio7122/pi-flow/tree/main/skills/brave-search
Command: npx skills add https://github.com/josorio7122/pi-flow --skill brave-search-josorio7122

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a fast and efficient way to search the web and extract content directly from search results, eliminating the need for a graphical browser.

Core Features & Use Cases

  • Web Search: Perform targeted searches using the Brave Search API.
  • Content Extraction: Retrieve the full content of web pages as Markdown.
  • Customizable Results: Filter search results by country and freshness.
  • Use Case: Quickly find API documentation or factual information for a project without leaving your terminal or interrupting your workflow.

Quick Start

Use the brave-search skill to find information about 'typescript generics' and include the 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 searches and extract page content without a browser?

You can perform headless web searches and extract page content as Markdown by executing an npx tsx script that calls the Brave Search API, eliminating the need for a graphical browser during information retrieval.

What do I need to set up to use the Brave Search API for web scraping?

You need to configure a BRAVE_API_KEY environment variable and install Node.js to run the npx tsx execution environment required for calling the Brave Search API and extracting web content.

Can I filter web search results by freshness and country for documentation lookup?

Yes, you can customize web search results by filtering for specific countries and freshness dates, enabling targeted documentation lookup and fact-checking directly from your terminal.

Does this approach convert extracted HTML content into Markdown for terminal workflows?

Yes, the process converts extracted HTML content into Markdown using dependencies like @mozilla/readability, jsdom, and turndown, providing clean text output suitable for terminal workflows.

What is the best way to retrieve full text from search results without interrupting my workflow?

The best way is to execute a script that queries the Brave Search API and uses @mozilla/readability with turndown to extract web content as Markdown, keeping information retrieval entirely within your terminal.