npx skills add ...
npx skills add brave/brave-search-skills --skill suggest
npx skills add brave/brave-search-skills --skill suggest
USE FOR query autocomplete/suggestions. Fast (<100ms). Returns suggested queries as user types. Supports rich suggestions with entity info. Typo-resilient.
Requires API Key: Get one at https://api.search.brave.com
Plan: Included in the Suggest plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe
Authentication: X-Subscription-Token: <API_KEY> header
Optional Headers:
Accept-Encoding: gzip — Enable response compression| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | Yes | — | Suggest search query (1-400 chars, max 50 words) |
lang | string | No | en | Language preference (2+ char language code, e.g. fr, de, zh-hans) |
country | string | No | US | Search country (2-letter country code or ALL) |
count | int | No | 5 | Number of suggestions (1-20). Actual results may be fewer |
rich | bool | No | false | Enhance with entity info (title, description, image). Paid Search plan required |
| Field | Type | Description |
|---|---|---|
type | string | Always "suggest" |
query.original | string | The original suggest search query |
results | array | List of suggestions (may be empty) |
results[].query | string | Suggested query completion |
results[].is_entity | bool? | Whether the suggested enriched query is an entity (rich only) |
results[].title | string? | The suggested query enriched title (rich only) |
results[].description | string? | The suggested query enriched description (rich only) |
results[].img | string? | The suggested query enriched image URL (rich only) |
Fields with null values are excluded from the response. Non-rich results contain only the query field.
rich=true)web-search or llm-context.rich=true to detect entities with title, description, and image for preview cards.