mcpField
B
brave-search

brave-search

github.com/badlogic生产力2.6k1.4k 次安装21 周前更新
代码仓库

关于 brave-search

通过 Brave Search API 进行网页搜索和页面内容提取的命令行技能，适用于查找最新信息或获取网页文本，无需交互式浏览器。

主要功能

  1. 01通过 Brave Search API 搜索网页
  2. 02设置结果数量和国家
  3. 03按日期或时间范围筛选
  4. 04以 Markdown 提取页面内容

适用场景

  1. 01查找文档和 API 参考资料
  2. 02核实最新事实与信息
  3. 03提取 URL 中的可读文本

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/badlogic/pi-skills --skill brave-search

安装后在 Claude Code 中输入/brave-search确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
content.js
package-lock.json
package.json
search.js

详细介绍

Brave Search

使用官方 Brave Search API 进行网络搜索和内容提取。无需浏览器。

设置

需要 Brave Search API 账户和免费订阅。创建免费订阅需要提供信用卡（不会向你收费）。

  1. 在 https://api-dashboard.search.brave.com/register 创建账户
  2. 创建一个“Free AI”订阅
  3. 为该订阅创建 API 密钥
  4. 添加到你的 shell 配置文件（zsh 用户使用 ~/.profile 或 ~/.zprofile）： 
    export BRAVE_API_KEY="your-api-key-here"
  5. 安装依赖（只需运行一次）： 
    cd {baseDir}
npm install

搜索

{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
选项
  • -n <num> - 结果数量（默认：5，最多：20）
  • --content - 获取页面内容并以 Markdown 格式包含在结果中
  • --country <code> - 两字母国家代码（默认：US）
  • --freshness <period> - 按时间筛选：
    • pd - 过去一天（24 小时）
    • pw - 过去一周
    • pm - 过去一个月
    • py - 过去一年
    • YYYY-MM-DDtoYYYY-MM-DD - 自定义日期范围

提取页面内容

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

获取 URL 并将可读内容提取为 Markdown。

输出格式

--- 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 ---
...

适用场景

  • 搜索文档或 API 参考资料
  • 查询事实或最新信息
  • 获取特定 URL 的内容
  • 任何需要进行网络搜索、但无需交互式浏览的任务

评论

支持 Markdown