connector-baidu-netdisk

---
name: connector-baidu-netdisk
description: "百度网盘文件管理与智能检索。支持浏览、关键词和语义搜索、文件整理、分享链接、容量查询，以及保存文本内容或通过 URL 转存文件。触发关键词：百度网盘、网盘、baidu、netdisk、云盘、文件分享。"
description_zh: "百度网盘文件管理与智能检索。支持浏览、关键词和语义搜索、文件整理、分享链接、容量查询，以及保存文本内容或通过 URL 转存文件。触发关键词：百度网盘、网盘、云盘、文件分享。"
description_en: "Baidu Netdisk file management and intelligent search. Supports browsing, keyword and semantic search, file organization, share links, storage usage queries, saving text content, and transferring files from URLs. Trigger keywords: baidu, netdisk, cloud drive, file sharing."
version: "1.2.0"
---

# 百度网盘

通过百度网盘 MCP 浏览、检索和管理用户的云端文件。当前能力包括目录与分类浏览、关键词与语义检索、文件元信息和容量查询、文件整理、创建分享链接，以及保存文本内容或通过 URL 转存文件。

## 能力边界

当前连接器支持：

- 浏览指定目录下的全部文件，或按文档、图片、视频分类查看。
- 按文件名关键词搜索。
- 使用自然语言进行语义检索，并可按目录、文件类型、扩展名和结果数量筛选。
- 在文件名、图片 OCR 文字、文档正文中搜索关键词。
- 对图片以及文档、视频、音频内容进行语义检索。
- 查询文件元信息、用户基本信息和网盘空间使用情况。
- 新建文件夹，复制、移动和重命名文件。
- 为一个或多个文件创建带有效期和提取码的分享链接。
- 将文本内容保存为网盘文件，单次文本不超过 2 万字。
- 通过可直接下载的 URL 将文件转存到网盘。

当前工具集中未提供：

- 将网盘文件或文件夹下载到本地。
- 直接上传用户设备上的任意本地文件。
- 删除网盘文件或文件夹。
- 将分享链接直接发送给某个联系人；连接器只能创建分享链接，由用户自行发送。

不要把“文本内容保存”或“URL 转存”描述为完整的本地文件上传能力，也不要承诺下载或删除操作。

## 调用原则

- 涉及百度网盘时，优先使用本连接器提供的 MCP 工具，不要用本地文件系统命令代替网盘操作。
- 目标文件、目录或路径不明确时，先浏览或搜索，再执行后续操作。
- 执行新建、复制、移动、重命名、上传、转存或创建分享链接等写操作前，确认目标对象、目标目录、文件名及冲突处理方式。
- 移动、重命名和覆盖可能改变用户现有文件结构；未获得明确授权时，不使用覆盖策略。
- 用户只要求查找或查看时，保持只读，不顺带执行整理、分享或上传操作。
- 工具要求绝对路径时使用以 `/` 开头的网盘路径；路径含中文时，按工具参数说明进行 URL 编码。
- 搜索结果可能较多时使用分页或限制返回数量，并向用户说明结果范围。

## 工具选择

### 浏览与查询

- 查看目录内容：使用通用文件列表。
- 只查看文档、图片或视频：使用对应的分类列表。
- 查询文件详情：先从列表或搜索结果取得文件 ID，再查询元信息；单次最多查询 10 个文件 ID。
- 查询网盘容量：使用空间配额查询。
- 查询账号基础信息：使用用户信息查询。

### 搜索

- 用户给出明确文件名关键词时，优先使用文件名关键词搜索。
- 用户使用自然语言描述内容、主题、场景、时间或地点时，优先使用语义检索。
- 用户要求搜索图片中的文字时，选择图片 OCR 搜索来源。
- 用户要求搜索文档正文时，选择文档内容搜索来源。
- 用户要求按画面、音视频内容或文档含义搜索时，选择对应的语义向量搜索来源。
- 用户指定文件类型或后缀时，同时设置分类或扩展名过滤条件，减少无关结果。

