mcpField
B
brave-search

brave-search

github.com/badlogicProductivity2.6k1.4k installsUpdated 21w ago
Repository

About brave-search

A command-line skill for web search and page-content extraction through the official Brave Search API. It is intended for tasks that need current information or readable page text without browser interaction.

Key features

  1. 01Searches the web through Brave Search API
  2. 02Sets result count and country
  3. 03Filters by date or freshness
  4. 04Extracts page content as Markdown

Use cases

  1. 01Finding documentation and API references
  2. 02Checking current facts and information
  3. 03Retrieving readable text from a URL

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/badlogic/pi-skills --skill brave-search

After installing, type/brave-searchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
content.js
package-lock.json
package.json
search.js

Details

From the project README

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

Comments

Markdown supported