{ "schemaVersion": "1.0", "item": { "slug": "brave-api-search", "name": "Brave Api Search", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/Broedkrummen/brave-api-search", "canonicalUrl": "https://clawhub.ai/Broedkrummen/brave-api-search", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/brave-api-search", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=brave-api-search", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "_meta.json", "brave_answers.js", "brave_search.js", "brave_suggest.js", "skill.json" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/brave-api-search" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/brave-api-search", "agentPageUrl": "https://openagent3.xyz/skills/brave-api-search/agent", "manifestUrl": "https://openagent3.xyz/skills/brave-api-search/agent.json", "briefUrl": "https://openagent3.xyz/skills/brave-api-search/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Brave API Search", "body": "Real-time web search, autosuggest, and AI-powered answers using the official Brave Search API. Three tools:\n\nbrave_search — web results with titles, URLs, descriptions, optional AI summary\nbrave_suggest — query autosuggestions as users type with optional rich metadata\nbrave_answers — AI-grounded answers with inline citations powered by live web search" }, { "title": "Setup", "body": "Set your Brave API keys in a local .env file (recommended):\n\n# .env (do not commit)\nBRAVE_SEARCH_API_KEY=your_key_here\nBRAVE_ANSWERS_API_KEY=your_key_here\n\nOr export them in your shell session if needed.\n\nGet your keys at: https://api-dashboard.search.brave.com\n\nBoth keys can be the same if your plan supports both Search and AI Answers endpoints.\n\nNote: brave_search and brave_suggest use BRAVE_SEARCH_API_KEY. brave_answers requires BRAVE_ANSWERS_API_KEY.\n\nNote: This skill explicitly requires BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY. It does not use a generic BRAVE_API_KEY fallback." }, { "title": "When to Use This Skill", "body": "Use brave_search when:\n\nSearching for current information, news, or recent events\nLooking up documentation or technical references\nNeed ranked results with URLs to follow up on\nWant an AI summary of search results\n\nUse brave_suggest when:\n\nPower autocomplete in search interfaces\nHelp users formulate better queries faster\nNeed query completions as users type\nWant rich metadata (titles, descriptions, images) for suggestions\n\nUse brave_answers when:\n\nNeed a synthesized answer with cited sources\nResearching topics that benefit from multiple sources\nWant AI-grounded responses with inline citations\nDeep research mode needed (multi-search)\n\nDon't use this skill for:\n\nQuestions already answered from context or memory\nTasks that don't require external information" }, { "title": "brave_search", "body": "Web search returning ranked results with titles, URLs, and descriptions.\n\nbrave_search(query=\"latest Node.js release\", count=5)\nbrave_search(query=\"TypeScript generics\", extra_snippets=true)\nbrave_search(query=\"current weather Copenhagen\", freshness=\"pd\")\nbrave_search(query=\"React Server Components\", summary=true)\n\nParameters:\n\nquery (required) — Search query, supports operators: site:, \"exact phrase\", -exclude\ncount — Results to return (1-20, default: 10)\ncountry — 2-letter country code (default: us)\nfreshness — Date filter: pd (24h), pw (7 days), pm (31 days), py (1 year)\nextra_snippets — Include up to 5 extra text excerpts per result (default: false)\nsummary — Fetch Brave AI summarizer result (default: false)\n\nReturns: Formatted list of results with title, URL, description, and optional AI summary." }, { "title": "brave_suggest", "body": "Query autosuggest API providing intelligent query autocompletion as users type.\n\nbrave_suggest(query=\"hello\")\nbrave_suggest(query=\"pyt\", count=5, country=\"US\")\nbrave_suggest(query=\"einstein\", rich=true)\n\nParameters:\n\nquery (required) — Partial query to get suggestions for\ncount — Number of suggestions (1-10, default: 5)\ncountry — 2-letter country code (default: US)\nrich — Include enhanced metadata: titles, descriptions, images, entity detection (default: false, requires paid plan)\n\nReturns: List of query suggestions, optionally with rich metadata.\n\nBest Practices:\n\nImplement debouncing (150-300ms) to avoid excessive API calls as users type\nLoad suggestions asynchronously without blocking the UI" }, { "title": "brave_answers", "body": "AI-powered answers grounded in live web search with inline citations.\n\nbrave_answers(query=\"How does React Server Components work?\")\nbrave_answers(query=\"Compare Postgres vs MySQL for OLAP\", enable_research=true)\nbrave_answers(query=\"Latest Python release notes\", enable_citations=true)\n\nParameters:\n\nquery (required) — Question or topic to research\nenable_citations — Include inline source citations (default: true)\nenable_research — Multi-search deep research mode (default: false)\ncountry — Target country for search context (default: us)\n\nReturns: AI answer with cited sources extracted from the response, plus token usage." }, { "title": "Pricing & Limits", "body": "Brave pricing is credit-based and can change. Do not assume a fixed free request count.\n\nCurrent public guidance (verify in Brave dashboard/docs before production use):\n\nMonthly trial credits may be offered (e.g. $5 in monthly credits)\nSearch and Answers consume credits differently\nRich suggestions require a paid Autosuggest plan\nAnswers may also include token-based costs\nQPS limits depend on your plan tier\n\nAlways check your live limits and usage in:\n\nhttps://api-dashboard.search.brave.com\nhttps://brave.com/search/api/" }, { "title": "Security & Packaging Notes", "body": "This skill only calls Brave official endpoints under https://api.search.brave.com/res/v1.\nIt requires exactly two env vars: BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY (keep them in .env, not inline in commands/chats).\nIt does not request persistent/system privileges and does not modify system config.\nIt is source-file based (three local Node scripts), with no external install/download step." }, { "title": "API vs Web Scraping", "body": "This skill uses the official Brave Search API — not web scraping. Benefits:\n\nReliable, structured JSON responses\nRate limit headers and proper error messages\nAccess to AI summarizer, AI answers, and autosuggest endpoints\nTerms of service compliant" } ], "body": "Brave API Search\n\nReal-time web search, autosuggest, and AI-powered answers using the official Brave Search API. Three tools:\n\nbrave_search — web results with titles, URLs, descriptions, optional AI summary\nbrave_suggest — query autosuggestions as users type with optional rich metadata\nbrave_answers — AI-grounded answers with inline citations powered by live web search\nSetup\n\nSet your Brave API keys in a local .env file (recommended):\n\n# .env (do not commit)\nBRAVE_SEARCH_API_KEY=your_key_here\nBRAVE_ANSWERS_API_KEY=your_key_here\n\n\nOr export them in your shell session if needed.\n\nGet your keys at: https://api-dashboard.search.brave.com\n\nBoth keys can be the same if your plan supports both Search and AI Answers endpoints.\n\nNote: brave_search and brave_suggest use BRAVE_SEARCH_API_KEY. brave_answers requires BRAVE_ANSWERS_API_KEY.\n\nNote: This skill explicitly requires BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY. It does not use a generic BRAVE_API_KEY fallback.\n\nWhen to Use This Skill\n\nUse brave_search when:\n\nSearching for current information, news, or recent events\nLooking up documentation or technical references\nNeed ranked results with URLs to follow up on\nWant an AI summary of search results\n\nUse brave_suggest when:\n\nPower autocomplete in search interfaces\nHelp users formulate better queries faster\nNeed query completions as users type\nWant rich metadata (titles, descriptions, images) for suggestions\n\nUse brave_answers when:\n\nNeed a synthesized answer with cited sources\nResearching topics that benefit from multiple sources\nWant AI-grounded responses with inline citations\nDeep research mode needed (multi-search)\n\nDon't use this skill for:\n\nQuestions already answered from context or memory\nTasks that don't require external information\nTools\nbrave_search\n\nWeb search returning ranked results with titles, URLs, and descriptions.\n\nbrave_search(query=\"latest Node.js release\", count=5)\nbrave_search(query=\"TypeScript generics\", extra_snippets=true)\nbrave_search(query=\"current weather Copenhagen\", freshness=\"pd\")\nbrave_search(query=\"React Server Components\", summary=true)\n\n\nParameters:\n\nquery (required) — Search query, supports operators: site:, \"exact phrase\", -exclude\ncount — Results to return (1-20, default: 10)\ncountry — 2-letter country code (default: us)\nfreshness — Date filter: pd (24h), pw (7 days), pm (31 days), py (1 year)\nextra_snippets — Include up to 5 extra text excerpts per result (default: false)\nsummary — Fetch Brave AI summarizer result (default: false)\n\nReturns: Formatted list of results with title, URL, description, and optional AI summary.\n\nbrave_suggest\n\nQuery autosuggest API providing intelligent query autocompletion as users type.\n\nbrave_suggest(query=\"hello\")\nbrave_suggest(query=\"pyt\", count=5, country=\"US\")\nbrave_suggest(query=\"einstein\", rich=true)\n\n\nParameters:\n\nquery (required) — Partial query to get suggestions for\ncount — Number of suggestions (1-10, default: 5)\ncountry — 2-letter country code (default: US)\nrich — Include enhanced metadata: titles, descriptions, images, entity detection (default: false, requires paid plan)\n\nReturns: List of query suggestions, optionally with rich metadata.\n\nBest Practices:\n\nImplement debouncing (150-300ms) to avoid excessive API calls as users type\nLoad suggestions asynchronously without blocking the UI\nbrave_answers\n\nAI-powered answers grounded in live web search with inline citations.\n\nbrave_answers(query=\"How does React Server Components work?\")\nbrave_answers(query=\"Compare Postgres vs MySQL for OLAP\", enable_research=true)\nbrave_answers(query=\"Latest Python release notes\", enable_citations=true)\n\n\nParameters:\n\nquery (required) — Question or topic to research\nenable_citations — Include inline source citations (default: true)\nenable_research — Multi-search deep research mode (default: false)\ncountry — Target country for search context (default: us)\n\nReturns: AI answer with cited sources extracted from the response, plus token usage.\n\nPricing & Limits\n\nBrave pricing is credit-based and can change. Do not assume a fixed free request count.\n\nCurrent public guidance (verify in Brave dashboard/docs before production use):\n\nMonthly trial credits may be offered (e.g. $5 in monthly credits)\nSearch and Answers consume credits differently\nRich suggestions require a paid Autosuggest plan\nAnswers may also include token-based costs\nQPS limits depend on your plan tier\n\nAlways check your live limits and usage in:\n\nhttps://api-dashboard.search.brave.com\nhttps://brave.com/search/api/\nSecurity & Packaging Notes\nThis skill only calls Brave official endpoints under https://api.search.brave.com/res/v1.\nIt requires exactly two env vars: BRAVE_SEARCH_API_KEY and BRAVE_ANSWERS_API_KEY (keep them in .env, not inline in commands/chats).\nIt does not request persistent/system privileges and does not modify system config.\nIt is source-file based (three local Node scripts), with no external install/download step.\nAPI vs Web Scraping\n\nThis skill uses the official Brave Search API — not web scraping. Benefits:\n\nReliable, structured JSON responses\nRate limit headers and proper error messages\nAccess to AI summarizer, AI answers, and autosuggest endpoints\nTerms of service compliant" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/Broedkrummen/brave-api-search", "publisherUrl": "https://clawhub.ai/Broedkrummen/brave-api-search", "owner": "Broedkrummen", "version": "3.0.2", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/brave-api-search", "downloadUrl": "https://openagent3.xyz/downloads/brave-api-search", "agentUrl": "https://openagent3.xyz/skills/brave-api-search/agent", "manifestUrl": "https://openagent3.xyz/skills/brave-api-search/agent.json", "briefUrl": "https://openagent3.xyz/skills/brave-api-search/agent.md" } }