brave-search

Retrieve raw Brave Search web and local results via API.

1|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/grahama1970/fetcher --skill brave-search-grahama1970
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: brave-search
Source: https://github.com/grahama1970/fetcher/tree/main/.agents/skills/brave-search
Command: npx skills add https://github.com/grahama1970/fetcher --skill brave-search-grahama1970

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires typer, python-dotenv.

What problem does it solve?

Raw Brave Search results (web and local) are requested without being pre-processed or summarized, enabling downstream piping and analysis.

Core Features & Use Cases

  • Web search via Brave API to retrieve unfiltered results (titles, descriptions, URLs).
  • Local search to fetch nearby businesses with addresses, phones, and ratings, with a native fallback to web results if no local hits.
  • Simple CLI usage for quick lookups and automation in pipelines.

Quick Start

Run a Brave web search for "pizza near Boston" using the Brave Search API.

Frequently Asked Questions about brave-search

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

FAQPage Schema
How do I get raw Brave Search results for web and local queries in an automation pipeline?

You can retrieve raw Brave Search results for web and local queries using a CLI designed for quick lookups and automation pipelines. It returns unfiltered titles, descriptions, and URLs for immediate downstream processing.

Can I use the Brave Search API to fetch nearby local businesses and automatically fall back to web results?

Yes, local search fetches nearby businesses with addresses, phones, and ratings, and automatically falls back to web results if no local hits are available, ensuring your query always returns data.

What API keys do I need to authenticate Brave Search API requests for web and local lookups?

You need to authenticate via BRAVE_API_KEY or BRAVE_SEARCH_API_KEY environment variables. Configuring either key successfully validates your requests to the Brave Search API.

Does the Brave Search API CLI support pagination parameters like count and offset for web results?

Yes, the Brave Search API CLI supports count and offset parameters. These allow you to control the volume of raw web search results returned and paginate through them for automation.

Why use a CLI for raw Brave Search results instead of pre-processed or summarized search data?

Using a CLI for raw Brave Search results provides unfiltered data without pre-processing or summarization. This enables direct downstream piping and custom analysis of titles, descriptions, and URLs.

What Python dependencies are required to run the Brave Search API CLI for local and web queries?

The Brave Search API CLI requires the typer and python-dotenv Python dependencies. Typer handles the CLI interface while python-dotenv manages your BRAVE_API_KEY environment variables.