baidu-netdisk-skill

百度网盘 Skill（Baidu Netdisk Skill）

AI エージェント向けクラウドデータコネクター | AI エージェント向けクラウドデータコネクター —— ローカルに保存せずに百度网盘のファイルにアクセス

セキュリティ状況：✅ 自己監査済み | 🔒 Token を暗号化して保存 | 🌐 百度の公式 API のみを呼び出し

概要

百度网盘 Skill は、OpenClaw 専用に設計されたコマンドラインツールで、ファイルの一覧表示、検索、ダウンロード、アップロードなどの主要機能に対応しています。

主なメリット：

• 🔐 OAuth によるワンクリック認証 - 1 分で完了し、百度 API の申請は不要です（推奨）
• ☁️ クラウド上で完結し、データを保存しない - ストリーミングで読み込むため、ローカルディスクの容量を使いません
• 🗂️ 深い階層のフォルダーを走査 - 4 階層以上のディレクトリに対応しています
• 🔒 Token を暗号化して保存 - ローカルで安全に保存します
• 🔧 柔軟な認証 - 独自の API key の使用にも対応しています（利用量の多いユーザー向け）

インストール

npx skills install github:niukesi/baidu-netdisk-skill

認証（初回使用時）

方法 1：OAuth によるワンクリック認証 ⭐ 推奨

ほとんどのユーザーに適しています。百度 API の申請は不要です。

npx baidu-netdisk-auth

画面の指示に従って操作してください：

1. 認証 URL を開きます
2. 百度アカウントにログインします
3. アプリケーションを認証します
4. 認証コードをコピーして、ターミナルに貼り付けます

方法 2：独自の API key を使用 🔧 上級者向け

利用量の多いユーザーや技術に詳しいユーザーに適しています。自身の百度 API クォータを使用します。

npx baidu-netdisk-skill config -k <apikey> -s <secret> -t <token>

API key の取得手順：

1. 百度オープンプラットフォームにアクセスします
2. アプリケーションを作成し、API Key と Secret Key を取得します
3. 画面の指示に従って認証を完了し、Access Token を取得します

使用例

ユーザー情報を確認

npx baidu-netdisk-skill whoami

ファイルを一覧表示

# 根目录
npx baidu-netdisk-skill list /

# 指定目录（支持深层文件夹）
npx baidu-netdisk-skill list "/教程/第一层/第二层"

ファイルを検索

npx baidu-netdisk-skill search "关键词"

ダウンロードリンクを取得

npx baidu-netdisk-skill download <fs_id>

ファイルをアップロード

npx baidu-netdisk-skill upload ./本地文件.pdf /备份/

設定項目

設定項目	説明	必須
apiKey	百度 API Key（独自の API key を使用するモードで使用）	いいえ
secretKey	百度 Secret Key（独自の API key を使用するモードで使用）	いいえ
accessToken	Access Token（OAuth 認証後に自動保存）	いいえ
refreshToken	Refresh Token（OAuth 認証後に自動保存）	いいえ
encryptionKey	カスタム暗号化キー（任意。セキュリティを強化）	いいえ

セキュリティに関する説明

• ✅ Token をローカルで暗号化して保存（AES-256）
• ✅ 百度の公式 API のみを呼び出します
• ✅ ソースコードはオープンソースで監査可能です
• ✅ データを収集しません

注意：削除操作は取り消せません。慎重にご使用ください。

よくある質問

Q: 認証後に認証情報が無効と表示されます。 A: 認証コードの有効期間は短いため、5 分以内に認証を完了してください。期限切れの場合は、npx baidu-netdisk-auth を再実行してください。

Q: ファイルの一覧表示時に権限不足と表示されます。 A: OAuth 認証が正しく完了していることを確認するか、BDUSS/STOKEN が有効か確認してください。

Q: 大容量ファイルのアップロードに対応していますか？ A: 対応しています。ただし、大容量ファイルのアップロードには時間がかかるため、ネットワークが安定した環境での使用をおすすめします。

詳細ドキュメント

• GitHub リポジトリ
• README 全文

---

Miaozai Studio が ❤️ を込めて制作