brave-search

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

1|Updated Feb 22, 2026

Search Tags:#api #information retrieval #brave search #search #web scraping #content extraction

Ready to run

npx skills add https://github.com/josorio7122/pi-flow --skill brave-search-josorio7122

💬 Prompt for ChatGPT / Claude Chat▼

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.