Brave Search

brave_web_search

Performs web searches using the Brave Search API and returns comprehensive search results with rich metadata. When to use: - General web searches for information, facts, or current topics - Location-based queries (restaurants, businesses, points of interest) - News searches for recent events or breaking stories - Finding videos, discussions, or FAQ content - Research requiring diverse result types (web pages, images, reviews, etc.) Returns a JSON list of web results with title, description, and URL. When the "results_filter" parameter is empty, JSON results may also contain FAQ, Discussions, News, and Video results.

Remote brave

Other tools also called brave_web_search? See providers with this name

Input Schema


            {
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1,
      "description": "Number of results (1-20, default 10). Applies only to web search results (i.e., has no effect on locations, news, videos, etc.)"
    },
    "query": {
      "type": "string",
      "maxLength": 400,
      "description": "Search query (max 400 chars, 50 words)"
    },
    "units": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string",
      "description": "The measurement units. If not provided, units are derived from search country."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9,
      "minimum": 0,
      "description": "Pagination offset (max 9, default 0)"
    },
    "country": {
      "enum": [
        "ALL",
        "AR",
        "AU",
        "AT",
        "BE",
        "BR",
        "CA",
        "CL",
        "DK",
        "FI",
        "FR",
        "DE",
        "HK",
        "IN",
        "ID",
        "IT",
        "JP",
        "KR",
        "MY",
        "MX",
        "NL",
        "NZ",
        "NO",
        "CN",
        "PL",
        "PT",
        "PH",
        "RU",
        "SA",
        "ZA",
        "ES",
        "SE",
        "CH",
        "TW",
        "TR",
        "GB",
        "US"
      ],
      "type": "string",
      "default": "US",
      "description": "Search query country, where the results come from. The country string is limited to 2 character country codes of supported countries."
    },
    "goggles": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Goggles act as a custom re-ranking on top of Brave's search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, refer to the Goggles repository (i.e., https://github.com/brave/goggles-quickstart)."
    },
    "summary": {
      "type": "boolean",
      "description": "This parameter enables summary key generation in web search results. This is required for summarizer to be enabled."
    },
    "ui_lang": {
      "enum": [
        "es-AR",
        "en-AU",
        "de-AT",
        "nl-BE",
        "fr-BE",
        "pt-BR",
        "en-CA",
        "fr-CA",
        "es-CL",
        "da-DK",
        "fi-FI",
        "fr-FR",
        "de-DE",
        "zh-HK",
        "en-IN",
        "en-ID",
        "it-IT",
        "ja-JP",
        "ko-KR",
        "en-MY",
        "es-MX",
        "nl-NL",
        "en-NZ",
        "no-NO",
        "zh-CN",
        "pl-PL",
        "en-PH",
        "ru-RU",
        "en-ZA",
        "es-ES",
        "sv-SE",
        "fr-CH",
        "de-CH",
        "zh-TW",
        "tr-TR",
        "en-GB",
        "en-US",
        "es-US"
      ],
      "type": "string",
      "default": "en-US",
      "description": "The language of the UI. The 2 or more character language code for which the search results are provided."
    },
    "freshness": {
      "enum": [
        "pd",
        "pw",
        "pm",
        "py",
        "YYYY-MM-DDtoYYYY-MM-DD"
      ],
      "type": "string",
      "description": "Filters search results by when they were discovered. The following values are supported: 'pd' - Discovered within the last 24 hours. 'pw' - Discovered within the last 7 days. 'pm' - Discovered within the last 31 days. 'py' - Discovered within the last 365 days. 'YYYY-MM-DDtoYYYY-MM-DD' - Timeframe is also supported by specifying the date range e.g. 2022-04-01to2022-07-30."
    },
    "safesearch": {
      "enum": [
        "off",
        "moderate",
        "strict"
      ],
      "type": "string",
      "default": "moderate",
      "description": "Filters search results for adult content. The following values are supported: 'off' - No filtering. 'moderate' - Filters explicit content (e.g., images and videos), but allows adult domains in search results. 'strict' - Drops all adult content from search results. The default value is 'moderate'."
    },
    "spellcheck": {
      "type": "boolean",
      "default": true,
      "description": "Whether to spellcheck the provided query."
    },
    "search_lang": {
      "enum": [
        "ar",
        "eu",
        "bn",
        "bg",
        "ca",
        "zh-hans",
        "zh-hant",
        "hr",
        "cs",
        "da",
        "nl",
        "en",
        "en-gb",
        "et",
        "fi",
        "fr",
        "gl",
        "de",
        "gu",
        "he",
        "hi",
        "hu",
        "is",
        "it",
        "jp",
        "kn",
        "ko",
        "lv",
        "lt",
        "ms",
        "ml",
        "mr",
        "nb",
        "pl",
        "pt-br",
        "pt-pt",
        "pa",
        "ro",
        "ru",
        "sr",
        "sk",
        "sl",
        "es",
        "sv",
        "ta",
        "te",
        "th",
        "tr",
        "uk",
        "vi"
      ],
      "type": "string",
      "default": "en",
      "description": "Search language preference. The 2 or more character language code for which the search results are provided."
    },
    "result_filter": {
      "type": "array",
      "items": {
        "enum": [
          "discussions",
          "faq",
          "infobox",
          "news",
          "query",
          "summarizer",
          "videos",
          "web",
          "locations",
          "rich"
        ],
        "type": "string"
      },
      "default": [
        "web",
        "query"
      ],
      "description": "Result filter (default ['web', 'query'])"
    },
    "extra_snippets": {
      "type": "boolean",
      "description": "A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts. Only available under Free AI, Base AI, Pro AI, Base Data, Pro Data and Custom plans."
    },
    "text_decorations": {
      "type": "boolean",
      "default": true,
      "description": "Whether display strings (e.g. result snippets) should include decoration markers (e.g. highlighting characters)."
    }
  }
}