brave-search

badlogic's avatarfrom badlogic

Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.

⭐72stars🔀6forks📁View on GitHub🕐Updated Dec 23, 2025
[Web Research]

When & Why to Use This Skill

The Brave Search Claude skill empowers your AI agent with real-time web access and precise content extraction capabilities. By utilizing the official Brave Search API, this tool allows for high-speed information retrieval and markdown-formatted page extraction without the need for a heavy browser environment. It is an essential utility for bridging the gap between an LLM's static training data and the live, evolving web, ensuring your workflows are always informed by the latest facts and documentation.

Use Cases

  • Technical Documentation Search: Instantly locate and extract the latest API references, library documentation, or technical guides to assist in accurate code generation and debugging.
  • Real-time Fact-Checking: Verify claims, look up current events, and retrieve up-to-date statistics using Brave's independent search index to ensure data integrity.
  • Automated Content Harvesting: Fetch specific URLs and convert web content into clean markdown for seamless summarization, analysis, or knowledge base integration.
  • Time-Sensitive Market Intelligence: Use freshness filters to monitor the latest industry news, product launches, or trending topics from the past day, week, or month.
namebrave-search
descriptionWeb search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.

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

{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