brave-search

Search the Brave Search API for web results, images, and news with citations.

49|9|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/ratacat/claude-skills --skill brave-search-ratacat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brave-search
Source: https://github.com/ratacat/claude-skills/tree/main/skills/brave-search
Command: npx skills add https://github.com/ratacat/claude-skills --skill brave-search-ratacat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use Brave's web/api to search the web, images, and news with citations. Provides AI-grounded answers via an OpenAI-compatible grounding flow.

Core Features & Use Cases

  • Web, image, and news search via Brave's privacy-focused API
  • AI-grounded answers with inline citations
  • Autocomplete suggestions and high-throughput usage
  • Local POI search (Pro plan) and article summarization endpoints

Quick Start

prerequisites: set an API key

  • export BRAVE_API_KEY="your-api-key"
  • python3 brave.py web "AI developments"

Frequently Asked Questions about brave-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search the web with citations and current results?

Web search with citations retrieves live results from Brave Search API, returning indexed pages with source attribution. Use the web endpoint to query current information and receive inline citations for AI grounding across research, journalism, and competitive analysis tasks.

Can I search images and news alongside web results?

Yes, Brave Search supports separate endpoints for images and news in addition to web search. Each endpoint returns results with citations, enabling multi-format searches within a single Skill and allowing filtered queries across content types.

What do I need to get started with Brave Search?

Set a Brave API key via environment variable (BRAVE_API_KEY) before running queries. The Skill requires this credential to authenticate requests and access web, image, and news search endpoints plus AI-grounded answer features.

How do I ground AI answers with real citations?

The Skill provides an OpenAI-compatible grounding flow that integrates Brave Search results into AI responses with inline citations. This ensures answers reference current web data, making output verifiable and suitable for fact-dependent workflows.

What scale and throughput does Brave Search support?

Brave Search enables high concurrency up to 50 requests per second, supporting batch queries and subagents. This throughput suits monitoring, large-scale research, and competitive analysis requiring repeated or parallel searches without rate-limit delays.

Does Brave Search work for autocomplete and location-based queries?

Yes, the Skill includes autocomplete suggestions and local POI search on the Pro plan, plus article summarization endpoints. These features extend beyond basic web search for specialized use cases like location discovery and content summarization.