Genspark CLI（gsk）完全ガイド v1.3.0 — npmの全バージョン履歴から再構成した進化史とMesh解説

2026年7月22日

はじめに — なぜ3ヶ月前の自分の記事を全部やり直したか

3ヶ月前に書いたGenspark CLIの解説記事を見直したら、実在しないコマンド名とモデルIDが混じっていた。gsk doc、flux/schnell、--output-format json – どれも現行の公式READMEには存在しない。AIが生成した二次情報を鵜呑みにして、一次資料と照合していなかった。

そのため、全部やり直した。本記事は @genspark/cli v1.3.0（2026-07-17公開） 時点の正確な全貌と、初回公開（v1.0.1・2026-03-02）から4.5ヶ月でどう成長してきたかを、npm公式レジストリの全バージョン履歴（v1.3.0までの32バージョン）の一次データで裏付ける。Mesh（デバイス間セキュアSSH）・Claude Code連携・従量課金の実際まで、上司説明資料としても使える1冊にまとめた。

Genspark CLI（gsk）とは

Genspark CLIは、AI検索・生成プラットフォーム Genspark の公式コマンドラインツール。コマンド名は gsk。web検索、画像／動画／音声生成（40以上のモデル）、文書解析、メール・カレンダー・GitHub・Slack・Notion連携、AI電話発信、株価、SNSデータ取得、そしてデバイス間セキュアSSH（Mesh）まで、90以上のAIツールを単一バイナリに統合し、クリーンなJSON出力で呼び出せる。

公式READMEのキャッチコピーは一言に集約される。

“One CLI. Every AI capability.” Search, generate, analyze, communicate — all from your terminal.

対象読者

Genspark契約者で、Web UIだけでなくターミナルからAI機能を呼びたい人
Claude Code / Gemini CLI等のコーディングエージェントに、画像・動画・音声生成や検索機能を「サブエージェント」として組み込みたい人
AIツールのバージョン管理・リリースサイクルに関心のあるエンジニア

出自 — 「社内ツール」から公開npmパッケージへ

意外と知られていない事実として、gskは最初から一般公開を前提としたツールではなかった。npmレジストリに残る最初期バージョン（v1.0.1）のREADMEには次のように記されている。

“Pre-installed in the Genspark Desktop sandbox container.”

デフォルトの接続先も http://host.containers.internal:3000 というコンテナ内部向けアドレスだった。つまりgskは元々、Genspark Desktop（現在の「Genspark Claw」に連なるネイティブAIエージェント製品）が内部的に呼び出すツール群として作られ、後から独立した公開npmパッケージへ切り出された。この転換点は後述の進化史で扱う。

パッケージ基本情報

項目	内容
npmパッケージ名	`@genspark/cli`
バイナリ名	`gsk`（`genspark` も併用可）
ライセンス	MIT
必要環境	Node.js >= 18
主要依存	`commander`（CLIパーサ）、`ws`（WebSocket・Mesh用）
初回公開日	2026-03-02
本記事の解説対象	v1.3.0（2026-07-17）
記事公開時点の最新版	v1.4.0（2026-07-20） ※README差分は未検証

価値の3点

契約・キー管理の単純化: 1つのGensparkアカウント・1つのAPIキーで、画像16モデル・動画14モデル・音声14モデルにアクセスできる
JSON統一インターフェース: 各社バラバラのレスポンス形式を個別に学ばずに済む（stdout=JSON、stderr=進捗ログという規約が全コマンド共通）
AIエージェントとの親和性: Claude Code・Gemini・OpenCode等から「ツールの1つ」として自然に呼べる（gsk init-skills gsk init-opencode 等の専用コマンドあり）

第1章: インストール・認証・検索・生成系

インストールとクイックスタート

npm install -g @genspark/cli
gsk --version
gsk --help

gsk login

gsk search "latest AI news"

gsk img "A beautiful sunset over mountains" -o ./sunset.png

gsk crawl "https://example.com/article"

