Vincent - Brave Search for agents
Web and news search powered by Brave Search.
Skill by HeyVincent-ai
Chalk Labs
Need help deploying Vincent - Brave Search for agents?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/heyvincent-ai-vincent-brave-search-for-agents
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/vincent-brave-search-for-agents
Tools it pre-approves 5
From allowed-tools in SKILL.md: the agent may use these without asking you each time.
Read,Write,Bash(npx:@vincentai/cli*),Bash(jq:*),Bash(bc:*)
What's inside
- Skill name
Vincent - Brave Search for agents- Description
- Web and news search powered by Brave Search. Use this skill when users want to search the web, find news articles, or look up current information. Pay-per-call via Vincent credit system. Triggers on "search the web", "web search", "brave search", "search news", "find information", "look up", "current events".
- License
- MIT
- Allowed tools
- Read,, Write,, Bash(npx:@vincentai/cli*),, Bash(jq:*),, Bash(bc:*)
- Instructions
- 218 lines in SKILL.md · view on GitHub
Before installing
- Pre-approves some shell commands
Agent Skills spec issues
- name: only lowercase letters, digits and single hyphens allowed
- name: "Vincent - Brave Search for agents" does not match folder "brave-search"
Files (1)
- SKILL.md
SKILL.md (first lines)
# Vincent - Brave Search for agents
Use this skill to search the web and news using Brave Search. All requests are proxied through the Vincent backend, which handles authentication with the Brave Search API, enforces rate limits, tracks per-call costs, and deducts from your credit balance automatically.
**No API keys to manage.** The agent authenticates with a Vincent API key scoped to a `DATA_SOURCES` secret. Vincent handles the upstream Brave Search API credentials server-side -- the agent never sees or manages Brave API keys.
All commands use the `@vincentai/cli` package. API keys are stored and resolved automatically — you never handle raw keys or file paths.
## Security Model
This skill is designed for **autonomous agent operation with pay-per-call pricing and human oversight**.
**No environment variables are required** because this skill uses agent-first onboarding: the agent creates a `DATA_SOURCES` secret at runtime by calling the Vincent API, which returns a scoped API key. The CLI stores the returned API key automatically during creation. The config paths where the key is persisted (`${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/credentials/datasources/` or `./datasources/`) are declared in this skill's metadata.
**The agent's API key is not a Brave Search API key.** It is a scoped Bearer token for the Vincent proxy. The Vincent server authenticates with Brave Search on the agent's behalf. The agent cannot access the upstream API directly or bypass the proxy's credit and rate-limit enforcement.
**Model invocation is intentionally enabled.** The purpose of this skill is to give AI agents autonomous web search capabilities. The agent is expected to search the web and news on its own. The human controls spending through credit balance and payment method management at `https://heyvincent.ai`.
**All API calls go exclusively to `heyvincent.ai`** over HTTPS/TLS. The Vincent server then calls the Brave Search API. The agent does not contact Brave directly.
**Key lifecycle:**
- **Creation**: The agent runs `secret create` with `--type DATA_SOURCES` — the CLI stores the API key automatically and returns a `keyId` and `claimUrl`.
- **Claim**: The human operator uses the claim URL to take ownership, add credit, and manage payment at `https://heyvincent.ai`.
- **Credit**: Each API call costs a small amount (see Pricing below). The human adds credit via the frontend. Calls are rejected when credit runs out and no payment method is on file.
- **Revocation**: The secret owner can revoke the agent's API key at any time from the Vincent frontend.
## Pricing
| Endpoint | Cost per call |
| --- | --- |
| Web search | $0.005 |
| News search | $0.005 |
Credit is deducted automatically per call. The response includes `_vincent.creditRemainingUsd` so the agent can track remaining balance.
## Quick Start
### 1. Check for Existing Keys
Before creating a new secret, check if one already exists:
```bash
npx @vincentai/cli@latest secret list --type DATA_SOURCES
```
If a key is returned, use its `id` as the `--key-id` for all subsequent commands. If no keys exist, create a new secret.
### 2. Create a Data Sources Secret
```bash
npx @vincentai/cli@latest secret create --type DATA_SOURCES --memo "My agent data sources"
```
Returns `keyId` (use for all future commands) and `claimUrl` (share with the user).
After creating, tell the user:
> "Here is your data sources claim URL: `<claimUrl>`. Use this to claim ownership and add credit for Brave Search and other data sources at https://heyvincent.ai."
**Important:** The secret must be claimed and have credit (or a payment method on file) before API calls will succeed.
### 3. Web Search
```bash
npx @vincentai/cli@latest brave web --key-id <KEY_ID> --q "latest AI news" --count 10
```
Parameters:
- `--q` (required): Search query (1-400 characters)
- `--count` (optional): Number of results, 1-20 (default: 10)
- `--offset` (optional): Pagination offset, 0-9
- `--freshness` (optional): Time filter — `pd` (past day), `pw` (past week), `pm` (past month), `py` (past year)
- `--country` (optional): 2-letter country code for localized results (e.g., `us`, `gb`, `de`)
Returns web results with titles, URLs, descriptions, and metadata.
### 4. News Search
```bash
npx @vincentai/cli@latest brave news --key-id <KEY_ID> --q bitcoin --count 10
```
Parameters:
- `--q` (required): Search query (1-400 characters)
- `--count` (optional): Number of results, 1-20 (default: 10)
- `--freshness` (optional): Time filter — `pd` (past day), `pw` (past week), `pm` (past month), `py` (past year)
Returns news articles with titles, URLs, descriptions, publication dates, and source information.
## Response Metadata
Every successful response includes a `_vincent` object with:
```json
{
"_vincent": {
"costUsd": 0.005,
"creditRemainingUsd": 4.99
}
}
```
Use `creditRemainingUsd` to warn the user when credit is running low.
## Output Format
Web search results:
```json
{
"web": {
"results": [
{
"title": "Article Title",
"url": "https://example.com/article",
"description": "A brief description of the article content."From HeyVincent-ai/agent-skills, MIT.
Signals
- Stars
- 5
- Forks
- 1
- Open issues
- 0
- Last commit (this folder)
- Mar 2, 2026 (8 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/HeyVincent-ai/agent-skills
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get Vincent - Brave Search for agents running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
Vincent - Brave Search for agents skill. Agent Mart. https://agentmart.dev/skills/heyvincent-ai-vincent-brave-search-for-agents (last updated 2026-10-24)