Communitygithub.com

gemini-web-mcp

Gemini Web MCP スキルサーバーを操作するためのスキルです。ツールマニフェストの検査、安全なGemini Webツールの選択、チャット履歴とネイティブノートブックの管理、Pro Web機能のカバレッジ検証、メディア成果物の生成と検証、ドキュメント/テスト/評価の更新を行います。

gemini-web-mcp とは?

このスキルは、Gemini Web MCPサーバーと低トークンスキルサーバーを操作するための包括的なガイドを提供します。開発者は、まず `gemini_get_tool_manifest` を使用して現在有効なツールセットを確認し、静的なマニフェストに依存せず動的にツールを選択できます。チャット履歴の管理では、メタデータのスキャン、検索、読み取り、エクスポート、ノートブックへの移動を安全な順序で実行でき、削除操作には明示的なユーザー確認が必要です。メディア生成では、Lyria 3 Pro による音楽生成や画像生成をサポートし、生成されたメディアファイルの検証機能も備えています。また、ブラウザCookieプロファイルを利用したスケジュールアクションの作成・削除や、`gemini_probe_web_features` によるPro Web機能のリーチャビリティチェックなど、高度なアカウント管理機能を提供します。このスキルは主にClaude CodeやCodexなどのAIエージェント向けに設計されており、プライベートデータや破壊的操作を伴うツールは明示的なユーザー意図がある場合のみ使用するよう注意を促します。

対応~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/Luckycat133/gemini-web-mcp/tree/main/.agents/skills/gemini-web-mcp

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Gemini Web MCP

このリポジトリの Gemini Web MCP サーバーおよび低トークンスキルサーバーには、このスキルを使用してください。

最初に

  1. プライマリーサーバーのツールを選択する前に、gemini_get_tool_manifest を優先して使用してください。このツールは GEMINI_TOOLS=core や GEMINI_TOOLS=prompts の場合でも、常に src.server によって公開されています。
  2. マニフェストの current_enabled、groups、workflows を確認してください。静的なマニフェストには現在のプロセスでロードされていないグループが含まれる可能性があるため、ツール数をハードコードしないでください。
  3. 低トークンサーバーでは、Gemini を初期化するアカウント呼び出しの前に、認証不要の account(action="manifest") と account(action="capabilities") を優先してください。
  4. 読み取り専用の探索を最初に行ってください: gemini_doctor、マニフェスト/機能、gemini_probe_web_features、メタデータのみの履歴検索、プロファイル診断、インベントリ/リストツール。
  5. privacy=reads_private_chat_text およびその他のプライベートテキストツールは、明示的なユーザー意図ツールとして扱ってください: gemini_read_chat、gemini_export_chat、gemini_search_chats(scan_turns=true)、およびチャットテキストを読み取るリサーチレポート作成アクション。
  6. 破壊的ツールは明示的なユーザー意図が必要です: gemini_delete_chat、gemini_cleanup_test_artifacts(dry_run=false)、gemini_delete_scheduled_action、gemini_reset_session、gemini_manage_gems(action="delete")、プロンプト削除。

ツールサーフェス

  • プライマリー MCP サーバー: src.server
    • エージェントが Gemini モデルを呼び出すだけでよい場合は、GEMINI_TOOLS=model または chat を使用します。
    • エージェントがチャット履歴のリスト/スキャン/検索/読み取り/エクスポートのために gemini_history のみを必要とする場合は、GEMINI_TOOLS=history を使用します。
    • エージェントが gemini_history、gemini_notebooks、および明示的なチャットからノートブックへの移動を必要とする場合は、GEMINI_TOOLS=history-organize を使用します。
    • エージェントが読み取り専用の Web サーフェスインベントリのために gemini_account_inventory のみを必要とする場合は、GEMINI_TOOLS=account-read を使用します。
    • 明示的に承認されたスケジュールアクションの作成/削除ワークフローにのみ、GEMINI_TOOLS=scheduled-admin を使用します。
    • デフォルトの GEMINI_TOOLS=core は、チャット、メディア、ファイル、リサーチを含む幅広いコンテンツワークフローとして残ります。
    • GEMINI_TOOLS=all は完全なメンテナンス/検証サーフェスであり、一般的なエージェントのデフォルトとしては適していません。
    • GEMINI_TOOLS=prompts は、ローカルプロンプト管理と常時オンのマニフェスト/Cookie ヘルパーを追加します。
  • 低トークンスキルサーバー: src.skill_server
    • コンパクトなツールガイダンスには account(action="manifest") を使用します。
    • Cookie なしの静的な Web 機能マップには account(action="capabilities") を使用します。
    • コンパクトなアカウントサーフェスインベントリには account(action="features|links|usage|library|notebooks|scheduled|modes") を使用します。
    • チャット履歴には history(action="list|search|read|export|delete") を使用します。
    • マーカーによるテストチャットまたはスケジュールアクションを削除する前に、cleanup(dry_run=true) を使用します。
    • コンパクトなスケジュールアクションワークフローには scheduled(action="list|get|create|delete") を使用します。
    • Lyria 3 Pro ミュージックリクエストには create(type="music", model="pro") またはプライマリーの gemini_generate_music を使用します。
    • ライブアカウントワークフローの前の低コストなローカル事前チェックには doctor(validate_browser=false) を使用します。
    • Chrome に複数のサインインプロファイルがある場合は、cookie(action="profiles") の後に cookie(action="get", profile="...") を使用します。