CLIは4時間ごとに新バージョンをチェックしバックグラウンドで自動更新する。CI環境や再現性が重要な場面では GSK_NO_AUTO_UPDATE=1 で無効化を推奨する（筆者環境でも本記事執筆中に v1.4.0 のバックグラウンドインストール通知が出た）。

認証と設定

方式	コマンド/設定	用途
ブラウザログイン	`gsk login`	個人利用・対話的作業
環境変数	`export GSK_API_KEY="gsk_..."`	CI/CD・サーバ・他AIエージェントから
CLIオプション	`--api-key "gsk_..."`	スクリプト内で一時利用

gsk login はブラウザを開いてGensparkアカウント認証を行い、APIキーを ~/.genspark-tool-cli/config.json に保存する。現在のログイン状態確認は gsk login-info（エイリアス gsk me）。設定の優先順位は CLIオプション > 環境変数 > 設定ファイル。

検索・クロール・分析コマンド

gsk search "latest AI news"                              # Web検索
gsk crawl "https://example.com/article"                  # 本文抽出
gsk summarize "https://example.com/report.pdf" --question "What are the key findings?"
gsk img-search "modern architecture"                    # 画像検索
gsk analyze "Describe this image" -i "https://example.com/image.jpg"  # 画像分析
gsk media-analyze -i "https://example.com/video.mp4" -r "Summarize the video"
gsk transcribe -i ./meeting.wav -m "whisper-large-v3"     # 音声文字起こし

生成系コマンド（画像・動画・音声）

gsk img "A beautiful sunset over mountains" -r "16:9" -s 2k -o ./sunset.png
gsk img "A portrait in similar style" -i ./reference.png

gsk video "A cat playing with yarn" -m "kling/v1.6/standard" -d 5 -o ./cat.mp4

gsk audio "Hello, welcome to Genspark!" -m "google/gemini-2.5-pro-preview-tts" -o ./hello.mp3
gsk audio "A pop song" -m "fal-ai/minimax/speech-2.6-hd" -l "Verse 1: ..." -d 120

v1.3.0時点の代表モデル（公式README原文ベース）:

画像16種: nano-banana-2（Gemini 3.1 Flash Image）、fal-ai/gpt-image-1.5、imagen4、recraft-v3、fal-ai/flux-2 / flux-2-pro、ideogram/V_3、qwen-image 他
動画14種: kling/v3（最新・音声付き）、gemini/veo3.1、minimax/hailuo-2.3/standard、wan/v2.6、sora-2 / sora-2-pro、xai/grok-imagine-video 他
音声14種: google/gemini-2.5-pro-preview-tts、fal-ai/minimax/speech-2.6-hd、ElevenLabs、MiniMax、Mureka 他

ベストプラクティス: モデルは -m で明示的に指定する。デフォルトモデルは将来変わりうるため、再現性を確保するにはモデル名を固定すること。また公式仕様として “The prompt should be in English” と明記されている点にも留意。

第2章: Claude Code / 他AIエージェントとの連携

gskは「他のAIコーディングエージェントから呼び出されること」を強く意識した設計で、専用の初期化コマンドが用意されている。

gsk init-opencode --model claude-sonnet-4-6

gsk init-skills --agent claude   # .claude/ 向け設定も同時生成
gsk init-skills --agent all      # Claude・Gemini両対応

サブエージェント化の3パターン

画像生成専門エージェント: .claude/agents/genspark-img.md で「画像生成が必要なときに使う」と定義し、gsk img を自動実行させる
ファクトチェック自動化: .claude/hooks/ に原稿保存後フックを仕込み、gsk task cross_check を自動発火させる
オーケストレーター型: 単一の genspark.md サブエージェントが状況判断し、検索・画像生成・ファクトチェック等を適切に選択実行する

クロードコードがgskを補完する理由

