--- name: brave-api-search-81d674925adb description: Real-time web search and AI-powered answers using the official Brave Search API. Use for searching documentation, facts, current events, or any web content. Supports AI grounded answers with citations. Requires BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY. license: MIT metadata: author: Broedkrummen version: 2.1.1 --- # Brave API Search Real-time web search and AI-powered answers using the official Brave Search API. Two tools: - `brave_search` — web results with titles, URLs, descriptions, optional AI summary - `brave_answers` — AI-grounded answers with inline citations powered by live web search ## Setup Set your Brave API keys in a local `.env` file (recommended): ```bash # .env (do not commit) BRAVE_SEARCH_API_KEY=your_key_here BRAVE_ANSWERS_API_KEY=your_key_here ``` Or export them in your shell session if needed. Get your keys at: https://api-dashboard.search.brave.com Both keys can be the same if your plan supports both Search and AI Answers endpoints. > Note: This skill explicitly requires `BRAVE_SEARCH_API_KEY` and `BRAVE_ANSWERS_API_KEY`. It does **not** use a generic `BRAVE_API_KEY` fallback. ## When to Use This Skill **Use `brave_search` when:** - Searching for current information, news, or recent events - Looking up documentation or technical references - Need ranked results with URLs to follow up on - Want an AI summary of search results **Use `brave_answers` when:** - Need a synthesized answer with cited sources - Researching topics that benefit from multiple sources - Want AI-grounded responses with inline citations - Deep research mode needed (multi-search) **Don't use this skill for:** - Questions already answered from context or memory - Tasks that don't require external information ## Tools ### brave_search Web search returning ranked results with titles, URLs, and descriptions. ``` brave_search(query="latest Node.js release", count=5) brave_search(query="TypeScript generics", extra_snippets=true) brave_search(query="current weather Copenhagen", freshness="pd") brave_search(query="React Server Components", summary=true) ``` **Parameters:** - `query` (required) — Search query, supports operators: `site:`, `"exact phrase"`, `-exclude` - `count` — Results to return (1-20, default: 10) - `country` — 2-letter country code (default: `us`) - `freshness` — Date filter: `pd` (24h), `pw` (7 days), `pm` (31 days), `py` (1 year) - `extra_snippets` — Include up to 5 extra text excerpts per result (default: false) - `summary` — Fetch Brave AI summarizer result (default: false) **Returns:** Formatted list of results with title, URL, description, and optional AI summary. ### brave_answers AI-powered answers grounded in live web search with inline citations. ``` brave_answers(query="How does React Server Components work?") brave_answers(query="Compare Postgres vs MySQL for OLAP", enable_research=true) brave_answers(query="Latest Python release notes", enable_citations=true) ``` **Parameters:** - `query` (required) — Question or topic to research - `enable_citations` — Include inline source citations (default: true) - `enable_research` — Multi-search deep research mode (default: false) - `country` — Target country for search context (default: `us`) **Returns:** AI answer with cited sources extracted from the response, plus token usage. ## Pricing & Limits Brave pricing is credit-based and can change. Do **not** assume a fixed free request count. Current public guidance (verify in Brave dashboard/docs before production use): - Monthly trial credits may be offered (e.g. `$5 in monthly credits`) - Search and Answers consume credits differently - Answers may also include token-based costs - QPS limits depend on your plan tier Always check your live limits and usage in: - https://api-dashboard.search.brave.com - https://brave.com/search/api/ ## Security & Packaging Notes - This skill only calls Brave official endpoints under `https://api.search.brave.com/res/v1`. - It requires exactly two env vars: `BRAVE_SEARCH_API_KEY` and `BRAVE_ANSWERS_API_KEY` (keep them in `.env`, not inline in commands/chats). - It does not request persistent/system privileges and does not modify system config. - It is source-file based (two local Node scripts), with no external install/download step. ## API vs Web Scraping This skill uses the **official Brave Search API** — not web scraping. Benefits: - Reliable, structured JSON responses - Rate limit headers and proper error messages - Access to AI summarizer and AI answers endpoints - Terms of service compliant --- Source attribution: Broedkrummen Original project: https://github.com/meghal86/stacksignal/blob/54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44/.agents/skills/brave-api-search/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: Broedkrummen Original project: https://github.com/meghal86/stacksignal/blob/54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44/.agents/skills/brave-api-search/SKILL.md Attribution basis: Source repository record Fields of work: Marketing, Education & Research Roles: Marketing Analyst, Content Marketer, Researcher Specialties: API Tools: Brave Search Api Country applicability: Country not specified Classification basis: Source category, role and specialization labels Instruction SHA-256: a0d4aeb6aea5d2af49d32b56fc3287bd6d94a0eefb7d08655dc0d393bd4164d0