
Web Search
This is Brave's primary search endpoint wrapped for Claude. You get ranked results with snippets, URLs, and thumbnails, plus structured data like FAQs, recipes, product info, and schema.org markup when available. The freshness filters (past day, week, month, year) are genuinely useful for time-sensitive queries, and Goggles let you apply custom ranking if you need domain boosting or filtering. Supports pagination, SafeSearch levels, and optional location headers for local results. If you need raw search results to build a UI or extract structured data, this is the one. For RAG pipelines, check out llm-context instead, which pre-extracts content optimized for token budgets.
- skills.sh installs
- 4.7K
- GitHub stars
- 196
- last updated
- Aug 21, 2026
Install
$ npx -y skills add brave/brave-search-skills --skill web-search --agent claude-codeInstalls into .claude/skills of the current project.
Files
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"
Endpoint
GET https://api.search.brave.com/res/v1/web/search
POST https://api.search.brave.com/res/v1/web/search
Note: Both GET and POST methods are supported. POST is useful for long queries or complex Goggles.
Authentication: X-Subscription-Token: <API_KEY> header
Sponsors
Details
- Repository
- github.com/brave/brave-search-skills
- Categories
- Backend & APIs, Marketing & SEO
- First seen
- Apr 16, 2026