Claude Codeは「コードを書く・直す」領域では非常に強力だが、画像・動画生成のようなマルチモーダル生成は単体では対応できない。gskをサブエージェント化すれば、Claude Codeのセッション内で「猫の画像を作って」と依頼すると内部で gsk img が呼ばれ高品質な画像が返る。JSON-first設計のため、生成結果を後続処理（記事への埋め込み・Slack通知等）に機械的に連結しやすい。

実測パフォーマンス（2026-04-29時点計測）

コマンド	所要時間	出力
`gsk login-info`	1秒未満	小さなJSON
`gsk search`	約5秒	検索結果配列
`gsk crawl`	約12秒	本文約37KB
`gsk task cross_check`	91秒	根拠・引用付きファクトチェック
`gsk img`（nano-banana-2）	26〜34秒	PNG 387〜555KB

cross_check は約90秒かかる重量級コマンドであり、単純な検索の代替として気軽に使うべきではない。

内部モデルに関する注意

2026-05時点の第三者調査によれば、gsk task slides は内部的に Claude Sonnet 4.5（Legacy・claude-sonnet-4-5-20250929） を実行していることが確認されている。つまり「Claude Code から gsk task slides を呼ぶ」運用は、実質的にClaudeの中でClaudeが動く入れ子構造になり、各層でAPI課金が発生する点に注意が必要である。これはGenspark公式の発表ではなく第三者の観察である点に留意されたい。

第3章: Mesh — デバイス間セキュアSSH

v1.3.0時点で最も注目すべき新機能が gsk mesh である。同じGensparkアカウントにログインした全デバイスにプライベートなE2E暗号化ネットワーク（Tailscaleベースの”tailnet”）とSSHを提供する。パブリックIPもポート開放も不要で、各デバイスに 100.64.x.x の固定アドレスが割り当てられる。

gsk の認証をそのまま流用するため、gsk login 済みなら追加ログイン不要。実体はGensparkのCDNから初回取得されるネイティブバイナリ gsk-mesh（約45MB・sha256検証済み・macOSはApple公証・WindowsはDigiCert署名）で、gsk mesh はその薄いラッパーとして動作する。

コマンド一覧（実機helpで確認）

コマンド	内容
`gsk mesh join`	このデバイスをmeshに登録（tailscaled DL・デーモン起動・pre-auth key発行・tailnet IP付与）
`gsk mesh leave`	meshから離脱（サーバ側logout後、デーモンSIGTERM・pidfile削除）
`gsk mesh serve`	着信SSHを受け付ける（内蔵SSHサーバ・OSのsshd不要）
`gsk mesh ssh <[user@]node>`	他デバイスへSSH接続（OpenSSHの機能がそのまま使える）
`gsk mesh scp <src...> <dst>`	ファイルコピー
`gsk mesh sftp <node>`	対話的SFTP
`gsk mesh forward -L <spec> <node>`	ポートフォワード
`gsk mesh devices`	tailnet上のデバイス一覧
`gsk mesh status`	meshブローカ（headscale）の健全性確認
`gsk mesh revoke <node-id>`	デバイスの権限失効
`gsk mesh upgrade`	ネイティブバイナリの更新

筆者の実機検証結果（2026-07-21）

本記事の執筆にあたり、読み取り系2コマンドを実機実行した。

$ gsk mesh devices
[]

$ gsk mesh status
{
  "feature_enabled": true,
  "headscale_error": null,
  "healthy": true,
  "login_server": "https://mesh-control.genspark.ai",
  "serve_pid": null,
  "serve_port": null,
  "serving_incoming": false
}

devices が空配列（まだjoinしていない）、status は healthy: true で headscale 到達性も確認できた。なお status の login_server は https://mesh-control.genspark.ai である。join 以下の常駐系コマンド（serve/ssh/scp/sftp/forward）は tailscaled のダウンロードとデーモン常駐・デバイス登録を伴うため、本記事時点では未実施とした（leave で逆操作可能だが常駐デーモンが残る）。ssh はシステムの ssh を SOCKS5 プロキシ経由で呼び出す設計で、agent forwarding・identity files・~/.ssh/config・PTY 等の OpenSSH 機能がそのまま使える。

