AI-Agent-Toolkit brave-search

Brave Search Skill

install

source · Clone the upstream repo

git clone https://github.com/ngapngap/AI-Agent-Toolkit

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/ngapngap/AI-Agent-Toolkit "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agent/skills/brave-search" ~/.claude/skills/ngapngap-ai-agent-toolkit-brave-search && rm -rf "$T"

manifest: .agent/skills/brave-search/SKILL.md

source content

Brave Search Skill

Overview

Web search skill using Brave Search API for research phase.

Requirements

Environment Variable (Required)

BRAVE_API_KEY=your_brave_api_key_here

Get your API key at: https://brave.com/search/api/

Setup

Copy
```
.env.example
```
to
```
.env
```
in repo root
Set
```
BRAVE_API_KEY
```
in
```
.env
```

Run

node .agent/skills/orchestrator/scripts/selfcheck.js

to verify

Fallback Behavior

When

BRAVE_API_KEY

is not set:

Script returns mock results with warning
Pipeline can continue using GitHub search as alternative
Manual input also accepted

Usage

const { braveSearch } = require('./scripts/search.js');

const results = await braveSearch({
  query: 'best Node.js starter template 2024',
  count: 10
});

Inputs

```
query
```
- Search query string
```
count
```
- Number of results (default: 10)
```
freshness
```
- Time filter:
```
day
```
,
```
week
```
,
```
month
```
,
```
year
```

Outputs

{
  "results": [
    {
      "title": "...",
      "url": "...",
      "description": "...",
      "age": "2 days ago"
    }
  ],
  "query": "...",
  "total": 100
}

Integration

Used by

Architect

agent during Research phase to find patterns and solutions.

Fallback

If Brave API unavailable, falls back to

web_fetch

+ summarize.

Commands

# Search and output results
node .agent/skills/brave-search/scripts/search.js --query "your query" --count 10

# Search with freshness filter
node .agent/skills/brave-search/scripts/search.js --query "latest trends" --freshness week