Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
badlogic avatar

Brave Search

badlogic/pi-skills

  • 1.1k installs
  • 2.3k repo stars
  • Updated June 6, 2026
  • badlogic/pi-skills

brave-search is a Node.js CLI skill in badlogic/pi-skills that extracts readable webpage content as clean markdown using Mozilla Readability, JSDOM, and Turndown for developers whose LLM agents need structured text from

About

brave-search is a webpage content extraction CLI skill that converts any URL into clean, LLM-readable markdown for agent pipelines. Despite the name, the implementation is content.js—a Node script using Mozilla Readability for article extraction, JSDOM for HTML parsing, and Turndown with the GFM plugin for fenced-code markdown output. Developers run content.js with a URL argument to strip navigation, ads, and boilerplate before feeding documentation or articles into RAG or research agents. The skill suits agents that must fetch and normalize web pages without brittle copy-paste or raw HTML token waste.

  • Fetches webpage with realistic browser headers and 15-second timeout
  • Uses Mozilla Readability to strip navigation, ads, and boilerplate
  • Converts HTML to clean Markdown with GFM support
  • Applies post-processing rules to remove empty links, normalize whitespace, and fix punctuation
  • CLI-first design for direct use in agent workflows and MCP servers

Brave Search by the numbers

  • 1,064 all-time installs (skills.sh)
  • +75 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #987 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Security screen: HIGH risk (skills.sh audit)
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/badlogic/pi-skills --skill brave-search

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1.1k
repo stars★ 2.3k
Security audit1 / 3 scanners passed
Last updatedJune 6, 2026
Repositorybadlogic/pi-skills ↗

How do you convert a webpage to clean markdown for LLMs?

Convert any webpage into clean, readable markdown that an LLM agent can reliably process.

Who is it for?

Developers building research or RAG agents who need a Node CLI to normalize arbitrary web pages into token-efficient markdown.

Skip if: Teams needing live web search result ranking or Brave Search API queries—the skill extracts content from a known URL, not search results.

When should I use this skill?

User needs to fetch a webpage as clean markdown, extract readable article content from a URL, or preprocess HTML for LLM context windows.

What you get

GFM markdown files with extracted article body text stripped of navigation, ads, and HTML boilerplate from source URLs.

  • GFM markdown content
  • extracted article text

Files

SKILL.mdMarkdownGitHub ↗

Brave Search

Web search and content extraction using the official Brave Search API. No browser required.

Setup

Requires a Brave Search API account with a free subscription. A credit card is required to create the free subscription (you won't be charged).

1. Create an account at https://api-dashboard.search.brave.com/register 2. Create a "Free AI" subscription 3. Create an API key for the subscription 4. Add to your shell profile (~/.profile or ~/.zprofile for zsh):

   export BRAVE_API_KEY="your-api-key-here"

5. Install dependencies (run once):

   cd {baseDir}
   npm install

Search

{baseDir}/search.js "query"                         # Basic search (5 results)
{baseDir}/search.js "query" -n 10                   # More results (max 20)
{baseDir}/search.js "query" --content               # Include page content as markdown
{baseDir}/search.js "query" --freshness pw          # Results from last week
{baseDir}/search.js "query" --freshness 2024-01-01to2024-06-30  # Date range
{baseDir}/search.js "query" --country DE            # Results from Germany
{baseDir}/search.js "query" -n 3 --content          # Combined options

Options

  • -n <num> - Number of results (default: 5, max: 20)
  • --content - Fetch and include page content as markdown
  • --country <code> - Two-letter country code (default: US)
  • --freshness <period> - Filter by time:
  • pd - Past day (24 hours)
  • pw - Past week
  • pm - Past month
  • py - Past year
  • YYYY-MM-DDtoYYYY-MM-DD - Custom date range

Extract Page Content

{baseDir}/content.js https://example.com/article

Fetches a URL and extracts readable content as markdown.

Output Format

--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Age: 2 days ago
Snippet: Description from search results
Content: (if --content flag used)
  Markdown content extracted from the page...

--- Result 2 ---
...

When to Use

  • Searching for documentation or API references
  • Looking up facts or current information
  • Fetching content from specific URLs
  • Any task requiring web search without interactive browsing

Related skills

mattpocockSetup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196kopen.feishu.cnLark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402kjuliusbrusseeCavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7klarksuiteLark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16kxixu-meRunning Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72runcomfy-comCodex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10

How it compares

Use brave-search for single-URL article extraction to markdown; use a dedicated search MCP when you need query-based result discovery rather than known-URL content parsing.

FAQ

What libraries does brave-search content.js use?

brave-search content.js uses Mozilla Readability for article extraction, JSDOM for HTML DOM parsing, and Turndown with the turndown-plugin-gfm package to output GitHub-flavored markdown with fenced code blocks.

How do you run the brave-search content extractor?

brave-search runs as a Node CLI: pass a URL to content.js, for example content.js https://doc.rust-lang.org/book/ch04-01-what-is-ownership.html. The script prints extracted readable content as markdown to stdout.

Is Brave Search safe to install?

skills.sh reports 1 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

AI & Agent Buildingagentsautomation
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.