典型的な使い方

gsk login && gsk mesh join --name workstation && gsk mesh serve

gsk login && gsk mesh join --name laptop
gsk mesh ssh workstation -- 'uname -a && uptime'
gsk mesh forward -L 8080:localhost:80 workstation

Windows固有の注意: gsk-mesh の自動更新チェックはWindowsではスキップされる（実行中の .exe を上書きできない制約のため）。Windowsでは gsk mesh upgrade を手動実行する必要がある。

第4章: サービス連携・電話・株価・SNS

外部サービス連携は「サービスレベルツール」として提供される。各サービスは1コマンド＋actionパラメータで複数操作にディスパッチする設計。事前に Genspark Account Settings → Integrations で連携設定が必要。

gsk gmail search --query "from:boss subject:report"
gsk gmail send --to user@example.com --subject "Hello" --body "<p>Hi!</p>"
gsk google_calendar create --summary "Team Sync" --start_time "..." --end_time "..."
gsk github search_issues --q "repo:owner/repo is:open label:bug"
gsk github create_issue --owner myorg --repo myrepo --title "Bug report" --body "..."
gsk slack send --recipient "#general" --message "Hello team!"
gsk notion search --query "project roadmap"
gsk microsoft_teams list_teams

対応サービス: gmail / outlook_email / google_calendar / outlook_calendar / meeting / google_drive / google_sheets / google_docs / google_contacts / github / slack / notion / microsoft_teams / onedrive / sharepoint / outlook_contacts。

電話・株価・SNS

gsk phone-call "Pizza Hut" -c "+1-555-123-4567" -p "Check if they deliver to my area" --dry-run   # v1.3.0まで
gsk telephony call "Pizza Hut" -c "+1-555-123-4567" -p "Check if they deliver to my area" --dry-run  # v1.4.0以降

gsk stock AAPL

gsk social twitter search_posts -q "artificial intelligence" --start_date 2026-03-01 --language en
gsk social instagram get_posts_by_user -q "natgeo" --start_date 2026-03-01
gsk social reddit search_posts -q "rust programming" --sort top --time week -s "programming"

第5章: リリース後の進化 — v1.0.1からv1.3.0まで全記録

本章が本記事の中核である。npm公式レジストリ（registry.npmjs.org/@genspark/cli）から取得したv1.3.0までの全32バージョンのメタデータと、5つの主要バージョンのREADME原文を直接比較して再構成した（2026-07-21に再取得して検証済み）。

Genspark CLI（gsk）リリース後の機能進化タイムライン — v1.0.1からv1.3.0まで137日間・32バージョン

図: gskの進化タイムライン。赤が重要マイルストーン（一般公開への転換・Mesh機能ローンチ・初のマイナーアップ）、青がフェーズ、灰色が約4週間の開発空白期間。

全体データ

項目	値
初回公開	2026-03-02（v1.0.1）
本記事の詳細解説対象	v1.3.0（2026-07-17）
v1.3.0までの公開バージョン数	32
ファイル数の推移（v1.0.1→v1.3.0）	30 → 138（約4.6倍）
展開後サイズの推移（同上）	108,862 → 778,785 bytes（約7.2倍）
期間（v1.0.1→v1.3.0）	137日間
※記事公開時点の最新	v1.4.0（2026-07-20 20:11 UTC公開・全33バージョン）

⚠️ 鮮度に関する重要な注記（2026-07-21 追記）
本記事の詳細解説は v1.3.0 を対象としているが、執筆確認中の2026-07-21にnpmレジストリを再取得したところ、v1.4.0が2026-07-20 20:11 UTCに公開済み（dist-tags.latest = 1.4.0）であることを確認した。そこで v1.3.0 と v1.4.0 の tarball を両方ダウンロードしてREADMEをdiffしたところ、電話コマンドに破壊的変更があったことが判明した（詳細は次節「フェーズ8」）。
これ自体が本記事の主題そのものでもある——gskは4時間ごとに自動更新をかけ、記事を書いている最中にもバージョンが進む。だからこそ「今の仕様」は必ず gsk --help と npm レジストリで確認する必要がある。

