Skip to content
Back to search

brave-search

MarketplaceWorks with Claude CodeGitHub

Official skills for using Brave Search API with AI coding agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/brave/brave-search-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/brave/brave-search-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/brave-brave-search-skills/badge.svg)](/listings/brave-brave-search-skills)

HTML

<a href="/listings/brave-brave-search-skills"><img src="/api/listings/brave-brave-search-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

All agents below support the [Agent Skills](https://agentskills.io) standard and read SKILL.md files from their skills directory.

Claude Code

[Skills documentation](https://code.claude.com/docs/en/skills)

**Plugin marketplace** (auto-updates, no git needed):

/plugin marketplace add brave/brave-search-skills
/plugin install brave-search-skills@brave-search

**curl** (no git, no marketplace):

# User-level (available in all projects)
mkdir -p ~/.claude/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.claude/skills --strip-components=2 brave-search-skills-main/skills

# Project-level
mkdir -p .claude/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .claude/skills --strip-components=2 brave-search-skills-main/skills

**Manual** (git clone + cp):

git clone https://github.com/brave/brave-search-skills
cp -r brave-search-skills/skills/* ~/.claude/skills/   # user-level
cp -r brave-search-skills/skills/* .claude/skills/      # project-level

Cursor

[Skills documentation](https://cursor.com/docs/context/skills)

**Remote Rule** (no terminal needed):

Settings → Rules → Project Rules → Add Rule → Remote Rule → paste `https://github.com/brave/brave-search-skills`

**curl:**

# Project-level
mkdir -p .cursor/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .cursor/skills --strip-components=2 brave-search-skills-main/skills

# User-level
mkdir -p ~/.cursor/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.cursor/skills --strip-components=2 brave-search-skills-main/skills

**Manual** (cp — requires git clone above):

cp -r brave-search-skills/skills/* .cursor/skills/      # project-level
cp -r brave-search-skills/skills/* ~/.cursor/skills/     # user-level

Cursor natively reads skills from `.cursor/skills/`, `.claude/skills/`, and `.codex/skills/` at both project and user level.

GitHub Copilot

**curl:**

mkdir -p .github/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .github/skills --strip-components=2 brave-search-skills-main/skills

**Manual** (cp — requires git clone above):

cp -r brave-search-skills/skills/* .github/skills/

Codex

[Skills documentation](https://developers.openai.com/codex/skills)

**Skill installer** (built-in — ask Codex to install skills from `https://github.com/brave/brave-search-skills`).

**curl:**

# User-level
mkdir -p ~/.agents/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.agents/skills --strip-components=2 brave-search-skills-main/skills

# Project-level
mkdir -p .agents/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .agents/skills --strip-components=2 brave-search-skills-main/skills

**Manual** (cp — requires git clone above):

cp -r brave-search-skills/skills/* ~/.agents/skills/    # user-level
cp -r brave-search-skills/skills/* .agents/skills/       # project-level

Codex reads from `.agents/skills/` at repo, parent, root, and user levels. Skills work across the CLI, desktop app, and IDE extension.

Windsurf

**curl:**

# Project-level
mkdir -p .windsurf/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .windsurf/skills --strip-components=2 brave-search-skills-main/skills

# User-level
mkdir -p ~/.codeium/windsurf/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.codeium/windsurf/skills --strip-components=2 brave-search-skills-main/skills

**Manual** (cp — requires git clone above):

cp -r brave-search-skills/skills/* .windsurf/skills/             # project-level

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 30 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "brave-search",
  3. "owner": {
  4. "name": "Brave Software"
  5. },
  6. "plugins": [
  7. {
  8. "name": "brave-search-skills",
  9. "source": "./",
  10. "version": "1.5.0",
  11. "description": "Official Brave Search API skills for AI coding agents",
  12. "strict": false,
  13. "skills": [
  14. "./skills/answers",
  15. "./skills/bx",
  16. "./skills/search",
  17. "./skills/images-search",
  18. "./skills/llm-context",
  19. "./skills/local-descriptions",
  20. "./skills/local-pois",
  21. "./skills/news-search",
  22. "./skills/spellcheck",
  23. "./skills/suggest",
  24. "./skills/videos-search",
  25. "./skills/web-search",
  26. "./skills/local-place-search"
  27. ]
  28. }
  29. ]
  30. }
README.md · README · 378 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Brave Search API Skills
  2. Official skills for using [Brave Search API](https://api.search.brave.com) with AI coding agents.
  3. Works with **Claude Code**, **Cursor**, **GitHub Copilot**, **Codex**, **Gemini CLI**, **VS Code**, **Windsurf**, **OpenClaw**, **Cline**, **Goose**, **Amp**, **Roo Code**, and [many other agents](https://agentskills.io) that support the Agent Skills standard.
  4. <div align="center">
  5. [Prerequisites](#prerequisites) &nbsp;&middot;&nbsp; [Installation](#installation) &nbsp;&middot;&nbsp; [Available Skills](#available-skills) &nbsp;&middot;&nbsp; [Quick Start](#quick-start) &nbsp;&middot;&nbsp; [Goggles](#goggles-custom-ranking) &nbsp;&middot;&nbsp; [Documentation](#documentation)
  6. </div>
  7. ## Prerequisites
  8. Get a Brave Search API key at https://api.search.brave.com
  9. > **Security tip:** Prefer agent-native config over shell profile exports. Coding agents can access environment variables — scoped configs limit exposure. See [API key setup](docs/api-key-setup.md) for all options.
  10. ### Claude Code
  11. Add to `~/.claude/settings.json` ([docs](https://code.claude.com/docs/en/settings)):
  12. ```json
  13. {
  14. "env": {
  15. "BRAVE_SEARCH_API_KEY": "your-key"
  16. }
  17. }
  18. ```
  19. This makes the key available in all Claude Code sessions. For per-project use, add to `.claude/settings.local.json` (gitignored) with the same format.
  20. ### Cursor
  21. **Option 1 — direnv** (directory-scoped, auto-loads/unloads):
  22. ```bash
  23. # Install direnv (https://direnv.net), then in your project directory:
  24. echo 'export BRAVE_SEARCH_API_KEY="your-key"' >> .envrc
  25. direnv allow
  26. ```
  27. **Option 2 — Shell profile** (`~/.zshrc` or `~/.bashrc`):
  28. ```bash
  29. export BRAVE_SEARCH_API_KEY="your-key"
  30. ```
  31. Then restart Cursor (launch from terminal or fully quit and reopen — reloading the window is not enough). Cursor inherits environment variables from your shell. You can also add skills via **Settings > Rules > Add Rule > Remote Rule** using the GitHub URL.
  32. ### Codex
  33. **Option 1 — config.toml** ([docs](https://developers.openai.com/codex/config-reference)):
  34. ```toml
  35. # ~/.codex/config.toml
  36. [shell_environment_policy]
  37. set = { BRAVE_SEARCH_API_KEY = "your-key" }
  38. ```
  39. **Option 2 — Shell profile** (`~/.zshrc` or `~/.bashrc`):
  40. ```bash
  41. export BRAVE_SEARCH_API_KEY="your-key"
  42. ```
  43. Then restart your terminal. Codex reads environment variables from the shell (CLI, app, and IDE extension).
  44. ### OpenClaw
  45. Add to `~/.openclaw/.env` ([docs](https://docs.openclaw.ai/tools/skills)):
  46. ```
  47. BRAVE_SEARCH_API_KEY=your-key
  48. ```
  49. Or add to `~/.openclaw/openclaw.json` under the skill's config:
  50. ```json
  51. {
  52. "skills": {
  53. "entries": {
  54. "brave-search": {
  55. "env": {
  56. "BRAVE_SEARCH_API_KEY": "your-key"
  57. }
  58. }
  59. }
  60. }
  61. }
  62. ```
  63. ### Other agents
  64. **Option 1 — direnv** (directory-scoped, auto-loads/unloads):
  65. ```bash
  66. # Install direnv (https://direnv.net), then in your project directory:
  67. echo 'export BRAVE_SEARCH_API_KEY="your-key"' >> .envrc
  68. direnv allow
  69. ```
  70. **Option 2 — Shell profile** (`~/.zshrc` or `~/.bashrc`):
  71. ```bash
  72. export BRAVE_SEARCH_API_KEY="your-key"
  73. ```
  74. ## Installation
  75. All agents below support the [Agent Skills](https://agentskills.io) standard and read SKILL.md files from their skills directory.
  76. ### Claude Code
  77. [Skills documentation](https://code.claude.com/docs/en/skills)
  78. **Plugin marketplace** (auto-updates, no git needed):
  79. ```
  80. /plugin marketplace add brave/brave-search-skills
  81. /plugin install brave-search-skills@brave-search
  82. ```
  83. **curl** (no git, no marketplace):
  84. ```bash
  85. # User-level (available in all projects)
  86. mkdir -p ~/.claude/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.claude/skills --strip-components=2 brave-search-skills-main/skills
  87. # Project-level
  88. mkdir -p .claude/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .claude/skills --strip-components=2 brave-search-skills-main/skills
  89. ```
  90. **Manual** (git clone + cp):
  91. ```bash
  92. git clone https://github.com/brave/brave-search-skills
  93. cp -r brave-search-skills/skills/* ~/.claude/skills/ # user-level
  94. cp -r brave-search-skills/skills/* .claude/skills/ # project-level
  95. ```
  96. ### Cursor
  97. [Skills documentation](https://cursor.com/docs/context/skills)
  98. **Remote Rule** (no terminal needed):
  99. Settings → Rules → Project Rules → Add Rule → Remote Rule → paste `https://github.com/brave/brave-search-skills`
  100. **curl:**
  101. ```bash
  102. # Project-level
  103. mkdir -p .cursor/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .cursor/skills --strip-components=2 brave-search-skills-main/skills
  104. # User-level
  105. mkdir -p ~/.cursor/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.cursor/skills --strip-components=2 brave-search-skills-main/skills
  106. ```
  107. **Manual** (cp — requires git clone above):
  108. ```bash
  109. cp -r brave-search-skills/skills/* .cursor/skills/ # project-level
  110. cp -r brave-search-skills/skills/* ~/.cursor/skills/ # user-level
  111. ```
  112. Cursor natively reads skills from `.cursor/skills/`, `.claude/skills/`, and `.codex/skills/` at both project and user level.
  113. ### GitHub Copilot
  114. **curl:**
  115. ```bash
  116. mkdir -p .github/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .github/skills --strip-components=2 brave-search-skills-main/skills
  117. ```
  118. **Manual** (cp — requires git clone above):
  119. ```bash
  120. cp -r brave-search-skills/skills/* .github/skills/
  121. ```
  122. ### Codex
  123. [Skills documentation](https://developers.openai.com/codex/skills)
  124. **Skill installer** (built-in — ask Codex to install skills from `https://github.com/brave/brave-search-skills`).
  125. **curl:**
  126. ```bash
  127. # User-level
  128. mkdir -p ~/.agents/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.agents/skills --strip-components=2 brave-search-skills-main/skills
  129. # Project-level
  130. mkdir -p .agents/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .agents/skills --strip-components=2 brave-search-skills-main/skills
  131. ```
  132. **Manual** (cp — requires git clone above):
  133. ```bash
  134. cp -r brave-search-skills/skills/* ~/.agents/skills/ # user-level
  135. cp -r brave-search-skills/skills/* .agents/skills/ # project-level
  136. ```
  137. Codex reads from `.agents/skills/` at repo, parent, root, and user levels. Skills work across the CLI, desktop app, and IDE extension.
  138. ### Windsurf
  139. **curl:**
  140. ```bash
  141. # Project-level
  142. mkdir -p .windsurf/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C .windsurf/skills --strip-components=2 brave-search-skills-main/skills
  143. # User-level
  144. mkdir -p ~/.codeium/windsurf/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.codeium/windsurf/skills --strip-components=2 brave-search-skills-main/skills
  145. ```
  146. **Manual** (cp — requires git clone above):
  147. ```bash
  148. cp -r brave-search-skills/skills/* .windsurf/skills/ # project-level
  149. cp -r brave-search-skills/skills/* ~/.codeium/windsurf/skills/ # user-level
  150. ```
  151. ### OpenClaw
  152. [Skills documentation](https://docs.openclaw.ai/tools/skills)
  153. **curl:**
  154. ```bash
  155. mkdir -p ~/.openclaw/skills && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C ~/.openclaw/skills --strip-components=2 brave-search-skills-main/skills
  156. ```
  157. **Manual** (cp — requires git clone above):
  158. ```bash
  159. cp -r brave-search-skills/skills/* ~/.openclaw/skills/
  160. ```
  161. ### Other Agents (Cline, Gemini CLI, Goose, Amp, Roo Code, etc.)
  162. **curl** (adjust the target directory for your agent):
  163. ```bash
  164. mkdir -p <skills-dir> && curl -sL https://github.com/brave/brave-search-skills/archive/main.tar.gz | tar xz -C <skills-dir> --strip-components=2 brave-search-skills-main/skills
  165. ```
  166. Or copy skills from a git clone to the agent's skills directory. All agents following the [Agent Skills](https://agentskills.io) standard read SKILL.md files from their skills folder.
  167. ### OpenSkills (Third-Party Universal Installer)
  168. ```bash
  169. npx openskills install brave/brave-search-skills
  170. ```
  171. See [openskills on GitHub](https://github.com/numman-ali/openskills) for details.
  172. ### Updating
  173. **Claude Code marketplace**: updates automatically, or run `/plugin marketplace update brave-search`.
  174. **curl**: re-run the curl command above to overwrite with the latest version.
  175. **git clone**: pull the latest changes and re-copy:
  176. ```bash
  177. cd brave-search-skills && git pull
  178. cp -r skills/* ~/.claude/skills/ # Claude Code
  179. cp -r skills/* .cursor/skills/ # Cursor
  180. cp -r skills/* .agents/skills/ # Codex
  181. cp -r skills/* ~/.openclaw/skills/ # OpenClaw
  182. ```
  183. Or re-run the OpenSkills install command to overwrite with the latest version.
  184. See the full list of compatible agents at [agentskills.io](https://agentskills.io).
  185. ## Available Skills
  186. | Skill | Description | Endpoint | Best For |
  187. |-------|-------------|----------|----------|
  188. | **[bx](skills/bx/SKILL.md)** | All-in-one CLI over the endpoints below, with token-budgeted output | CLI | Agents and shell workflows — **recommended** |
  189. | **[llm-context](skills/llm-context/SKILL.md)** | Pre-extracted web content for LLM grounding (GET/POST) | `/res/v1/llm/context` | RAG, AI agents — **recommended** |
  190. | **[answers](skills/answers/SKILL.md)** | AI-grounded answers, OpenAI SDK compatible | `/res/v1/chat/completions` | Chat interfaces, cited answers |
  191. | **[web-search](skills/web-search/SKILL.md)** | Ranked web results with snippets and rich data | `/res/v1/web/search` | General search queries |
  192. | **[images-search](skills/images-search/SKILL.md)** | Image search with thumbnails (up to 200 results) | `/res/v1/images/search` | Finding images |
  193. | **[news-search](skills/news-search/SKILL.md)** | News articles with freshness filtering | `/res/v1/news/search` | Current events, breaking news |
  194. | **[videos-search](skills/videos-search/SKILL.md)** | Video search with duration/views/creator | `/res/v1/videos/search` | Finding video content |
  195. | **[local-place-search](skills/local-place-search/SKILL.md)** | Standalone place/POI search by coordinates or location string | `/res/v1/local/place_search` | Maps, "nearby", travel planning |
  196. | **[local-pois](skills/local-pois/SKILL.md)** | Local business/POI details (ratings, hours, contact) | `/res/v1/local/pois` | Business info from POI IDs |
  197. | **[local-descriptions](skills/local-descriptions/SKILL.md)** | AI-generated POI text descriptions | `/res/v1/local/descriptions` | POI summaries from POI IDs |
  198. | **[suggest](skills/suggest/SKILL.md)** | Query autocomplete (<100ms response) | `/res/v1/suggest/search` | Search UX, query expansion |
  199. | **[spellcheck](skills/spellcheck/SKILL.md)** | Spell correction for query cleanup | `/res/v1/spellcheck/search` | Query preprocessing |
  200. ## Quick Start
  201. ### LLM Context (Recommended for AI)
  202. Returns search results with pre-extracted web content, optimized for LLM grounding:
  203. ```bash
  204. curl -X GET "https://api.search.brave.com/res/v1/llm/context?q=search+API+for+grounding+LLMs" \
  205. -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"
  206. ```
  207. ### Web Search
  208. Standard search with snippets, URLs, and metadata:
  209. ```bash
  210. curl -s "https://api.search.brave.com/res/v1/web/search?q=retrieval+augmented+generation+explained" \
  211. -H "Accept: application/json" \
  212. -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"
  213. ```
  214. ### Answers (AI-Grounded)
  215. OpenAI SDK-compatible endpoint for AI-grounded answers with citations.
  216. Fast single-search (blocking):
  217. ```bash
  218. curl -X POST "https://api.search.brave.com/res/v1/chat/completions" \
  219. -H "Content-Type: application/json" \
  220. -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  221. -d '{
  222. "messages": [{"role": "user", "content": "What programming languages are trending in 2026?"}],
  223. "stream": false
  224. }'
  225. ```
  226. Research mode (streaming required):
  227. ```bash
  228. curl -X POST "https://api.search.brave.com/res/v1/chat/completions" \
  229. -H "Content-Type: application/json" \
  230. -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  231. -d '{
  232. "messages": [{"role": "user", "content": "How are developers building AI-powered search applications in 2026?"}],
  233. "stream": true,
  234. "enable_research": true
  235. }'
  236. ```
  237. ## Goggles (Custom Ranking)
  238. Brave's unique feature lets you filter, boost, or downrank results:
  239. ```bash
  240. # Focus on specific domains only
  241. curl -X GET "https://api.search.brave.com/res/v1/llm/context" \
  242. -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \
  243. -G \
  244. --data-urlencode "q=rust programming" \
  245. --data-urlencode 'goggles=$discard
  246. $site=docs.rs
  247. $site=rust-lang.org'
  248. ```
  249. Learn more: https://search.brave.com/help/goggles
  250. ## Documentation
  251. - **API Reference**: https://api.search.brave.com/docs
  252. - **Goggles Quickstart**: https://github.com/brave/goggles-quickstart
  253. - **Rate Limits**: Check your API plan at https://api.search.brave.com
  254. - **Agent Skills Standard**: https://agentskills.io/specification
  255. - **Claude Code Skills**: https://code.claude.com/docs/en/skills
  256. - **Cursor Skills**: https://cursor.com/docs/context/skills
  257. - **Codex Skills**: https://developers.openai.com/codex/skills
  258. - **OpenClaw Skills**: https://docs.openclaw.ai/tools/skills
  259. ## License
  260. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.