brave-search_skill

Overview

This skill lets you search the web, images, and news using Brave Search with privacy-focused results and optional AI-grounded answers that include citations. It’s designed for current or recent information, image lookups, and producing cited summaries. Use it when you need live web data rather than local code or file searches.

How this skill works

The skill calls Brave Search endpoints for web, image, news, suggestions, and AI Grounding. Queries return JSON results with titles, URLs, snippets, and optional extra snippets; AI Grounding returns OpenAI-compatible responses with inline citations. It supports filters like freshness, country, language, safe search, count, and pagination.

When to use it

• Find current facts, recent developments, or news articles
• Look up images or get image result URLs and metadata
• Request AI-generated answers that include source citations
• Autocompletion or query suggestions for search inputs
• Location/POI lookups when on a Pro plan

Best practices

• Set BRAVE_API_KEY before using the skill and verify it with the check-key command
• Batch related queries and run searches in parallel for high-throughput research
• Use subagents to handle heavy or multi-source research to preserve context
• Apply freshness, country, and language filters to narrow results
• Request only the count you need and use pagination to manage large result sets

Example use cases

• Get the latest news articles about an ongoing event with freshness=pd (past day)
• Compare product alternatives and return cited links using AI Grounding
• Fetch 10 images for a design brief with safe search enabled
• Autocomplete query suggestions for a search box
• Run parallel searches for competitor research and synthesize findings