フェーズ1: サンドボックス内蔵ツール期（v1.0.1〜v1.0.5／03-02〜03-09）

初回公開時点のgskは「Genspark Desktopのサンドボックスコンテナに事前インストール済み」のツールという位置づけで、外部公開を前提としたオンボーディング文書は存在しなかった。ただしこの時点で、検索・クロール・要約・画像検索・画像分析・画像/動画/音声生成・アップロード/ダウンロード・メディア分析・文字起こし・AI Drive・タスク実行・株価取得という基本機能セットの大半は最初から揃っていた。逆に、ログイン系・メール・カレンダー・電話・SNS連携・Mesh機能は影も形もなかった。

フェーズ2: 一般公開への転換（v1.0.6／2026-03-11）— 最大の分水嶺

初回公開からわずか9日後の2026-03-11、v1.0.6で決定的な方向転換が起きた。README冒頭の説明文が淡々とした機能列挙から “One CLI. Every AI capability.” という現行キャッチコピーに刷新され、以下が一挙に追加された。

gsk login / login-info（me）によるブラウザ認証フロー — デフォルト接続先も内部コンテナ用アドレスから https://www.genspark.ai に変更
Capability Map・Quick Start・Authentication という一般ユーザー向けオンボーディング構成の新設
email・calendar・AI Phone Calls（call）・Social Media の各セクション新規追加
キーワード数が 6個から20個へ3倍以上
パッケージ説明文が「30+ AI tools」を掲げ始める

ファイル数こそv1.0.1と同じ30のままだが、展開後サイズは108,862 bytesから161,340 bytesへ約1.5倍に増えており、v1.0.6で「看板」を掲げた時点で既存ファイルへの実装が一気に厚くなったことが読み取れる。この2026-03-11こそが、gskが「内部ツール」から「プラットフォーム」へ変質した日と言える。

フェーズ3: エコシステム整備期（v1.0.9〜v1.0.19／03-12〜05-29）

月1〜2回程度のペースで着実にバージョンを重ねる巡航期。この期間に init-skills コマンド、「Service-Level Tools」という統一的なサービス連携の枠組み、電話コマンドのエイリアス整理（call → phone-call/call-for-me）、READMEへの「Available Models」セクション統合が段階的に実装された。Claude Code等のAIエージェントからの利用を見据えた地ならしの時期だったと解釈できる。

フェーズ4: Mesh機能の誕生（v1.0.20→v1.0.21／2026-06-02）

2026-06-02、同日に3回連続でパッチが公開されるという異例の集中リリースが発生した。この切り替わりで次の変化が同時に起きた。

ws（WebSocketクライアント）ライブラリが依存関係に新規追加 — 直前のv1.0.19までは commander のみで、v1.0.20から ws が加わる（レジストリAPIで確認）
READMEに「Mesh — Secure SSH Between Your Devices」セクションが完全新規で出現
ファイル数がv1.0.20の89からv1.0.21の106へ急増

すなわちMesh（デバイス間秘匿ネットワーク＋SSH機能）がこの日にローンチされたことを意味する。

フェーズ5: 安定運用期とMeshの成熟（v1.0.22〜v1.0.29／06-02〜07-11）

Mesh公開直後の同日にv1.0.22が続き、その後v1.0.23（06-04）を最後に約4週間の空白（06-04〜07-02）が生じた。調査対象期間中最も長い開発休止期間で、Meshの安定化・社内検証に充てられた可能性がある。7月に入るとv1.0.24（07-02）からv1.0.29（07-11）までほぼ週1〜2回のハイペースなパッチが続いた。