チャット履歴ワークフロー

  1. 完全性が重要な場合は、メタデータソースを詳細にスキャンします:
    • gemini_history(action="scan", limit=..., offset=..., response_format="json")
  2. 最初にメタデータをリストまたは検索します:
    • gemini_history(action="list", limit=..., offset=..., response_format="json")
    • gemini_history(action="search", query=..., scan_turns=false, response_format="json")
  3. ユーザーがコンテンツ検索を要求した場合にのみ、ターンテキストをスキャンします:
    • gemini_history(action="search", query=..., scan_turns=true, turns_per_chat=..., max_chars_per_turn=...)
  4. ユーザーがターゲットを示した後にのみ、選択した1つのチャットを読み取り/エクスポートします:
    • gemini_history(action="read", chat_id=...)
    • gemini_history(action="export", chat_id=..., response_format="markdown"|"json")
  5. ターゲットのチャットとノートブックの両方を特定した後にのみ、チャットをネイティブノートブックに移動します:
    • gemini_notebooks(action="list", ...)
    • gemini_move_chat_to_notebook(chat_id=..., notebook_id=...)
    • gemini_notebooks(action="chats", notebook_id=...)
  6. 明示的な確認がある場合にのみ削除します:
    • gemini_delete_chat(chat_id=...)

Web Pro カバレッジルール

  • gemini_get_web_capabilities は静的な観測された Pro Web サーフェスマップです。
  • gemini_probe_web_features は観測された読み取り専用の RPC 到達可能性をチェックし、生のプライベート RPC ボディを公開してはなりません。
  • 読み取り専用のアカウントインベントリ(公開リンク、使用制限、ネイティブノートブック、ライブラリ機能、スケジュールアクション、ツールモードステータス)には gemini_account_inventory(surface=...) またはマニフェストの web_surface_inventory ワークフローを使用します。
  • gemini_list_library_capabilities は、プライベートライブラリアセットのエクスポートではなく、ローカライズされたテンプレート/機能発見として扱います。
  • gemini_get_tool_mode_status は読み取り専用の Canvas/Guided Learning モードステータスプローブとして扱います。Canvas ドキュメントの変更は無効のままです。
  • Guided Learning はチャットの learning_mode を通じて公開されます。UI の前提よりこれを優先します。
  • Drive ピッカー、Canvas 変更、設定変更、メモリインポート変更、公開リンク変更、およびサポートされていないスケジュールアクションの繰り返し/編集/切り替えバリアントは、安定した RPC 契約と明示的なユーザー承認が存在するまで無効のままにします。

メディアワークフロー

  • 音楽/ビデオ/画像生成リクエストには MCP ツールパスを使用し、ツールが保存されたローカルメディアファイルまたは明示的なエクスポート失敗を報告した場合にのみ完了します。
  • Lyria 3 Pro/フルソングの主張については、生のバックエンドマーカーと保存されたメディア期間を検証します。ラッパーラベル、モデル名、またはチャットの散文だけを信頼しないでください。
  • gemini_generate_music は、response.media が空の場合でも、生のチャットペイロードからメディアを回復できます。成功を要約する前に、返されたファイルパスと期間メタデータを検査します。

スケジュールアクション

  • gemini_create_scheduled_action、gemini_list_scheduled_actions、gemini_get_scheduled_action、gemini_delete_scheduled_action を通じて、観測された毎日の作成、レジストリリスト、ID による取得、ID による明示的な削除を使用します。
  • アカウントコンテキストが重要な場合は、最初に Chrome Cookie を更新します。レジストリが予期せず空の場合は、gemini_list_browser_cookie_profiles を呼び出し、次に Gemini Cookie またはスケジュールレジストリエントリを持つプロファイルに対して gemini_get_cookie_from_browser(profile="...") を呼び出します。
  • 作成/削除後は verification_status を確認します。作成後は readable_by_id_after_create も確認し、削除後は deleted_by_id_after_delete または task_state_after_delete=deleted を確認してから、タスクが存在しないと主張します。

検証

変更を完了する前に、以下を実行してください:

./.venv/bin/pytest -q
./.venv/bin/python -m py_compile src/tools/annotations.py src/tools/chat.py src/tools/media.py src/tools/file.py src/tools/research.py src/tools/prompts.py src/tools/manage.py src/server.py src/skill_server.py src/client_wrapper.py src/thinking_client.py src/constants.py
git diff --check

マニフェストまたは機能メタデータを変更する場合は、以下も検証してください:

GEMINI_TOOLS=core ./.venv/bin/python - <<'PY'
import asyncio
from src.server import mcp
async def main():
    tools = await mcp.list_tools()
    print(len(tools), [t.name for t in tools if t.annotations is None])
asyncio.run(main())
PY

スキルのみの変更の場合は、少なくともローカルプロジェクトコピーと公開リポジトリのスキルコピーの両方に対してスキルバリデータを実行してください:

for path in .codex/skills/gemini-web-mcp .agents/skills/gemini-web-mcp; do
  ./.venv/bin/python /Users/jack/.codex/skills/.system/skill-creator/scripts/quick_validate.py "$path"
done

evaluations/gemini_web_mcp_contract.xml を gemini_get_tool_manifest および gemini_get_web_capabilities と整合させてください。

関連スキル