### 文件管理

- 新建文件夹前确认完整目标路径；同名冲突时，除非用户另有要求，优先采用自动重命名而非覆盖。
- 复制、移动和重命名时，先确认源文件绝对路径、目标目录和目标名称。
- 遇到同名文件时，向用户说明可选策略：失败、生成副本名、覆盖或跳过。默认优先选择生成副本名，避免覆盖已有文件。

### 分享

- 创建分享链接前确认待分享文件、有效期、4 位提取码和备注。
- 提取码只能由数字和小写字母组成，长度为 4 位。
- 创建成功后向用户返回分享链接、有效期和提取码，但不要声称已发送给任何联系人。

### 保存内容与 URL 转存

- 用户要求把一段文字、会议纪要或生成内容保存到网盘时，使用文本内容上传；单次内容不超过 2 万字。
- 用户未指定目录时，工具默认保存到 `/来自：mcp_server`；执行前应告知用户默认位置，或询问其期望目录。
- 用户未指定文件名时，工具可能默认保存为 DOCX；为减少歧义，优先确认文件名和扩展名。
- 用户提供可直接下载的文件链接并要求保存到网盘时，使用 URL 转存。
- URL 不是直接下载地址、需要登录或访问受限时，不保证转存成功，应向用户说明限制。
- 不要尝试用文本上传接口读取或上传任意本地二进制文件。

## 使用示例

- 查看我百度网盘根目录下的文件，并告诉我还剩多少可用空间。
- 列出「项目资料」文件夹里的所有文档。
- 从文件名、文档正文和图片文字中搜索与「项目合同」相关的文件。
- 找出网盘里与海边日落相关的图片和视频。
- 搜索最近整理的 AIGC 研究资料，只返回 PDF 和 DOCX 文件。
- 新建一个「AIGC 调研资料」文件夹，把相关文件复制进去。
- 把「旧项目/周报.docx」移动到「归档/2026」，遇到同名文件时跳过。
- 将「最终方案-v3.docx」重命名为「最终方案.docx」。
- 为「周报.docx」创建一个有效期 7 天、带 4 位提取码的分享链接。
- 把这段会议纪要以「产品会议纪要.docx」保存到百度网盘的「会议记录」文件夹。
- 把这个可下载链接中的文件转存到百度网盘的「参考资料」文件夹。

## 错误处理

- 认证失败：当返回 HTTP 401/403、Access Token 无效或过期等错误时，提示用户在连接器管理中重新连接百度网盘；如需重新获取凭据，可参考百度网盘开放平台文档：<https://pan.baidu.com/union/doc/Wm9sl0i0j>。
- 路径错误：确认路径以 `/` 开头，并按工具要求对包含中文的路径进行 URL 编码。
- 文件不存在：先重新浏览父目录或搜索文件名，避免基于猜测继续执行。
- 同名冲突：不要擅自覆盖，向用户说明冲突并确认使用生成副本名、覆盖、跳过或失败策略。
- 分享失败：检查文件 ID、有效期和提取码格式；文件 ID 列表必须符合工具要求的严格 JSON 字符串格式。
- 转存失败：检查 URL 是否可公开访问并可直接下载；若链接需要登录、验证码或临时授权，告知用户当前接口可能无法转存。
- 语义检索无结果：尝试缩短描述、调整搜索来源、取消过窄的文件类型限制，或退回文件名关键词搜索。

## 安全说明

- Access Token 由连接器管理，通过 MCP 连接参数传递。
- 禁止在对话、日志或输出文件中展示完整的 Access Token。
- 未经用户明确确认，不覆盖已有文件，不移动或重命名重要文件，不创建公开分享链接。
- 分享链接、提取码和文件路径可能包含敏感信息，只向当前用户展示，不主动传播给第三方。