フェーズ6: 初のマイナーバージョンアップ（v1.1.0／2026-07-14）

初回公開から4.5ヶ月間ずっと1.0.x系だったgskが、2026-07-14公開のv1.1.0で初めてマイナーバージョンが上がった。

share_project（share-project）コマンドの新規追加 — Gensparkプロジェクトを公開ビューアリンクとして共有
Meshドキュメントの大幅拡充 — 簡易な3セクション構成から、フルのコマンドリファレンス表・5ステップの番号付きワークフロー・エンドツーエンドの実例を備えた現行の詳細な構成へ刷新

Meshは公開から約6週間の実運用フィードバックを経て、「実験的機能」から「本格サポート機能」へ格上げされたタイミングと考えられる。

フェーズ7: 直近3日間の急ピッチリリース（v1.1.1→v1.2.0→v1.3.0／07-15〜07-17）

調査時点（2026-07-21）から見てわずか3〜5日前、v1.1.1（07-15）、v1.2.0（07-17）、v1.3.0（07-17・同日2回目のマイナーアップ）という急ピッチリリースが続いた。興味深いことにv1.1.0とv1.3.0のREADME.mdは1バイトも違わず完全に同一（diffで検証済み）。つまりこの3リリースはユーザー向けドキュメントに表れない内部実装の改善・依存関係更新・不具合修正が主体だったと推測される。ドキュメントに表れない変更を憶測で機能追加と決めつけるのは危険であり、本記事では「未確認」として明記する。

フェーズ8: v1.4.0 — 電話コマンドの破壊的リネーム（2026-07-20）

本記事の最終確認中（2026-07-21）にv1.4.0の公開を確認したため、v1.3.0とv1.4.0のtarballを両方取得してREADMEをdiffした。結果、差分は23行あり、その全てが電話機能まわりの再編だった。

セクション名の変更: AI Phone Calls → Telephony

コマンドのリネーム（破壊的変更）:

gsk phone-call "Pizza Hut" -c "+1-555-123-4567" -p "Check if they deliver to my area"

gsk telephony call "Pizza Hut" -c "+1-555-123-4567" -p "Check if they deliver to my area"

READMEには “The pre-migration forms (gsk phone-call …, gsk sms) still work as hidden deprecated aliases.” と明記されており、旧形式は「隠し非推奨エイリアス」として当面は動作する。ただしドキュメントからは消えたため、新規に書くスクリプトは gsk telephony call を使うべきである。

サブコマンドの新設: 単発の発信コマンドから、通話を管理する体系へ拡張された。

サブコマンド	内容
`gsk telephony call`	発信（デフォルトサブコマンド）
`gsk telephony call status`	通話状態の確認
`gsk telephony call hangup`	通話の終了
`gsk telephony call log`	通話ログ
`gsk telephony call detail`	通話詳細
`gsk telephony sms send`	SMS送信（新機能）

オプションの変更:

--is_place_id フラグが削除された。v1.4.0では -c に渡した値の形（電話番号／calllog: contact_ref／Google Maps place_id）から自動判別する
--async オプションが新規追加。発信開始直後に制御を返し、status でポーリング・hangup で停止できる

つまりv1.4.0は「内部改善のみ」ではなく、電話機能を単発コマンドから非同期・状態管理付きのサブシステムへ格上げしたリリースだった。第13.8節でv1.1.1〜v1.3.0を「READMEに差分がないため内部改善と推測」と書いたが、v1.4.0はその推測が常に成り立つわけではないことを示している。READMEのdiffを取ることでしか、この破壊的変更は検知できなかった。

進化の要約年表

