Back to Skills

web-search

USE FOR web search. Returns ranked results with snippets, URLs, thumbnails. Supports freshness filters, SafeSearch, Goggles for custom ranking, pagination. Primary search endpoint.

133stars9forksUpdated 5/18/2026

Security Assessment

Safe(100/100)
Security Score100/100

About web-search

The web-search skill provides programmatic access to the Brave Search engine, allowing users to perform online searches and retrieve structured results. This skill is designed to return ranked search results that include snippets, URLs, thumbnails, and metadata, helping developers and applications integrate web search functionality directly into their workflows. By supporting features like SafeSearch, freshness filters, and custom ranking through Goggles, it solves the problem of quickly obtaining relevant and filtered information from the web in a structured format suitable for automated systems and user interfaces.

The skill supports both GET and POST HTTP methods, making it flexible for handling simple queries or complex, longer queries that may include Goggles configurations for custom result ranking. Parameters allow precise control over the search, including country, language, number of results, content filtering, date ranges, and additional features like text decorations, spellcheck, and rich callbacks. The freshness and result filtering options enable users to narrow down searches to specific timeframes or result types such as news, videos, discussions, and more. Authentication is managed via an API key, ensuring secure access to the service.

Web-search is ideal for developers building search interfaces, data extraction tools, or applications that require high-speed access to curated search results. Target users include those creating search UIs, agents, or dashboards that need structured data from the web, as well as systems that leverage search to enhance AI pipelines and research workflows. Its combination of speed, flexibility, and structured output makes it particularly suitable for applications where fast retrieval of relevant web information is critical, while offering control over the presentation and ranking of results.

FAQ

How do I authenticate requests to the web-search skill?

You must include your API key in the request header using `X-Subscription-Token: <API_KEY>`. You can obtain a key from https://api.search.brave.com.

Can I filter results by freshness or content type?

Yes, the skill supports freshness filters such as past day, week, month, or year, as well as custom date ranges. Result types like news, videos, discussions, FAQ, and more can be filtered using the `result_filter` parameter.

Which HTTP methods are supported for searching?

Both GET and POST methods are supported. POST is recommended for long queries or when using complex Goggles configurations.

Is SafeSearch available in web-search?

Yes, you can set the `safesearch` parameter to `off`, `moderate`, or `strict` to control adult content filtering.

What is Goggles and how does it work?

Goggles is a feature for custom ranking of search results, either by providing a URL or inline configuration. It allows fine-grained control over how results are scored and displayed.

Install web-search

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill