Vincent - Brave Search
by @glitch003
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-ca...
1. Check for Existing Keys
Before creating a new secret, check if one already exists:
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
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: . 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
npx @vincentai/cli@latest brave web --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
npx @vincentai/cli@latest brave news --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.
clawhub install vincent-brave-search