brave/brave-search-skills
12 skills11.5k installs2k starsGitHub
Install
npx skills add https://github.com/brave/brave-search-skillsSkills in this repo
1Web SearchWeb Search is Brave's primary REST API endpoint for structured web search results. It returns ranked links, snippets, thumbnails, and rich structured data (products, recipes, articles, FAQs, videos, news, discussions) in a single call. Developers use it to build search interfaces, extract data for machine learning pipelines, or ground AI agents with current web content. Unlike the Answers endpoint (slower, synthesized), Web Search prioritizes speed (~0.5-1s) and flexibility. Unique feature: Goggles custom ranking allows inline or hosted rules to boost trusted sources, suppress spam, or focus results by domain/type. GET/POST endpoint returning web, news, videos, discussions, FAQ, infobox, locations in one structured response. Goggles custom ranking (hosted or inline) to boost/discard sites and re-rank results uniquely. Rich structured data extraction: products, recipes, articles, software, ratings, FAQs via typed fields and schemas.3.9kinstalls2Images Searchimages-search is a Brave Search skill that connects coding agents to the Brave Images API at api.search.brave.com/res/v1/images/search. Results include image title, source URL, and thumbnail, with SafeSearch filtering and support for up to 200 results per query. The skill documents cURL quick starts with X-Subscription-Token authentication and requires a Brave Search API key from the Search plan dashboard. Developers reach for images-search when agents or applications need programmatic image discovery instead of manual browser searches, such as UI asset lookup, content enrichment, or visual research pipelines.1.2kinstalls3News Searchnews-search is a Brave Search Skills agent integration that calls `https://api.search.brave.com/res/v1/news/search` and returns structured news results—title, URL, description, age, and thumbnail—for agent-driven research. It requires a Brave Search API key on the Search plan and supports freshness windows, explicit date ranges, SafeSearch filtering, and Goggles for custom ranking. Developers reach for news-search when building agents that monitor breaking topics, summarize recent coverage, or validate assumptions against current headlines without hand-writing curl requests each time. Example calls use `X-Subscription-Token` headers and standard JSON responses, including a past-24-hours freshness pattern documented in the skill readme.1.2kinstalls4Llm Contextllm-context from brave/brave-search-skills wraps Brave's LLM Context API for RAG and agentic applications. It returns pre-extracted, relevance-ranked web content—text, tables, and code—via GET and POST, with adjustable max_tokens and result count, plus optional Goggles and local POI filters. The skill requires a Brave Search API key on the Search plan from api.search.brave.com. Developers reach for llm-context when building AI answers, retrieval pipelines, or agents that need fresh web evidence instead of brittle HTML scraping. For synthesized responses the sibling answers skill is recommended; llm-context focuses on clean context payloads optimized for LLM consumption.735installs5Videos Searchvideos-search is a Brave Search skill from brave/brave-search-skills that calls https://api.search.brave.com/res/v1/videos/search with an X-Subscription-Token API key from the Search plan. Results include title, URL, thumbnail, duration, view count, and creator fields, with optional freshness filters, SafeSearch, and pagination for agent-driven research loops. Developers and coding agents reach for videos-search when written docs are thin and video walkthroughs clarify framework setup, debugging steps, or UI patterns. The skill ships cURL quick-start examples so agents can embed video discovery into research workflows without building a custom search client first.720installs6Answersanswers is a Claude Code skill from brave/brave-search-skills that wraps Brave Search's OpenAI-compatible POST /res/v1/chat/completions endpoint. Single-search mode returns a fast AI-grounded answer with optional streaming citations via enable_citations, while research mode (enable_research=true) runs up to 5 iterative search passes with a default 180-second budget and built-in synthesized citations. The skill works as a drop-in OpenAI SDK client by setting base_url to https://api.search.brave.com/res/v1 and passing X-Subscription-Token. Developers reach for answers when agents need current, cited facts about frameworks, APIs, or comparative technical decisions instead of stale training data. Research mode supports up to 50 queries per request and requires streaming.699installs7Local Poislocal-pois is a Brave Search API integration skill from brave/brave-search-skills that returns full local business and point-of-interest details including ratings, hours, and contact information. It requires a Brave Search API key on the Search plan and operates as step two of a two-step flow: first call web-search with result_filter=locations to collect POI IDs from locations.results[].id, then pass up to 20 IDs to local-pois for enriched records. Developers reach for local-pois when building location-aware agents or apps that need structured POI data beyond basic search snippets.643installs8Local Descriptionslocal-descriptions is a Brave Search API skill in brave-search-skills that turns POI IDs from prior web-search calls into AI-generated markdown business descriptions. The two-step flow requires `web-search` with result_filter=locations to read locations.results[].id values, then GET https://api.search.brave.com/res/v1/local/descriptions with up to 20 ids per request and X-Subscription-Token authentication on the Search plan. Responses return local_description objects with 200-400 word travel-guide tone copy using markdown headings, bullets, and emphasis; description may be null when unavailable. POI IDs are opaque strings valid for roughly eight hours. Developers reach for local-descriptions when building location pages, tourism guides, or local SEO templates that need narrative POI copy grounded in Brave web-search context rather than hand-written blurbs for every listing.627installs9Spellcheckspellcheck is an agent skill for the Brave Search Spellcheck API that corrects misspelled queries before search, retrieval, or "Did you mean?" UI steps run. Developers call `https://api.search.brave.com/res/v1/spellcheck/search` with an `X-Subscription-Token` header, passing `q` and optional `lang` parameters via cURL or equivalent HTTP clients. The skill is scoped for pre-search query cleanup when built-in endpoint spellcheck is unavailable or when agents need explicit correction logic. Most Brave Search endpoints already include spellcheck, so reach for this skill only when you want deterministic query normalization in custom agent pipelines. Requires a Brave Search API key on the Spellcheck subscription plan from the Brave Search API dashboard.627installs10Suggestsuggest is a Brave Search skill (brave/brave-search-skills) that calls the Brave Suggest API to return autocomplete queries as users type, typically in under 100 milliseconds. Developers supply a Brave Search API key from api.search.brave.com and hit endpoints such as https://api.search.brave.com/res/v1/suggest/search with curl or agent-driven HTTP calls. The skill supports rich suggestions with entity info and typo-resilient matching, making it useful when drafting landing-page headings, FAQ lists, or content calendars from real search demand signals. Reach for suggest when you need structured suggestion JSON before writing copy, not full web crawl results or ranked SERP pages.620installs11Bxbx in brave/brave-search-skills is the default web search interface for AI agents, exposing Brave Search through a CLI optimized for downstream parsing and ranking. Run bx "query" for token-budgeted page extracts ready for LLM context, bx answers for synthesized explanations, or bx web for traditional result lists. The skill covers deep research, news, images, videos, places, and custom ranking modes, and documents installation via curl from the brave-search-cli install script when bx is missing locally. bx requires a Brave Search API key and is triggered for web search, browse, lookups, documentation retrieval, RAG grounding, and agentic fact-checking. Developers reach for bx when agents need structured web results instead of raw HTML scraping, especially during research sprints, API doc discovery, or grounding answers before code changes. The all-in-one design replaces ad-hoc fetch-and-parse loops with pre-extracted content sized for model context windows.583installs12Bx SearchWraps the Brave Search CLI (bx) so an agent runs all web searches through it instead of the built-in web_search tool. Its default context command returns pre-extracted, token-budgeted web content for RAG grounding, while answers gives synthesized explanations and web supports search operators. A developer wires it in to give an agent token-efficient web search, news, images, and local results. It needs a Brave Search API key.5installs