Suggest
- 620 installs
- 164 repo stars
- Updated August 3, 2026
- brave/brave-search-skills
suggest is a Claude Code skill that queries Brave Search suggest and autocomplete endpoints for developers who need fast query variants, content angles, and keyword clusters before scoping pages or campaigns.
About
suggest 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.
- Autocomplete query expansion
- Demand and phrasing discovery
- Agent-integrated Brave API
- Keyword cluster seeding
- Low-friction research loops
Suggest by the numbers
- 620 all-time installs (skills.sh)
- Ranked #1,560 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
- Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/brave/brave-search-skills --skill suggestAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 620 |
|---|---|
| repo stars | ★ 164 |
| Last updated | August 3, 2026 |
| Repository | brave/brave-search-skills ↗ |
How do you fetch Brave Search autocomplete suggestions via API?
Query Brave Search suggest/autocomplete endpoints from Claude to discover query variants, content angles, and keyword clusters before scoping pages or campaigns.
Who is it for?
Developers and technical marketers scoping SEO pages or campaigns who want sub-100ms Brave autocomplete data inside Claude.
Skip if: Developers needing full ranked search results, page summaries, or offline keyword databases without Brave API access.
When should I use this skill?
The user needs autocomplete suggestions, query variants, keyword clusters, or Brave Suggest API examples before writing pages.
What you get
JSON suggestion lists, query variant clusters, and entity metadata from Brave Suggest API responses.
- autocomplete query list
- keyword cluster notes
By the numbers
- Brave Suggest responses documented under 100ms
- Uses api.search.brave.com/res/v1/suggest/search endpoint
Files
Suggest / Autocomplete
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
Quick Start (cURL)
Basic Suggestions
curl -s "https://api.search.brave.com/res/v1/suggest/search?q=how+to+" \
-H "Accept: application/json" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"With All Parameters
curl -s "https://api.search.brave.com/res/v1/suggest/search" \
-H "Accept: application/json" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
-G \
--data-urlencode "q=albert" \
--data-urlencode "country=US" \
--data-urlencode "lang=en" \
--data-urlencode "count=10" \
--data-urlencode "rich=true"Endpoint
GET https://api.search.brave.com/res/v1/suggest/searchAuthentication: X-Subscription-Token: <API_KEY> header
Optional Headers:
Accept-Encoding: gzip— Enable response compression
Parameters
| 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 |
Response Fields
| 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 Response Example (rich=true)
{
"type": "suggest",
"query": { "original": "albert" },
"results": [
{
"query": "albert einstein",
"is_entity": true,
"title": "Albert Einstein",
"description": "German-born theoretical physicist",
"img": "https://imgs.search.brave.com/..."
},
{ "query": "albert einstein quotes", "is_entity": false }
]
}Use Cases
- Search-as-you-type UI: Real-time autocomplete dropdown. Debounce 150-300ms.
- Query refinement for RAG: Expand partial/ambiguous queries before calling
web-searchorllm-context. - Entity detection: Use
rich=trueto detect entities with title, description, and image for preview cards. - Typo-tolerant input: Get clean suggestions from misspelled input without separate spellcheck.
Notes
- Latency: Designed for <100ms response times
- Country/lang: Hints for suggestion relevance, not strict filters
- Typo handling: Suggestions handle common typos without separate spellcheck
Related skills
Setup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196k
Lark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402k
CavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7k
Lark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16k
Running Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72
Codex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10How it compares
Use suggest for lightweight autocomplete clusters; use full Brave web search skills when you need ranked results and page summaries.
FAQ
Does the suggest skill require a Brave API key?
The suggest skill requires a Brave Search API key from https://api.search.brave.com, passed as the X-Subscription-Token header. Suggest access is included in Brave's Suggest plan per the skill README.
How fast is the Brave Suggest API?
The suggest skill documents Brave autocomplete as fast, under 100 milliseconds, returning suggested queries as users type. Responses are JSON from https://api.search.brave.com/res/v1/suggest/search.