{
  "markdown": "# Brave Search API Skills\n\nOfficial skills for using [Brave Search API](https://api.search.brave.com) with AI coding agents.\n\nWorks 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.\n\n<div align=\"center\">\n\n[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)\n\n</div>\n\n## Prerequisites\n\nGet a Brave Search API key at https://api.search.brave.com\n\n> **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.\n\n### Claude Code\n\nAdd to `~/.claude/settings.json` ([docs](https://code.claude.com/docs/en/settings)):\n\n```json\n{\n  \"env\": {\n    \"BRAVE_SEARCH_API_KEY\": \"your-key\"\n  }\n}\n```\n\nThis makes the key available in all Claude Code sessions. For per-project use, add to `.claude/settings.local.json` (gitignored) with the same format.\n\n### Cursor\n\n**Option 1 — direnv** (directory-scoped, auto-loads/unloads):\n\n```bash\n# Install direnv (https://direnv.net), then in your project directory:\necho 'export BRAVE_SEARCH_API_KEY=\"your-key\"' >> .envrc\ndirenv allow\n```\n\n**Option 2 — Shell profile** (`~/.zshrc` or `~/.bashrc`):\n\n```bash\nexport BRAVE_SEARCH_API_KEY=\"your-key\"\n```\n\nThen 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.\n\n### Codex\n\n**Option 1 — config.toml** ([docs](https://developers.openai.com/codex/config-reference)):\n\n```toml\n# ~/.codex/config.toml\n[shell_environment_policy]\nset = { BRAVE_SEARCH_API_KEY = \"your-key\" }\n```\n\n**Option 2 — Shell profile** (`~/.zshrc` or `~/.bashrc`):\n\n```bash\nexport BRAVE_SEARCH_API_KEY=\"your-key\"\n```\n\nThen restart your terminal. Codex reads environment variables from the shell (CLI, app, and IDE extension).\n\n### OpenClaw\n\nAdd to `~/.openclaw/.env` ([docs](https://docs.openclaw.ai/tools/skills)):\n\n```\nBRAVE_SEARCH_API_KEY=your-key\n```\n\nOr add to `~/.openclaw/openclaw.json` under the skill's config:\n\n```json\n{\n  \"skills\": {\n    \"entries\": {\n      \"brave-search\": {\n        \"env\": {\n          \"BRAVE_SEARCH_API_KEY\": \"your-key\"\n        }\n      }\n    }\n  }\n}\n```\n\n### Other agents\n\n**Option 1 — direnv** (directory-scoped, auto-loads/unloads):\n\n```bash\n# Install direnv (https://direnv.net), then in your project directory:\necho 'export BRAVE_SEARCH_API_KEY=\"your-key\"' >> .envrc\ndirenv allow\n```\n\n**Option 2 — Shell profile** (`~/.zshrc` or `~/.bashrc`):\n\n```bash\nexport BRAVE_SEARCH_API_KEY=\"your-key\"\n```\n\n## Installation\n\nAll agents below support the [Agent Skills](https://agentskills.io) standard and read SKILL.md files from their skills directory.\n\n### Claude Code\n\n[Skills documentation](https://code.claude.com/docs/en/skills)\n\n**Plugin marketplace** (auto-updates, no git needed):\n\n```\n/plugin marketplace add brave/brave-search-skills\n/plugin install brave-search-skills@brave-search\n```\n\n**curl** (no git, no marketplace):\n\n```bash\n# User-level (available in all projects)\nmkdir -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\n\n# Project-level\nmkdir -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\n```\n\n**Manual** (git clone + cp):\n\n```bash\ngit clone https://github.com/brave/brave-search-skills\ncp -r brave-search-skills/skills/* ~/.claude/skills/   # user-level\ncp -r brave-search-skills/skills/* .claude/skills/      # project-level\n```\n\n### Cursor\n\n[Skills documentation](https://cursor.com/docs/context/skills)\n\n**Remote Rule** (no terminal needed):\n\nSettings → Rules → Project Rules → Add Rule → Remote Rule → paste `https://github.com/brave/brave-search-skills`\n\n**curl:**\n\n```bash\n# Project-level\nmkdir -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\n\n# User-level\nmkdir -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\n```\n\n**Manual** (cp — requires git clone above):\n\n```bash\ncp -r brave-search-skills/skills/* .cursor/skills/      # project-level\ncp -r brave-search-skills/skills/* ~/.cursor/skills/     # user-level\n```\n\nCursor natively reads skills from `.cursor/skills/`, `.claude/skills/`, and `.codex/skills/` at both project and user level.\n\n### GitHub Copilot\n\n**curl:**\n\n```bash\nmkdir -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\n```\n\n**Manual** (cp — requires git clone above):\n\n```bash\ncp -r brave-search-skills/skills/* .github/skills/\n```\n\n### Codex\n\n[Skills documentation](https://developers.openai.com/codex/skills)\n\n**Skill installer** (built-in — ask Codex to install skills from `https://github.com/brave/brave-search-skills`).\n\n**curl:**\n\n```bash\n# User-level\nmkdir -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\n\n# Project-level\nmkdir -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\n```\n\n**Manual** (cp — requires git clone above):\n\n```bash\ncp -r brave-search-skills/skills/* ~/.agents/skills/    # user-level\ncp -r brave-search-skills/skills/* .agents/skills/       # project-level\n```\n\nCodex reads from `.agents/skills/` at repo, parent, root, and user levels. Skills work across the CLI, desktop app, and IDE extension.\n\n### Windsurf\n\n**curl:**\n\n```bash\n# Project-level\nmkdir -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\n\n# User-level\nmkdir -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\n```\n\n**Manual** (cp — requires git clone above):\n\n```bash\ncp -r brave-search-skills/skills/* .windsurf/skills/             # project-level\ncp -r brave-search-skills/skills/* ~/.codeium/windsurf/skills/   # user-level\n```\n\n### OpenClaw\n\n[Skills documentation](https://docs.openclaw.ai/tools/skills)\n\n**curl:**\n\n```bash\nmkdir -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\n```\n\n**Manual** (cp — requires git clone above):\n\n```bash\ncp -r brave-search-skills/skills/* ~/.openclaw/skills/\n```\n\n### Other Agents (Cline, Gemini CLI, Goose, Amp, Roo Code, etc.)\n\n**curl** (adjust the target directory for your agent):\n\n```bash\nmkdir -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\n```\n\nOr 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.\n\n### OpenSkills (Third-Party Universal Installer)\n\n```bash\nnpx openskills install brave/brave-search-skills\n```\n\nSee [openskills on GitHub](https://github.com/numman-ali/openskills) for details.\n\n### Updating\n\n**Claude Code marketplace**: updates automatically, or run `/plugin marketplace update brave-search`.\n\n**curl**: re-run the curl command above to overwrite with the latest version.\n\n**git clone**: pull the latest changes and re-copy:\n\n```bash\ncd brave-search-skills && git pull\ncp -r skills/* ~/.claude/skills/    # Claude Code\ncp -r skills/* .cursor/skills/      # Cursor\ncp -r skills/* .agents/skills/      # Codex\ncp -r skills/* ~/.openclaw/skills/  # OpenClaw\n```\n\nOr re-run the OpenSkills install command to overwrite with the latest version.\n\nSee the full list of compatible agents at [agentskills.io](https://agentskills.io).\n\n## Available Skills\n\n| Skill | Description | Endpoint | Best For |\n|-------|-------------|----------|----------|\n| **[bx](skills/bx/SKILL.md)** | All-in-one CLI over the endpoints below, with token-budgeted output | CLI | Agents and shell workflows — **recommended** |\n| **[llm-context](skills/llm-context/SKILL.md)** | Pre-extracted web content for LLM grounding (GET/POST) | `/res/v1/llm/context` | RAG, AI agents — **recommended** |\n| **[answers](skills/answers/SKILL.md)** | AI-grounded answers, OpenAI SDK compatible | `/res/v1/chat/completions` | Chat interfaces, cited answers |\n| **[web-search](skills/web-search/SKILL.md)** | Ranked web results with snippets and rich data | `/res/v1/web/search` | General search queries |\n| **[images-search](skills/images-search/SKILL.md)** | Image search with thumbnails (up to 200 results) | `/res/v1/images/search` | Finding images |\n| **[news-search](skills/news-search/SKILL.md)** | News articles with freshness filtering | `/res/v1/news/search` | Current events, breaking news |\n| **[videos-search](skills/videos-search/SKILL.md)** | Video search with duration/views/creator | `/res/v1/videos/search` | Finding video content |\n| **[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 |\n| **[local-pois](skills/local-pois/SKILL.md)** | Local business/POI details (ratings, hours, contact) | `/res/v1/local/pois` | Business info from POI IDs |\n| **[local-descriptions](skills/local-descriptions/SKILL.md)** | AI-generated POI text descriptions | `/res/v1/local/descriptions` | POI summaries from POI IDs |\n| **[suggest](skills/suggest/SKILL.md)** | Query autocomplete (<100ms response) | `/res/v1/suggest/search` | Search UX, query expansion |\n| **[spellcheck](skills/spellcheck/SKILL.md)** | Spell correction for query cleanup | `/res/v1/spellcheck/search` | Query preprocessing |\n\n## Quick Start\n\n### LLM Context (Recommended for AI)\n\nReturns search results with pre-extracted web content, optimized for LLM grounding:\n\n```bash\ncurl -X GET \"https://api.search.brave.com/res/v1/llm/context?q=search+API+for+grounding+LLMs\" \\\n  -H \"X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}\"\n```\n\n### Web Search\n\nStandard search with snippets, URLs, and metadata:\n\n```bash\ncurl -s \"https://api.search.brave.com/res/v1/web/search?q=retrieval+augmented+generation+explained\" \\\n  -H \"Accept: application/json\" \\\n  -H \"X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}\"\n```\n\n### Answers (AI-Grounded)\n\nOpenAI SDK-compatible endpoint for AI-grounded answers with citations.\n\nFast single-search (blocking):\n\n```bash\ncurl -X POST \"https://api.search.brave.com/res/v1/chat/completions\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}\" \\\n  -d '{\n    \"messages\": [{\"role\": \"user\", \"content\": \"What programming languages are trending in 2026?\"}],\n    \"stream\": false\n  }'\n```\n\nResearch mode (streaming required):\n\n```bash\ncurl -X POST \"https://api.search.brave.com/res/v1/chat/completions\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}\" \\\n  -d '{\n    \"messages\": [{\"role\": \"user\", \"content\": \"How are developers building AI-powered search applications in 2026?\"}],\n    \"stream\": true,\n    \"enable_research\": true\n  }'\n```\n\n## Goggles (Custom Ranking)\n\nBrave's unique feature lets you filter, boost, or downrank results:\n\n```bash\n# Focus on specific domains only\ncurl -X GET \"https://api.search.brave.com/res/v1/llm/context\" \\\n  -H \"X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}\" \\\n  -G \\\n  --data-urlencode \"q=rust programming\" \\\n  --data-urlencode 'goggles=$discard\n$site=docs.rs\n$site=rust-lang.org'\n```\n\nLearn more: https://search.brave.com/help/goggles\n\n## Documentation\n\n- **API Reference**: https://api.search.brave.com/docs\n- **Goggles Quickstart**: https://github.com/brave/goggles-quickstart\n- **Rate Limits**: Check your API plan at https://api.search.brave.com\n- **Agent Skills Standard**: https://agentskills.io/specification\n- **Claude Code Skills**: https://code.claude.com/docs/en/skills\n- **Cursor Skills**: https://cursor.com/docs/context/skills\n- **Codex Skills**: https://developers.openai.com/codex/skills\n- **OpenClaw Skills**: https://docs.openclaw.ai/tools/skills\n\n## License\n\nMIT\n",
  "bytes": 13200,
  "sha": "9d13dadc182980dd9be06a00698fb2f04483db6236d0a5a6741d540863c35c6f",
  "repo_slug": "brave/brave-search-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_brave_brave_search_skills_news_search_643fd03a/readme"
}