google-ai-mode-skill

Google AI Mode Skill

Google の AI Search モードにクエリを送信して、ウェブ全体から包括的で情報源に基づいた回答を取得します。

このスキルを使用するタイミング

次の場合に、このスキルを使用します。

• ナレッジカットオフ（2025年1月以降）を超える最新情報を求められた場合
• ライブラリやフレームワークのドキュメントまたは API リファレンスが必要な場合
• コーディング例や実装パターンを求められた場合
• 技術的な比較やベストプラクティスを知りたい場合
• 引用や情報源を伴う調査が必要な場合
• 「Google AI search」「Google AI mode」「web research」に言及した場合

CLI フラグ

基本的なフラグ

--debug - 詳細なログを有効にします

python scripts/run.py search.py --query "..." --debug

• 詳細なログを logs/search_YYYY-MM-DD_HH-MM-SS.log に保存します
• ブラウザーの起動、CAPTCHA の検出、AI コンテンツの待機、引用の抽出など、すべての手順を記録します
• CAPTCHA の問題や検索失敗のトラブルシューティングに不可欠です
• 完了時にログファイルのパスが表示されます

--save - 結果をスキルフォルダーに保存します

python scripts/run.py search.py --query "..." --save

• Markdown を results/YYYY-MM-DD_HH-MM-SS_Query_Name.md に保存します
• 整理しやすいように、タイムスタンプ付きのファイル名を使用します
• 今後参照できるよう、結果をスキルディレクトリに保存します
• 自動でファイル名を付ける場合は、--output の代わりに使用します

組み合わせて使用（デバッグに推奨）：

python scripts/run.py search.py --query "..." --debug --save

その他のフラグ

--show-browser - CAPTCHA を解決するためにブラウザーウィンドウを表示します

python scripts/run.py search.py --query "..." --show-browser

--output <path> - 出力ファイルのパスを指定します

python scripts/run.py search.py --query "..." --output result.md

--json - 出力に JSON メタデータを含めます

python scripts/run.py search.py --query "..." --output result.md --json

クエリ最適化戦略

重要：実行前に、必ずユーザーのクエリを最適化してください。Google AI Mode の品質は、クエリの精度に左右されます。

最適化テンプレート

[Technology/Topic] [Version] [Year] ([Specific Aspect 1], [Aspect 2], [Aspect 3]). [Output format request].

最適化ルール

1. 最新の結果を得るため、現在の年（2026年）を含めます
2. 必要な項目を列挙するには、括弧を使用します
3. 構造化された出力（表、比較、分類別リスト）を求めます
4. ライブラリやフレームワークについてのクエリには、バージョン番号を含めます

例

ユーザーのクエリ	最適化したクエリ
"React hooks"	"React hooks best practices 2026 (useState, useEffect, custom hooks, common pitfalls). Provide code examples."
"What's new in Rust?"	"Rust 1.75 new features 2026 (async traits, impl Trait improvements, const generics, stabilized APIs). Include migration guide and code examples."
"PostgreSQL vs MySQL performance?"	"PostgreSQL vs MySQL performance comparison 2026 (query optimization, indexing strategies, concurrent writes, JSON handling, scaling patterns). Provide benchmark data and use case recommendations."
"How to handle errors in Go?"	"Go error handling patterns 2026 (error wrapping, custom errors, sentinel errors, panic vs error, testing error cases). Provide code examples and best practices comparison."
"Learn FastAPI basics"	"FastAPI tutorial 2026 (routing, dependency injection, async endpoints, request validation with Pydantic, OpenAPI documentation, testing). Include step-by-step implementation guide."

注：ユーザーがすでにバージョン番号や要件を含む詳細なクエリを提示している場合は、そのまま使用します。

ワークフロー

1. ユーザーのリクエストを受け取ります
2. 上記のテンプレートを使用してクエリを最適化します
3. ユーザーに「次の内容を検索しています：『[最適化したクエリ]』」と伝えます
4. --save --debug フラグを指定して検索を実行します
5. インライン引用 [1][2][3] を付けて結果を返します

スクリプトの実行

重要：必ず run.py ラッパーを使用してください。スクリプトを直接実行すると失敗します。

基本的な検索

python scripts/run.py search.py --query "Your search query"

推奨される使い方

python scripts/run.py search.py --query "..." --save --debug

run.py ラッパーは、次の処理を自動で行います。

• 初回実行時に .venv を作成します
• 依存関係（patchright、beautifulsoup4、html-to-markdown）をインストールします
• 仮想環境を有効にします
• 検索スクリプトを実行します
• 検出回避のため、Chromium ではなく Google Chrome をインストールします

