【結論】APIキーを環境変数で管理し、検索と統計取得を分ける
Claude CodeはYouTube Data API v3を使うプログラムを作成できますが、API仕様を常に記憶していると断定せず、Googleの公式仕様とレスポンスを確認しながら実装させる必要があります。
検索結果には再生回数が直接含まれないため、検索でvideoIdを取得した後にvideos.list相当の処理でstatisticsを取得します。
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install google-api-python-client python-dotenv
printf ".env
.venv/
*.csv
" >> .gitignore
printf "YOUTUBE_API_KEY=replace_me
" > .env
claude具体的な手順・設定方法
-
Google Cloud側でYouTube Data API v3を有効化し、必要最小限の制限を付けたAPIキーを用意します。
公開リポジトリへキーをコミットしないでください。
-
検索APIで候補のvideoIdを取得し、動画詳細APIで再生回数を補完する二段階処理にします。
ページネーションとquota消費を考慮し、最大件数を設定します。
実践プロンプト / 活用テクニック
「再生回数順の検索結果」はsearch.listのorder=viewCountだけに依存せず、取得後の統計値を数値で再ソートすると検証しやすくなります。
Googleの公式YouTube Data API v3仕様を前提に、Pythonツールを作成してください。
.envのYOUTUBE_API_KEYを読み込み、「AI エージェント」で動画を検索してください。
最大50件のvideoIdを取得後、動画詳細からstatisticsを取得し、再生回数の数値降順で上位10件をyoutube_results.csvへ保存してください。
APIキーをログへ出さず、quotaExceeded、403、欠損statisticsを処理してください。
実行前に必要なAPIメソッドと想定quotaを説明してください。注意点・よくあるエラーと対処法
-
APIキーをechoコマンドで作る例はシェル履歴に秘密情報が残る場合があります。
実値はエディタや秘密管理機能で設定し、画面共有やログ出力に注意してください。
-
検索APIはquota消費が比較的大きく、無限ループや頻繁な再実行に向きません。
件数、ページ数、再試行回数へ上限を設定してください。