Technical & DevelopmentIntermediate
web-search
General-purpose web search using Brave's index.
Developer Setup
Setup & Installation
bash
npx skills add https://github.com/brave/brave-search-skills --skill web-searchnpx skills add https://github.com/brave/brave-search-skills --skill web-searchOr paste this URL into your assistant to install:
Overview
What This Skill Does
Searches the web and returns ranked pages, snippets, discussions, and local locations using Brave's independent index.
Application
When to use this Skill
- When you are implementing a general-purpose search engine or search bar in your app.
- When you need traditional web links, titles, and snippets ranked by Brave's independent index.
- When you want to retrieve multiple result types (web, news, discussions, local) in a single call.
- When you want to apply Goggles custom ranking rules to adjust the relevance of search results.
- When you need SafeSearch or country-specific results for a globally distributed user base.
Documentation
Show Skills.md file
Web Search
Requires API Key: Get one at https://api.search.brave.com
Plan: Included in the Search plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe
Quick Start (cURL)
Basic Search
curl -s "https://api.search.brave.com/res/v1/web/search?q=python+web+frameworks" \
-H "Accept: application/json" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"
With Parameters
curl -s "https://api.search.brave.com/res/v1/web/search" \
-H "Accept: application/json" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
-G \
--data-urlencode "q=rust programming tutorials" \
--data-urlencode "country=US" \
--data-urlencode "search_lang=en" \
--data-urlencode "count=10" \
--data-urlencode "safesearch=moderate" \
--data-urlencode "freshness=pm"
Lines 1 - 28 of 317
Recommendations