仕組み

1. 永続的なブラウザーコンテキスト：保存されたブラウザープロファイル ~/.cache/google-ai-mode-skill/chrome_profile を使用し、検索の間も Cookie／セッションを保持します
2. CAPTCHA の回避：永続的なコンテキストにより Google がブラウザーを認識するため、CAPTCHA が表示されることはほとんどありません
3. AI コンテンツの検出：ページに Google AI Overview が表示されるまで待機します
4. 引用の抽出：JavaScript を挿入し、AI の回答からソースリンクを抽出します
5. Markdown への変換：HTML をインライン引用 [1][2][3] 付きの Markdown に変換します
6. 高速な結果：通常、検索は 5～7 秒で完了します（CAPTCHA なし）

CAPTCHA への対応

永続的なコンテキストを使用すると、CAPTCHA が表示されることはほとんどありません。 表示された場合：

1. 検出：複数のレイヤーでチェックします（URL /sorry/index、ページのテキスト、コンテンツの長さ）
2. 自動対応：ヘッドレスモードで CAPTCHA が検出されると、スクリプトは CAPTCHA_REQUIRED エラーを返します
3. 手動での解決：--show-browser フラグを付けて再実行し、ブラウザーで CAPTCHA を解決すると、スクリプトが自動的に処理を続行します

注：CAPTCHA を一度解決すると、永続的なコンテキストによりセッションが保持されるため、以降の検索では CAPTCHA が不要になります。

出力形式

インライン引用とソースリストを含む Markdown を返します。例：

React 18 introduces concurrent features including Suspense for data fetching[1],
automatic batching for state updates[2], and transitions for non-urgent updates[3].

---

## Sources:

[1] React 18 Release Notes
https://react.dev/blog/2022/03/29/react-v18

[2] Automatic Batching Explained
https://github.com/reactwg/react-18/discussions/21

[3] Transitions API Documentation
https://react.dev/reference/react/useTransition

一般的な使用例

ライブラリのドキュメントを探す

python scripts/run.py search.py --query "Prisma ORM 2026 (schema definition, migrations, client API, relation queries, transactions). Include TypeScript examples." --save --debug

コーディング例を入手する

python scripts/run.py search.py --query "WebSocket implementation Node.js 2026 (server setup, client connection, message handling, authentication, reconnection logic). Production-ready code examples." --save

技術的な比較

python scripts/run.py search.py --query "GraphQL vs REST API 2026 (performance, caching, tooling, type safety, learning curve). Comparison table with use case recommendations." --save

ベストプラクティスを調査する

python scripts/run.py search.py --query "Microservices security patterns 2026 (API gateway authentication, service mesh, mutual TLS, secret management, observability). Architecture diagrams and implementation guide." --save --debug

トラブルシューティング

問題	解決策
ModuleNotFoundError	run.py ラッパーを使用してください。スクリプトを直接実行しないでください
毎回 CAPTCHA が表示される	初回設定時に --show-browser を付けて一度 CAPTCHA を解決してください。以降は永続的なコンテキストによりセッションが保持されます
AI overview が見つからない	最適化テンプレートを使用し、より具体的なクエリに言い換えてください
ブラウザーが起動しない	インターネット接続と Chrome のインストールを確認してください
詳細なログが必要	--debug フラグを使用してください。ログは logs/ フォルダーに保存されます
AI Mode を利用できない	お使いの地域／国では Google AI Mode がサポートされていません。対応地域（米国、英国、ドイツなど）からアクセスするには、プロキシ／VPN を使用してください

終了コード：

• 0 - 成功
• 1 - 一般的なエラー
• 2 - CAPTCHA が必要です（--show-browser を付けて再試行）
• 3 - ユーザーがブラウザーを閉じました
• 4 - この地域では AI Mode を利用できません（プロキシ／VPN を使用）
• 130 - ユーザーが中断しました（Ctrl+C）

ベストプラクティス

1. クエリは必ず最適化してください - 具体性が結果の品質を左右します
2. 重要な検索には --save --debug を使用してください - 結果が保存され、監査証跡も得られます
3. ライブラリ／フレームワークに関するクエリにはバージョン番号を含めてください
4. 構造化された出力を依頼してください - 表や比較により使いやすさが向上します
5. CAPTCHA は一度だけ解決してください - 永続的なコンテキストにより、以降の CAPTCHA は不要になります
6. 引用を確認してください - 提供されたソースの正確性を確認してください