核心用法
Vincent - Brave Search 是一款专为 AI 代理设计的付费搜索技能，通过 Vincent 代理后端代理访问 Brave Search API。用户无需自行申请或管理 Brave API 密钥，只需通过 Vincent CLI 创建 DATA_SOURCES 类型的密钥即可开始使用。
典型调用流程：
1. 检查现有密钥：secret list --type DATA_SOURCES
2. 创建新密钥：secret create --type DATA_SOURCES，获得 keyId 和 claimUrl
3. 执行搜索：brave web --key-id <KEY_ID> --q "搜索词" 或 brave news --key-id <KEY_ID> --q "关键词"
4. 可选参数：支持 --count（结果数）、--freshness（时间过滤）、--country（地区）、--offset（分页）
计费与充值：
- 每次调用 $0.005（网页/新闻同价）
- 支持两种充值方式：USDC 链上支付（x402 协议，代理可自主完成）或 Stripe 信用卡（需人工）
- 实时返回
creditRemainingUsd余额，支持自动充值脚本
显著优点
- 零密钥管理：代理不接触上游 API 密钥，安全由 Vincent 后端代理
- 按量付费：无月费，适合低频或间歇性搜索场景
- 代理原生：支持完全自主运行，包括自动余额检查和链上充值
- 多数据源复用：同一
DATA_SOURCES密钥可访问 Twitter、Brave Search 等多个数据源 - 响应透明：每次返回成本与余额，便于成本追踪
潜在局限
- 网络依赖：所有调用必须经
heyvincent.ai代理，存在单点故障风险 - 速率限制：60 请求/分钟，高并发场景需自行限流
- 充值门槛：USDC 充值要求钱包支持 x402 协议和 Base 链，普通用户可能更倾向信用卡
- 地域限制：Brave Search 本身对部分国家/地区结果质量参差不齐
- 代理权限：代理拥有充值能力（若配置钱包），需权衡便利性与资金安全
适合人群
- 需要实时网页/新闻数据的 AI 代理开发者
- 希望避免 API 密钥管理 overhead 的自动化工作流构建者
- 已有 USDC/加密货币支付基础设施的去中心化应用团队
- 搜索频次波动大、不愿承担固定月费的轻量级用户
常规风险
- 信用透支：余额耗尽且无支付方式时调用失败，需前置余额检查
- 密钥泄露：虽为作用域密钥，仍需保护
keyId，建议配合密钥轮换 - 服务连续性：依赖 Vincent 平台稳定性，建议实现降级策略（如本地缓存）
- 监管合规：加密货币充值涉及合规考量，企业用户需评估政策风险
- 代理过度消费：自动充值机制若配置不当可能导致资金快速消耗