brave-search-skill - SKILL.md Agent Skill

name: brave-search-skill description: Search the web using Brave Search API for privacy-focused, independent search results with no tracking. allowed-tools: brave_search metadata: author: machina version: "1.0" category: search

Brave Search Skill

Search the web using the Brave Search API. Brave Search is a privacy-focused, independent search engine that does not track users or profile them.

How It Works

This skill provides instructions and context. To execute searches, connect the Brave Search node to the agent's input-tools handle.

brave_search Tool

Search the web and get relevant results from Brave's independent index.

Schema Fields

Field	Type	Required	Description
query	string	Yes	Search query to look up on the web

Node Parameters

Additional options configured on the node:

Parameter	Default	Description
maxResults	10	Number of results to return (max 100)
country	(empty)	Country code for regional results (e.g., US, GB, DE)
searchLang	(empty)	Language code for search results (e.g., en, es, fr)
safeSearch	moderate	Safe search filtering: off, moderate, strict

Response Format

{
  "query": "artificial intelligence news",
  "results": [
    {
      "title": "AI Breakthrough in Medical Research",
      "snippet": "Researchers have developed a new AI model that can predict...",
      "url": "https://example.com/ai-medical-research"
    }
  ],
  "result_count": 10,
  "provider": "brave_search"
}

Examples

General search:

{
  "query": "latest news about artificial intelligence"
}

Technical search:

{
  "query": "Python asyncio best practices 2026"
}

Local search:

{
  "query": "best restaurants in San Francisco"
}

When to Use Brave Search

Privacy-focused results - No user tracking or profiling
Independent index - Not reliant on Google or Bing
General web search - News, facts, documentation, products
Regional results - Use country/language parameters for localized results

When NOT to Use Brave Search

AI-powered answers - Use Perplexity instead for synthesized answers with citations
Google-specific results - Use Serper for Google's index
Simple calculations - Use the calculator tool
Creative tasks - Writing, brainstorming, analysis

Search Query Best Practices

Use specific, focused queries (under 10 words when possible)
Include relevant keywords, dates, and context
Break complex questions into simpler searches
Avoid filler words like "please" or "can you tell me"

API Details

API: GET https://api.search.brave.com/res/v1/web/search
Auth: X-Subscription-Token header
Rate Limits: Depends on plan (Free: 1 query/sec, 2000/month)
Pricing: ~$0.003 per query

Setup Requirements

Connect this skill to the agent's input-skill handle
Connect the Brave Search node to the agent's input-tools handle
Add your Brave Search API key in Credentials > Search