Potencialize seu agente
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirOverview
PanSou是一款高性能的网盘资源搜索API服务，支持TG频道和插件搜索。系统设计以性能和可扩展性为核心，支持多频道多插件并发搜索、结果智能排序和网盘类型分类。docker集成前后端，一键启动，开箱即用。仅供学习研究，请勿以各种形式用于盈利目的。 https://t.me/s/webhtv # PanSou 网盘搜索API PanSou是一个高性能的网盘资源搜索API服务，支持TG搜索和自定义插件搜索。系统设计以性能和可扩展性为核心，支持并发搜索、结果智能排序和网盘类型分类。 ## 特性（[详见系统设计文档](docs/%E7%B3%BB%E7%BB%9F%E5%BC%80%E5%8F%91%E8%AE%BE%E8%AE%A1%E6%96%87%E6%A1%A3.md)） - **高性能搜索**：并发执行多个TG频道及异步插件搜索，显著提升搜索速度；工作池设计，高效管理并发任务 -
Tools
No tool list yet. Remote servers get one after the first health check.
PanSou是一款高性能的网盘资源搜索API服务，支持TG频道和插件搜索。系统设计以性能和可扩展性为核心，支持多频道多插件并发搜索、结果智能排序和网盘类型分类。docker集成前后端，一键启动，开箱即用。仅供学习研究，请勿以各种形式用于盈利目的。 https://t.me/s/webhtv
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Pansou runs locally over stdio.
Last checked 2026-11-13. PanSou是一款高性能的网盘资源搜索API服务，支持TG频道和插件搜索。系统设计以性能和可扩展性为核心，支持多频道多插件并发搜索、结果智能排序和网盘类型分类。docker集成前后端，一键启动，开箱即用。仅供学习研究，请勿以各种形式用于盈利目的。 https://t.me/s/webhtv # PanSou 网盘搜索API PanSou是一个高性能的网盘资源搜索API服务，支持TG搜索和自定义插件搜索。系统设计以性能和可扩展性为核心，支持并发搜索、结果智能排序和网盘类型分类。 ## 特性（[详见系统设计文档](docs/%E7%B3%BB%E7%BB%9F%E5%BC%80%E5%8F%91%E8%AE%BE%E8%AE%A1%E6%96%87%E6%A1%A3.md)） - **高性能搜索**：并发执行多个TG频道及异步插件搜索，显著提升搜索速度；工作池设计，高效管理并发任务 -
From the publisher
PanSou是一个高性能的网盘资源搜索API服务，支持TG搜索和自定义插件搜索。系统设计以性能和可扩展性为核心，支持并发搜索、结果智能排序和网盘类型分类。
百度网盘 (baidu)、阿里云盘 (aliyun)、夸克网盘 (quark)、光鸭云盘 (guangya)、天翼云盘 (tianyi)、UC网盘 (uc)、移动云盘 (mobile)、115网盘 (115)、PikPak (pikpak)、迅雷网盘 (xunlei)、123网盘 (123)、磁力链接 (magnet)、电驴链接 (ed2k)、其他 (others)
在 Github 上先
本项目，并点上 Star !!!
一键启动，开箱即用
docker run -d --name pansou -p 80:80 ghcr.io/fish2018/pansou-web
# 下载配置文件
curl -o docker-compose.yml https://raw.githubusercontent.com/fish2018/pansou-web/refs/heads/main/docker-compose.yml
# 启动服务
docker-compose up -d
# 查看日志
docker-compose logs -f
docker run -d --name pansou -p 8888:8888 ghcr.io/fish2018/pansou:latest
# 下载配置文件
curl -o docker-compose.yml https://raw.githubusercontent.com/fish2018/pansou/refs/heads/main/docker-compose.yml
# 启动服务
docker-compose up -d
# 访问服务
http://localhost:8888
git clone https://github.com/fish2018/pansou.git
cd pansou
PanSou支持可选的安全认证功能，默认关闭。开启后，所有API接口（除登录接口外）都需要提供有效的JWT Token。详见认证系统设计文档。
认证配置示例：
# 启用认证并配置单个用户
docker run -d --name pansou -p 8888:8888 \
-e AUTH_ENABLED=true \
-e AUTH_USERS=admin:admin123 \
-e AUTH_TOKEN_EXPIRY=24 \
ghcr.io/fish2018/pansou:latest
# 配置多个用户
docker run -d --name pansou -p 8888:8888 \
-e AUTH_ENABLED=true \
-e AUTH_USERS=admin:pass123,user1:pass456,user2:pass789 \
ghcr.io/fish2018/pansou:latest
认证API接口：
POST /api/auth/login - 用户登录，获取TokenPOST /api/auth/verify - 验证Token有效性POST /api/auth/logout - 退出登录（客户端删除Token）使用Token调用API：
# 1. 登录获取Token
curl -X POST http://localhost:8888/api/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"admin123"}'
# 响应：{"token":"eyJhbGc...","expires_at":1234567890,"username":"admin"}
# 2. 使用Token调用搜索API
curl -X POST http://localhost:8888/api/search \
-H "Authorization: Bearer eyJhbGc..." \
-H "Content-Type: application/json" \
-d '{"kw":"速度与激情"}'
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags="-s -w -extldflags '-static'" -o pansou .
./pansou
[program:pansou]
environment=PORT=8888,CHANNELS="tgsearchers4,Aliyun_4K_Movies,bdbdndn11,yunpanx,bsbdbfjfjff,yp123pan,sbsbsnsqq,yunpanxunlei,tianyifc,BaiduCloudDisk,txtyzy,peccxinpd,gotopan,PanjClub,kkxlzy,baicaoZY,MCPH01,bdwpzhpd,ysxb48,jdjdn1111,yggpan,MCPH086,zaihuayun,Q66Share,Oscar_4Kmovies,ucwpzy,shareAliyun,alyp_1,dianyingshare,Quark_Movies,XiangxiuNBB,ydypzyfx,ucquark,xx123pan,yingshifenxiang123,zyfb123,tyypzhpd,tianyirigeng,cloudtianyi,hdhhd21,Lsp115,oneonefivewpfx,qixingzhenren,taoxgzy,Channel_Shares_115,tyysypzypd,vip115hot,wp123zy,yunpan139,yunpan189,yunpanuc,yydf_hzl,leoziyuan,pikpakpan,Q_dongman,yoyokuakeduanju",ENABLED_PLUGINS="labi,zhizhen,shandian,duoduo,muou"
command=/home/work/pansou/pansou
directory=/home/work/pansou
autostart=true
autorestart=true
startsecs=5
startretries=3
exitcodes=0
stopwaitsecs=10
stopasgroup=true
killasgroup=true
server {
listen 80;
server_name pansou.252035.xyz;
# 将 HTTP 重定向到 HTTPS
return 301 https://$host$request_uri;
}
limit_req_zone $binary_remote_addr zone=api_limit:10m rate=60r/m;
server {
listen 443 ssl http2;
server_name pansou.252035.xyz;
access_log /home/work/logs/pansou.log;
# 证书和密钥路径
ssl_certificate /etc/letsencrypt/live/252035.xyz/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/252035.xyz/privkey.pem;
# 增强 SSL 安全性
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers EECDH+AESGCM:EDH+AESGCM:AES256+EECDH:AES256+EDH;
ssl_prefer_server_ciphers on;
# 后端代理，应用限流
location / {
# 应用限流规则
limit_req zone=api_limit burst=10 nodelay;
# 当超过限制时返回 429 状态码
limit_req_status 429;
proxy_pass http://127.0.0.1:8888;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
当启用认证功能（AUTH_ENABLED=true）时，除登录和健康检测接口外的所有API接口都需要提供有效的JWT Token。
请求头格式：
Authorization: Bearer <your-jwt-token>
获取Token：
Authorization: Bearer <token>示例：
# 未启用认证时
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" \
-H "Authorization: Bearer eyJhbGc..." \
-d '{"kw":"速度与激情"}'
获取JWT Token用于后续API调用。
接口地址：/api/auth/login
请求方法：POST
Content-Type：application/json
是否需要认证：否
请求参数：
请求示例：
curl -X POST http://localhost:8888/api/auth/login \
-H "Content-Type: application/json" \
-d '{"username":"admin","password":"admin123"}'
成功响应：
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_at": 1234567890,
"username": "admin"
}
错误响应：
{
"error": "用户名或密码错误"
}
验证当前Token是否有效。
接口地址：/api/auth/verify
请求方法：POST
是否需要认证：是
请求示例：
curl -X POST http://localhost:8888/api/auth/verify \
-H "Authorization: Bearer eyJhbGc..."
成功响应：
{
"valid": true,
"username": "admin"
}
退出当前登录（客户端删除Token即可）。
接口地址：/api/auth/logout
请求方法：POST
是否需要认证：否
请求示例：
curl -X POST http://localhost:8888/api/auth/logout
成功响应：
{
"message": "退出成功"
}
搜索网盘资源。
接口地址：/api/search
请求方法：POST 或 GET
Content-Type：application/json（POST方法）
是否需要认证：取决于AUTH_ENABLED配置
POST请求参数：
GET请求参数：
POST请求示例：
# 未启用认证
curl -X POST http://localhost:8888/api/search \
-H "Content-Type: application/json" \
-d '{
"kw": "速度与激情",
"channels": ["tgsearchers3", "xxx"],
"conc": 2,
"refresh": true,
"res": "merge",
"src": "all",
"plugins": ["jikepan"],
"cloud_types": ["baidu", "quark"],
"ext": {
"title_en": "Fast and Furious",
"is_all": true
}
}'
# 启用认证时（需要添加Authorization头）
curl -X POST http://localhost:8888/api/search \
-H "Content-Type: application/json" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
-d '{
"kw": "速度与激情",
"res": "merge"
}'
# 使用过滤器（只返回包含“合集”或“全集”，且不包含“预告”或“花絮”的结果）
curl -X POST http://localhost:8888/api/search \
-H "Content-Type: application/json" \
-d '{
"kw": "唐朝诡事录",
"filter": {
"include": ["合集", "全集"],
"exclude": ["预告", "花絮"]
}
}'
GET请求示例：
# 未启用认证
curl "http://localhost:8888/api/search?kw=速度与激情&res=merge&src=tg"
# 启用认证时（需要添加Authorization头）
curl "http://localhost:8888/api/search?kw=速度与激情&res=merge" \
-H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
# 使用过滤器（GET方式需要URL编码JSON）
curl "http://localhost:8888/api/search?kw=唐朝诡事录&filter=%7B%22include%22%3A%5B%22合集%22%2C%22全集%22%5D%2C%22exclude%22%3A%5B%22预告%22%5D%7D"
成功响应：
{
"total": 15,
"results": [
{
"message_id": "12345",
"unique_id": "channel-12345",
"channel": "tgsearchers3",
"datetime": "2023-06-10T14:23:45Z",
"title": "速度与激情全集1-10",
"content": "速度与激情系列全集，1080P高清...",
"links": [
{
"type": "baidu",
"url": "https://pan.baidu.com/s/1abcdef",
"password": "1234",
"datetime": "2023-06-10T14:23:45Z",
"work_title": "速度与激情全集1-10"
}
],
"tags": ["电影", "合集"],
"images": [
"https://cdn1.cdn-telegram.org/file/xxx.jpg"
]
},
// 更多结果...
],
"merged_by_type": {
"baidu": [
{
"url": "https://pan.baidu.com/s/1abcdef",
"password": "1234",
"note": "速度与激情全集1-10",
"datetime": "2023-06-10T14:23:45Z",
"source": "tg:频道名称",
"images": [
"https://cdn1.cdn-telegram.org/file/xxx.jpg"
]
},
// 更多百度网盘链接...
],
"quark": [
{
"url": "https://pan.quark.cn/s/xxxx",
"password": "",
"note": "凡人修仙传",
"datetime": "2023-06-10T15:30:22Z",
"source": "plugin:插件名",
"images": []
}
],
"aliyun": [
// 阿里云盘链接...
]
// 更多网盘类型...
}
}
字段说明：
SearchResult对象：
message_id: 消息IDunique_id: 全局唯一标识符channel: 来源频道名称datetime: 消息发布时间title: 消息标题content: 消息内容links: 网盘链接数组tags: 标签数组（可选）images: TG消息中的图片链接数组（可选）Link对象：
type: 网盘类型（baidu、quark、aliyun等）url: 网盘链接地址password: 提取码/密码datetime: 链接更新时间（可选）work_title: 作品标题（可选）
MergedLink对象：
url: 网盘链接地址password: 提取码/密码note: 资源说明/标题datetime: 链接更新时间source: 数据来源标识
tg:频道名称: 来自Telegram频道plugin:插件名: 来自指定插件unknown: 未知来源images: TG消息中的图片链接数组（可选）
错误响应：
// 参数错误
{
"code": 400,
"message": "关键词不能为空"
}
// 未授权（启用认证但未提供Token）
{
"error": "未授权：缺少认证令牌",
"code": "AUTH_TOKEN_MISSING"
}
// Token无效或过期
{
"error": "未授权：令牌无效或已过期",
"code": "AUTH_TOKEN_INVALID"
}
检测指定网盘分享链接当前是否有效，适合前端结果页按需做可见项检测，也支持批量调试和服务端缓存复用。
接口地址：/api/check/links
请求方法：POST
Content-Type：application/json
是否需要认证：取决于AUTH_ENABLED配置
请求参数：
代理行为说明：
proxy_url/proxy 只影响当前 /api/check/links 请求，不会修改服务进程的全局代理配置。proxy_url/proxy 时，检测服务沿用启动时的全局HTTP客户端配置。400，不会静默降级为直连。请求示例：
# 未启用认证
curl -X POST http://localhost:8888/api/check/links \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"disk_type": "quark",
"url": "https://pan.quark.cn/s/abcdefg",
"password": "1234"
},
{
"disk_type": "xunlei",
"url": "https://pan.xunlei.com/s/abcdefg?pwd=1234"
},
{
"disk_type": "115",
"url": "https://115cdn.com/s/abcdefg?password=1234"
}
],
"view_token": "quark-1710000000000"
}'
# 指定本次检测使用代理，避免固定出口IP频繁触发风控
curl -X POST http://localhost:8888/api/check/links \
-H "Content-Type: application/json" \
-d '{
"items": [
{
"disk_type": "quark",
"url": "https://pan.quark.cn/s/abcdefg"
}
],
"proxy_url": "socks5://127.0.0.1:1080"
}'
# 启用认证时
curl -X POST http://localhost:8888/api/check/links \
-H "Content-Type: application/json" \
-H "Authorization: Bearer eyJhbGc..." \
-d '{
"items": [
{
"disk_type": "baidu",
"url": "https://pan.baidu.com/s/1abcdef?pwd=1234"
}
]
}'
成功响应：
{
"results": [
{
"disk_type": "quark",
"url": "https://pan.quark.cn/s/abcdefg",
"normalized_url": "https://pan.quark.cn/s/abcdefg?pwd=1234",
"state": "ok",
"cache_hit": false,
"checked_at": 1710000000000,
"expires_at": 1710086400000,
"summary": "链接有效"
},
{
"disk_type": "xunlei",
"url": "https://pan.xunlei.com/s/abcdefg?pwd=1234",
"normalized_url": "https://pan.xunlei.com/s/abcdefg?pwd=1234",
"state": "bad",
"cache_hit": true,
"checked_at": 1710000100000,
"expires_at": 1710021700000,
"summary": "链接失效"
}
]
}
状态说明：
ok：链接有效bad：链接失效locked：需要提取码或密码错误unsupported：当前平台暂不支持检测uncertain：检测失败或结果不确定字段说明：
results: 检测结果数组results[].disk_type: 网盘类型results[].url: 原始传入链接results[].normalized_url: 规范化后的链接results[].state: 检测状态results[].cache_hit: 是否命中服务端检测缓存results[].checked_at: 最近一次检测时间戳（毫秒）results[].expires_at: 当前缓存过期时间戳（毫秒）results[].summary: 状态说明文本错误响应：
// 请求参数无效
{
"code": 400,
"message": "无效的检测请求: Key: 'CheckRequest.Items' Error:Field validation for 'Items' failed on the 'required' tag"
}
// items 为空
{
"code": 400,
"message": "items不能为空"
}
// 代理参数无效
{
"code": 400,
"message": "无效的代理参数: 不支持的代理协议: ftp"
}
// 未授权（启用认证但未提供Token）
{
"error": "未授权：缺少认证令牌",
"code": "AUTH_TOKEN_MISSING"
}
检查API服务是否正常运行。
接口地址：/api/health
请求方法：GET
是否需要认证：否（公开接口）
请求示例：
curl http://localhost:8888/api/health
成功响应：
{
"status": "ok",
"auth_enabled": true,
"plugins_enabled": true,
"plugin_count": 16,
"plugins": [
"pansearch",
"panta",
"qupansou",
"hunhepan",
"jikepan",
"pan666",
"panyq",
"susu",
"xuexizhinan",
"hdr4k",
"labi",
"shandian",
"duoduo",
"muou",
"wanou",
"ouge",
"zhizhen",
"huban"
],
"channels_count": 1,
"channels": [
"tgsearchers3"
]
}
字段说明：
status: 服务状态，"ok"表示正常auth_enabled: 是否启用认证功能plugins_enabled: 是否启用插件plugin_count: 已启用的插件数量plugins: 已启用的插件列表channels_count: 配置的频道数量channels: 配置的频道列表本项目采用 MIT 许可证。详情请见 LICENSE 文件。