日付	バージョン	できごと
2026-03-02	v1.0.1	npm初回公開。サンドボックス内蔵ツールとして誕生
2026-03-11	v1.0.6	一般公開への転換。ログイン・Capability Map・email/calendar/phone/social追加
04中〜5月	v1.0.12〜1.0.19	`init-skills`・Service-Level Tools整備
2026-06-02	v1.0.20→1.0.21	Mesh機能ローンチ（`ws`依存追加・SSH/tailnet公開）
2026-06-04〜07-02	—	開発の最長空白期間（約4週間）
2026-07-14	v1.1.0	初のマイナーアップ。`share-project`追加・Mesh本格拡充
2026-07-17	v1.2.0 / v1.3.0	同日2回のマイナーアップ（ドキュメント変化なし・内部改善と推測）
2026-07-20	v1.4.0	電話コマンドの破壊的リネーム（`phone-call` → `telephony call`）。SMS送信・`--async`・通話状態管理サブコマンドを新設
2026-07-21	—	本記事の一次データ再取得日

進化から読み取れる開発思想

gskは「社内ツールとして機能検証 → 一般公開してユーザー基盤を作る → サービス連携を横展開 → インフラ機能（Mesh）で差別化 → 共有・コラボ機能を追加」という順序で拡張されてきた。特に「一般公開」(v1.0.6)と「Mesh公開」(v1.0.20→21)は、いずれも単一バージョンの中で複数の変更が同時に発生する「まとめてローンチ」型であり、小さな機能を継続的に足していくのではなく、まとまった単位で機能を仕上げてから公開するスタイルがうかがえる。

第6章: 料金体系とクレジット消費

プラン体系（2026年7月時点 ※2026-07時点のプロモーション含む・期間終了後は変更の可能性）

プラン	月額	クレジット	ストレージ
Free	$0	100〜200 / 日	1GB
Plus	$24.99（年払いで$19.99/月）	10,000 / 月	50GB
Pro	$249.99	125,000 / 月	1TB
Enterprise	個別見積り	—	ゼロデータ保持・データ隔離・SSO対応

未使用の月次クレジットは繰り越されない。追加クレジットパックは $20 / 10,000クレジットから。※2026年12月31日まで、有料プランではチャット・AI画像生成が0クレジット（無制限扱い）のプロモーションが実施されている（※2026-07時点・期間終了後は変更の可能性）。

CLIコマンドのクレジット消費目安

重要: アプリ内（Web UI）でのチャット・画像生成は無制限枠だが、CLI/API経由の操作は従量課金である。この違いを認識せずにCLIで大量生成を回すと、想定外にクレジットを消費する。

操作	消費クレジットの目安
Web検索（`gsk search`）	1
通常クロール（`gsk crawl`）	0
JS描画クロール	増加（要件次第）
画像生成（CLI/API経由）	約44 / 枚
動画生成（9秒程度）	約1,344

動画生成の消費は画像生成の30倍以上に達するため、バッチ処理でループさせる前に必ずコスト試算を行うべきである。

プラン選定の目安

利用パターン	推奨プラン
個人検証・週数回の画像生成	Free〜Plus
毎日の検索パイプライン運用＋月数十枚の画像生成	Plus
動画生成を含む業務利用・チーム運用	Pro以上

筆者環境は Plus プラン・クレジット残高 10,000（2026-07-21時点・gsk login-info で確認）。

第7章: ベストプラクティスとアンチパターン

推奨事項

モデルを明示的に指定する（-m nano-banana-2 等）— デフォルトモデルは将来変わりうるため再現性を確保する
プロンプトは英語で書く — 公式仕様で “The prompt should be in English” と明記
JSON-first設計を活かす — jq で必要な部分だけを抽出し後続処理につなげる
大きな出力はファイル保存する — -o / --output-file を活用し標準出力を汚さない
APIキーは環境変数で管理する — コード直書きを避け GSK_API_KEY を使う
動画生成のような高コスト操作はループ実行前に件数・費用を試算する

アンチパターン

