searchport

Name: searchport
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords搜索与检索02 周前更新

代码仓库

关于 searchport

searchport 是通过 Brave Search API 搜索网页、本地商家、新闻、图片和视频的命令行工具及 stdio MCP 服务。它以统一格式返回结果，并需要 Brave API 订阅密钥。

主要功能

01支持五类 Brave 搜索
02返回格式化结果详情
03命令行与 stdio MCP 服务
04可设置结果数量和偏移量

适用场景

01搜索新闻和网页内容
02查找本地商家及评分
03查找图片和视频结果

MCP 相关

向 MCP 客户端提供网页、本地、新闻、图片和视频搜索五种工具。搜索需要设置 BRAVE_API_KEY 环境变量。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-searchport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/searchport"
      ]
    }
  }
}

启动命令npx -y @reneturcios/searchport

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/searchport0.1.0stdio

ocighcr.io/cloudcorprecords/searchport:0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
count	number	否	可选：每页返回的网络搜索结果数，范围为 1 到 20；默认值为 10。
query	string	是	要在 Brave 网络搜索索引中搜索的查询词。
offset	number	否	可选：网络搜索结果的分页偏移量，范围为 0 到 9；默认值为 0。

详细介绍

searchport

searchport 是通往五种 Brave 搜索的一扇门。一个问题可以针对通用 Web 索引、本地商家列表、最新新闻、图片或视频进行搜索，而每个答案的格式都相同：标题、所在地址、一段简短摘要，以及一行符合搜索类型的补充信息——例如新闻发布了多久、视频时长、商店位置和评分。它既可以从命令行运行，也可以作为供 Agent 使用的 MCP 服务运行。

需要订阅 Brave Search API 的密钥。将其放入 BRAVE_API_KEY 环境变量中；密钥会作为 X-Subscription-Token 标头发送到 API，且不会出现在输出中。如果缺少该变量，每次搜索都会失败，并显示指出该变量名的错误。

安装

npx @reneturcios/searchport web "trail running shoes"

或者运行容器镜像：

docker run -i -e BRAVE_API_KEY ghcr.io/cloudcorprecords/searchport

容器默认启动 MCP 服务（见下文）。传入 CLI 参数即可将其用作 CLI。

CLI

export BRAVE_API_KEY="your subscription key"

# General web search; --count is results per page (max 20),
# --offset pages forward (max 9)
searchport web "composting basics"
searchport web "composting basics" --count 5 --offset 1

# The other four kinds take the same query and --count
searchport local "bakery near the mission" --count 5
searchport news "trail network vote"
searchport images "ridge sunrise"
searchport videos "trail running form"

# Machine-readable output for any kind
searchport web "composting basics" --json

searchport --version

退出代码：成功时为 0，搜索失败时为 1（包括缺少 BRAVE_API_KEY 或 API 错误），用法错误时为 2。

MCP 服务

同一个可执行文件支持这两种模式。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/searchport mcp

MCP 客户端配置：

{
  "mcpServers": {
    "searchport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/searchport", "mcp"],
      "env": { "BRAVE_API_KEY": "your subscription key" }
    }
  }
}

工具

工具	输入	返回内容
`brave_web_search`	`query`（字符串，必填）、`count`（数字，可选）、`offset`（数字，可选）	编号文本块形式的 Web 搜索结果：每条结果包含标题、URL 和摘要。
`brave_local_search`	`query`（字符串，必填）、`count`（数字，可选）	本地商家列表：名称、URL，以及一行详细信息；若 API 提供，则包含地址、电话和评分。
`brave_news_search`	`query`（字符串，必填）、`count`（数字，可选）	新闻报道：标题、URL、摘要和报道发布时长。
`brave_image_search`	`query`（字符串，必填）、`count`（数字，可选）	图片结果：标题、来源页面 URL 和图片直链。
`brave_video_search`	`query`（字符串，必填）、`count`（数字，可选）	视频结果：标题、URL、描述和时长。

结果数量会限制在 API 每页上限 20 条以内，偏移量会限制在最大值 9 以内。没有结果时会如实报告，而不会视为错误；缺少密钥或 API 调用失败时，则会报告工具错误。

开发

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx