
这是一个高性能网盘资源搜索 API 服务(GitHub: fish2018/pansou, 13.3k stars),提供以下核心能力:
依赖要求说明Docker20.10+部署搜索服务(必需)Python3.6+运行脚本(仅标准库,无额外依赖)
bash
# 克隆到 skills 目录
git clone https://github.com/godzx001-dot/NDS.git ~/.hermes/skills/netdisk-search
然后在 Hermes 对话中说"搜资源"即可触发。
将仓库克隆到 OpenClaw 的 skills 目录:
bash
git clone https://github.com/godzx001-dot/NDS.git ~/.openclaw/skills/netdisk-search
或在 OpenClaw 配置中添加远程 skill 源。
bash
# 下载并解压
curl -L https://github.com/godzx001-dot/NDS/archive/main.zip -o nds.zip
unzip nds.zip -d ~/.hermes/skills/
mv ~/.hermes/skills/NDS-main ~/.hermes/skills/netdisk-search
rm nds.zip
安装 skill 后,需要先部署搜索服务(一次性操作):
bash
cd ~/.hermes/skills/netdisk-search
bash scripts/deploy.sh
或手动部署:
bash
docker run -d --name netdisk-search -p 8888:8888 --restart unless-stopped ghcr.io/fish2018/pansou:latest
验证部署成功:
bash
curl http://localhost:8888/api/health
安装后,在 Agent 对话中可以用自然语言触发:
text
用户: 帮我搜一下 "速度与激情" 的网盘资源
用户: 找一下 Python教程,只要百度和夸克
用户: 搜个唐朝诡事录,要合集不要预告
用户: 帮我找4K电影资源
Agent 会自动调用 search.py 执行搜索并格式化展示结果。
text
用户: 帮我检测一下这个链接还能不能用: https://pan.quark.cn/s/xxx
用户: 验证这几个链接是否有效(附链接列表)
Agent 会调用 check_links.py 检测并返回结果。
text
用户: 帮我部署一下网盘搜索服务
用户: 把网盘搜索部署到 9000 端口
Agent 会调用 deploy.sh 完成部署。
当 Agent 收到搜索请求时,执行流程:
text
用户: 搜一下 "Python教程"
↓
1. 探测 API 地址(NETDISK_API_URL > localhost:8888)
↓
2. 调用 scripts/search.py "Python教程"
↓
3. 解析结果,按网盘类型分组展示
↓
4. 返回格式化的搜索结果给用户
bash
cd ~/.hermes/skills/netdisk-search
# 基础搜索
python3 scripts/search.py "速度与激情"
# 指定网盘类型
python3 scripts/search.py "Python教程" --types baidu,quark
# 过滤结果
python3 scripts/search.py "唐朝诡事录" --include "合集" --exclude "预告"
# JSON 输出
python3 scripts/search.py "机器学习" --format json --limit 10
# 只搜插件(跳过TG频道)
python3 scripts/search.py "资源" --src plugin
bash
# 单个链接
python3 scripts/check_links.py --url "https://pan.quark.cn/s/xxx"
# 多个链接
python3 scripts/check_links.py --url "https://pan.quark.cn/s/xxx" --url "https://pan.baidu.com/s/yyy"
# 从文件读取
python3 scripts/check_links.py --file links.txt
bash
# 一键部署
bash scripts/deploy.sh
# 指定端口
bash scripts/deploy.sh --port 9000
# 含前端版本
bash scripts/deploy.sh --web
# 启用认证
bash scripts/deploy.sh --auth admin:mypassword
端点方法认证说明/api/searchPOST/GET可选搜索资源/api/check/linksPOST可选检测链接有效性/api/healthGET不需要健康检查/api/auth/loginPOST不需要登录获取 Token
bash
# 基础搜索
curl -X POST http://localhost:8888/api/search \
-H "Content-Type: application/json" \
-d '{"kw": "速度与激情"}'
# 带过滤
curl -X POST http://localhost:8888/api/search \
-H "Content-Type: application/json" \
-d '{
"kw": "唐朝诡事录",
"cloud_types": ["baidu", "quark"],
"filter": {"include": ["合集"], "exclude": ["预告"]}
}'
详细 API 文档见 references/api-reference.md
参数说明示例kw搜索关键词(必填)"速度与激情"``--types网盘类型过滤--types baidu,quark``--include结果必须包含的词--include "合集,全集"``--exclude结果排除的词--exclude "预告"``--src数据来源: all/tg/plugin--src plugin``--plugins指定插件--plugins labi,zhizhen``--refresh强制刷新缓存--refresh``--format输出格式--format json``--limit最大结果数--limit 50``--apiAPI 地址--api http://1.2.3.4:8888
参数说明示例--url待检测链接(可多次)--url "https://..."``--file从文件读取链接--file links.txt``--type网盘类型--type quark``--password提取码--password 1234``--proxy代理地址--proxy socks5://127.0.0.1:1080``--format输出格式--format json
网盘标识可检测网盘标识可检测百度网盘baidu✅115网盘115✅阿里云盘aliyun✅PikPakpikpak❌夸克网盘quark✅迅雷网盘xunlei✅天翼云盘tianyi✅123网盘123✅UC网盘uc✅磁力链接magnet❌移动云盘mobile✅电驴链接ed2k❌
变量名说明默认值NETDISK_API_URLAPI 服务地址自动探测
API 地址探测优先级:
--api 参数NETDISK_API_URLhttp://localhost:8888(本地默认)Q: 连接被拒绝
bash
docker ps | grep netdisk-search # 检查容器是否运行
docker logs netdisk-search # 查看日志
docker restart netdisk-search # 重启
Q: 搜索结果为空
--src pluginQ: 链接检测超时
--proxy socks5://127.0.0.1:1080Skill定位适用场景netdisk-search底层通用搜索快速搜索、链接检测、API 集成pansou-resource-scraper业务应用资源分类、网站生成、批量采集
--refreshtext
netdisk-search/
├── SKILL.md # 本文件(Skill 主文档)
├── README.md # GitHub 项目文档
├── .gitignore
├── scripts/
│ ├── search.py # 搜索脚本(终端/JSON/Markdown 输出)
│ ├── check_links.py # 链接有效性检测脚本
│ └── deploy.sh # Docker 一键部署脚本
├── references/
│ └── api-reference.md # API 完整参考文档
└── templates/ # 预留模板目录
智能摘要工具,自动为长文本、文档、网页生成摘要,提取要点与关键词,支持自定义摘要长度。
MANDATORY before calling web_search, web_fetch, browser, or opencli. Contains required error-handling procedures (web_search failure → must guide user to configure API), fallback chain (opencli CLI covers 70+ sites as structured fallback before browser), and site-specific login URLs. Without reading this skill, you WILL handle failures incorrectly and miss available tools. Trigger on: 搜索/上网/查资料/打开网站/抓取网页/新闻/热点/web search/fetch/browser/opencli.
使用百度AI搜索引擎(BDSE)进行网络搜索。适用于获取实时信息、文档资料或研究课题。