前言¶

在对话里让 Agent「帮找某部剧的网盘」时，常见做法是打开浏览器逐个站点搜，或把关键词丢给通用搜索——结果杂、链接格式不统一，还要自己分辨平台。若希望 Agent 直接按影视名调用盘搜（PanSou）接口、按网盘类型整理链接与提取码，SkillHub 社区技能 盘搜影视资源查询（包标识 @indiv-mrbank/mrbank-pansou，内部名 pansou-search）把检索逻辑写进 SKILL.md，并附带 scripts/search.py 对接 PanSou 的 /api/search。下面介绍其定位、能力与安装用法；事实来自 SkillHub 公开 API（2026-10-22 查询）及技能包 1.1.8 版内容。

这是什么¶

盘搜影视资源查询 是面向「找影视、要网盘链接」场景的 Agent Skill，由 SkillHub 用户 MRBANK（handle：user_82a39fde）发布，归类为 knowledge-management，子类为信息检索。技能通过 PanSou（盘搜）搜索引擎请求镜像上的搜索 API（主地址为 https://so.252035.xyz），返回百度网盘、阿里云盘、夸克网盘、迅雷网盘、UC 网盘、移动云盘、115 网盘、磁力链接等类型的分享链接；用户说「找电影」「搜片」「网盘搜索」等即应触发，不必口头提到「盘搜」或「PanSou」。SkillHub 标注 requires_api_key: false，当前版本 1.1.8。

核心功能¶

关键词检索与网盘筛选¶

支持按关键词搜索电影、电视剧、动漫、纪录片等；可用 --cloud_types 限定网盘类型（如 quark,aliyun），用 --include / --exclude 做结果过滤，用 --src 选择数据来源（all、tg、plugin）。

多镜像竞速与兜底¶

脚本对多个镜像并行请求：优先使用 https://so.252035.xyz；若用户侧接口无有效命中，再回退公共镜像（https://so.qlf.net.cn、https://pan.andwitcom.com、http://bbs.52jscn.com）。任一镜像先返回 total>0 的有效结果即结束等待，单镜像超时或失败会自动切换，无需手工改地址。

冷关键词轮询¶

从未被检索过的冷门词可能触发服务端实时建缓存（约 30～90 秒）。脚本默认每 8 秒轮询一次、总预算 90 秒（--max_wait / --poll_interval 可调），拿到结果即返回；预算用尽仍为 0 条时，可重跑同一关键词以读取已写入的缓存。

结构化输出¶

默认每种网盘类型最多展示 10 条（--limit 可调）。--json 时返回含 keyword、total、分类型 results、source_mirror、elapsed 等字段的 JSON，便于 Agent 按类型分组展示链接、提取码、备注与来源。

安装与启用¶

1. 在 SkillHub 打开技能官方页并完成安装（客户端以 SkillHub 指引为准）：
   - https://api.skillhub.cn/user_82a39fde/mrbank-pansou
   - https://skillhub.cn/skills/mrbank-pansou
2. 安装后技能目录内应包含 SKILL.md 与 scripts/search.py；在支持 Agent Skills 的客户端中启用该技能，使 Agent 能读取 SKILL.md 并按其中流程调用脚本。
3. 执行搜索需要本机 Python 3；search.py 使用标准库发起 HTTPS 请求，无需额外 pip 依赖（脚本对部分镜像会放宽 SSL 证书校验以兼容证书链不完整的服务）。

SkillHub 公开统计（查询日）：下载约 3033 次；腾讯 Keen、三步安全扫描均为「安全，无风险」。Cursor、Codex CLI、Claude Code 的具体安装菜单位置因客户端版本而异，以各端 SkillHub 集成说明为准；本文不臆造统一 CLI 安装命令。

典型用法¶

在技能根目录下调用搜索脚本（路径以你本机安装目录为准，下文用技能根目录表示）：

基本搜索：

python3 scripts/search.py --kw "星际穿越"

限定网盘并过滤画质、排除预告：

python3 scripts/search.py \
  --kw "流浪地球" \
  --cloud_types quark,aliyun \
  --include "4K" \
  --exclude "预告,CAM" \
  --limit 5

仅插件源、强制刷新缓存：

python3 scripts/search.py --kw "三体" --src plugin
python3 scripts/search.py --kw "庆余年" --refresh

Agent 侧典型流程（与 SKILL.md 一致）：解析用户片名与平台偏好 → 带上筛选参数执行脚本（建议 --json）→ 按网盘类型分组展示链接与提取码；无结果时可换英文名、年份或缩写后重试。

适用场景与注意¶

适合：希望在 Cursor 等 Agent 环境里用自然语言找影视网盘链接、并需要夸克/阿里/百度等多平台结果归类的用户。

注意：

• 结果来自互联网公开索引，技能与 PanSou 均声明仅供学习参考；链接可能失效，宜优先选择 datetime 较新的条目。
• 磁力、电驴链接需自备合规的 BT 客户端；部分资源含提取码，展示时需一并给出。
• 公共镜像与第三方盘搜服务可用性、响应时延不在技能作者控制范围内；冷门词首次搜索可能需等待轮询预算。
• 与海搜（HaiSou）类技能定位相近，官方 SKILL.md 未写强制互斥；需要更广覆盖时可由用户自行组合多个检索技能。

结尾¶

盘搜影视资源查询 把 PanSou 的多镜像检索与脚本参数封装成 Agent 可执行的 Skill，减少手工搜盘与复制链接的步骤。安装与更新以 SkillHub 为准：https://api.skillhub.cn/user_82a39fde/mrbank-pansou。