❌ 古いモデル名（例: flux/dev）を検証せずにコピペする — モデルIDは頻繁に変わる（本記事冒頭の失敗の通り）
❌ CI環境で自動更新を放置する — 再現性が崩れる（GSK_NO_AUTO_UPDATE=1 を必ず設定）
❌ あらゆる作業をgskに集約する — コーディングはClaude Code等、生成・外部情報取得はgsk、という役割分担を意識する
❌ cross_check（ファクトチェック）を通常の検索代わりに使う — 91秒程度かかる重量級コマンド
❌ APIキーをGitHubにコミットする
❌ cross_check の検証範囲を過信する — ローカルCLIのヘルプ内容など、Web上に存在しない情報までは検証できない

CI/CDでの利用例

- name: Use Genspark CLI
  env:
    GSK_API_KEY: ${{ secrets.GSK_API_KEY }}
    GSK_NO_AUTO_UPDATE: "1"
  run: gsk search "release notes"

第8章: トラブルシューティングと「AI二次情報の検証方法」

よくある問題

症状	原因	対処
`gsk: command not found`	npmグローバルbinのPATH未設定	`npm config get prefix` の `bin/` をPATHに追加
ログインできない	Googleアカウント連携時に誤ってメール+パスワード欄で認証しようとしている	「Googleでログイン」ボタンから認証する
`share-project` が見当たらない	ゲートキーパー制御により一部アカウントにのみ表示	対応プランか確認する
生成画像のURLが開けない	AI Driveの `get_readable_url` はGenspark未ログインのブラウザでは弾かれる場合がある	Gensparkログイン済みブラウザで開くか、明示的な共有設定を使う
CIで自動更新により挙動が変わる	4時間ごとのバックグラウンド更新	`GSK_NO_AUTO_UPDATE=1` を設定
Windowsで `gsk mesh` の自動更新が効かない	実行中`.exe`の上書き制約	`gsk mesh upgrade` を手動実行
クレジットが想定より早く尽きる	CLI/API経由は従量課金（アプリ内無制限枠と別会計）	料金表を参照し重い操作を絞る

「AIが生成した二次情報」をどう検証すべきか

本記事冒頭で触れた通り、3ヶ月前の自分の記事に実仕様と乖離した記載が含まれていた。これは特定の失敗を非難するためではなく、AI生成コンテンツを一次資料として扱う際の一般的な注意点として記録する価値がある。

一次資料（npm公式README・レジストリメタデータ）と二次資料（ブログ・SNSの解説記事）は必ず区別する
コマンド名・フラグ名など再現性が求められる情報は、実際に gsk <command> --help を叩くか、npmパッケージのソースを直接確認するまで確定情報として扱わない
「ベンチマークスコア」「ARR」「ユーザー数」のような定量的な企業実績の数字は、公式発表元へのリンクが明示されていない限り注意深く扱う

本記事のコマンド仕様はすべて、npmレジストリから取得した v1.3.0 の README.md 原文（42,034文字）と、筆者の実機検証（gsk mesh --help / devices / status）を直接参照している。

まとめ — 次にgskについて書く・調べる際の3原則

Genspark CLI（gsk）は、2026年3月に「デスクトップサンドボックスの内蔵ツール」として誕生し、わずか9日後には一般公開向けプラットフォームへと姿を変えた。その後4.5ヶ月かけてMesh機能・サービス連携・共有機能を積み重ねながら成長してきた経緯がある。この進化の速度は、AIツールの解説記事があっという間に陳腐化することの裏返しでもある。3ヶ月前に書いた自分の記事が古くなっていた事実は、その典型例だった。

次にgskについて調べる・書く際に意識すべき点は以下の3つである。

npmレジストリのようなAPIから一次データを直接取得し、憶測を混ぜない
「今の仕様」と「過去の記事に書かれた仕様」を区別して扱う
公式チェンジログが存在しないツールでは、バージョン間のREADME差分そのものを一次資料として扱う

gskのような急成長中のツールを追いかける上で、これは汎用的に使える調査手法でもある。本記事がv1.3.0時点の正確なスナップショットと、その進化史の両方を残せていれば幸いである。次回はMeshの常駐系コマンド（join/serve/ssh）を実機検証した編で深掘りする予定である。