Brave search

Skill markacianfrani/armor/skills/brave-search

Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.From its SKILL.md

Install

npx -y skills add markacianfrani/armor --skill brave-search

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.3 KB, 568 tokens by cl100k_base, as published. Nobody here has run it

Brave Search

Web search and content extraction using the official Brave Search API. No browser required.

Setup

Requires a Brave Search API account with a free subscription. A credit card is required to create the free subscription (you won't be charged).

Create an account at https://api-dashboard.search.brave.com/register
Create a "Free AI" subscription
Create an API key for the subscription
Add to your shell profile (~/.profile or ~/.zprofile for zsh):
```
export BRAVE_API_KEY="your-api-key-here"
```
Install dependencies (run once):
```
cd {baseDir}
npm install
```

Search

{baseDir}/search.js "query"                         # Basic search (5 results)
{baseDir}/search.js "query" -n 10                   # More results (max 20)
{baseDir}/search.js "query" --content               # Include page content as markdown
{baseDir}/search.js "query" --freshness pw          # Results from last week
{baseDir}/search.js "query" --freshness 2024-01-01to2024-06-30  # Date range
{baseDir}/search.js "query" --country DE            # Results from Germany
{baseDir}/search.js "query" -n 3 --content          # Combined options

Options

-n <num> - Number of results (default: 5, max: 20)
--content - Fetch and include page content as markdown
--country <code> - Two-letter country code (default: US)
--freshness <period> - Filter by time:
- pd - Past day (24 hours)
- pw - Past week
- pm - Past month
- py - Past year
- YYYY-MM-DDtoYYYY-MM-DD - Custom date range

Extract Page Content

{baseDir}/content.js https://example.com/article

Fetches a URL and extracts readable content as markdown.

Output Format

--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Age: 2 days ago
Snippet: Description from search results
Content: (if --content flag used)
  Markdown content extracted from the page...

--- Result 2 ---
...

When to Use

Searching for documentation or API references
Looking up facts or current information
Fetching content from specific URLs
Any task requiring web search without interactive browsing