---

name: google-drive description: "Export, download, upload, and share Google Drive and Docs files. Use when a file must be fetched from or published to Drive（Google Drive・Google Docs・共有リンク）." allowed-tools:

• Read
• Bash(python *)
• Bash(uv *)

---

Google Drive アクセス

概要

Google Drive / Google Docs のファイルを CLI 環境から操作する。 認証は ndf:google-auth スキルの共通モジュール (get_credentials()) を使用。

提供物

google-drive/
├── SKILL.md                  ← このファイル
├── pyproject.toml            ← uv プロジェクト (Drive API 依存)
└── scripts/
    └── gdrive_fetch.py       ← CLI: エクスポート / ダウンロード / アップロード

gdrive_fetch.py は実行時に ndf:google-auth スキルの google_auth.py を sys.path に追加して get_credentials() を呼ぶ。google-auth 側で OAuth2 トークンを取得済みであれば追加の認証は不要。

前提条件

| 項目 | 値 | |---|---| | 認証 | ndf:google-auth スキル (共通 OAuth2 モジュール) | | Python 実行 | uv run --project ${CLAUDE_SKILL_DIR} python ... または uv run --with ... | | client_secret.json | ndf:google-auth の手順で配置済み | | 既存トークン | ~/.config/gcloud/google_token.json (ndf:google-auth で取得済み) |

クイックスタート

SKILL_DIR=${CLAUDE_SKILL_DIR}
SCRIPT=$SKILL_DIR/scripts/gdrive_fetch.py

# Google Doc をテキストでエクスポート
uv run --project $SKILL_DIR python $SCRIPT --id FILE_ID

# HTML 形式
uv run --project $SKILL_DIR python $SCRIPT --id FILE_ID --mime text/html -o /tmp/doc.html

# PDF 形式
uv run --project $SKILL_DIR python $SCRIPT --id FILE_ID --mime application/pdf -o /tmp/doc.pdf

# バイナリファイル (画像、PDF 等) をダウンロード
uv run --project $SKILL_DIR python $SCRIPT --id FILE_ID --download -o /tmp/file.png

# ファイルをアップロード (公開共有リンク付与)
uv run --project $SKILL_DIR python $SCRIPT --upload /path/to/file.png

--port N を渡すとローカルサーバ方式の OAuth で再認証 (初回かつスコープ追加時のみ必要)。

Google Doc ID の取得

URL から ID を抽出する:

https://docs.google.com/document/d/【ここが Doc ID】/edit

例: https://docs.google.com/document/d/1vwDAZJLlLjtjFFITB23qTF8ldWBgRZg8MPUO4kUt-Ys/edit → ID: 1vwDAZJLlLjtjFFITB23qTF8ldWBgRZg8MPUO4kUt-Ys

エクスポート形式 (--mime)

| mimeType | 形式 | |---|---| | text/plain | プレーンテキスト | | text/html | HTML | | application/pdf | PDF | | application/vnd.openxmlformats-officedocument.wordprocessingml.document | DOCX |

Sheets は text/csv / application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (xlsx) も対応。 Slides は application/pdf / application/vnd.openxmlformats-officedocument.presentationml.presentation (pptx)。

トラブルシューティング

403 Insufficient scopes

スコープ不足の場合は ndf:google-auth で必要なスコープ付きで再認証:

python ${CLAUDE_SKILLS_DIR:-${CLAUDE_PROJECT_DIR}/.claude/skills}/google-auth/scripts/google_auth.py --clear
! python ${CLAUDE_SKILLS_DIR:-${CLAUDE_PROJECT_DIR}/.claude/skills}/google-auth/scripts/google_auth.py drive.file

404 File not found

サービスアカウントにはユーザのファイルへのアクセス権がない。本スキルは ユーザの OAuth 認証 (ndf:google-auth 経由) を使う前提。

GOOGLE_APPLICATION_CREDENTIALS の干渉

GOOGLE_APPLICATION_CREDENTIALS="" uv run --project $SKILL_DIR python $SCRIPT --id FILE_ID

gcloud CLI での認証 (非推奨)

gcloud CLI の OAuth はインタラクティブ入力の制約で多くのエージェント環境で動かない。 本スキルの依存である ndf:google-auth を使うこと。