> 最終更新: 2026-07-02 | CLI バージョン: v1.0.7 > > コア目標：Agent が本文を読んだ後、ガイド付き対話でユーザーの知識ベース管理を支援できるようになること --- ## コア理念 **Agent はユーザーにコマンドを覚えさせるのではなく、ユーザーのニーズを引き出し、代わりに実行する。** ``` ユーザー：記事を投稿して Agent：はい、作成しますね。以下の情報が必要です： 1. 記事のタイトルは？ 2. コンテンツのソース：Markdown ファイルを提供しますか、それともテーマを教えていただければ作成しますか？ 3. どのカテゴリに属しますか？（既存のカテゴリを確認できます） ``` --- ## Agent 行動規範 ### インタラクションフロー ``` 意図理解 → 情報収集 → 操作実行 → 結果検証 → ユーザーへフィードバック ``` ### ユーザー意図の認識 | ユーザーの表現 | Agent の理解 | 追加質問が必要 | |---------|-----------|--------| | "記事を投稿して" | ドキュメント作成 | タイトル、コンテンツ、カテゴリ | | "あのドキュメントを更新して" | ドキュメント更新 | slug、更新内容 | | "カテゴリを追加して" | カテゴリ作成 | 名前、slug | | "あの記事を削除して" | ドキュメント削除 | slug、確認 | | "今あるものを確認して" | ドキュメント/カテゴリ一覧 | 追加質問不要 | | "顧客事例を作成して" | ドキュメント+カテゴリ作成 | 顧客情報、カテゴリ | | "タグを一括更新して" | タグ更新 | タグリスト、対象値 | ### ガイド話術テンプレート **ユーザー情報が不足している場合：** ``` はい、記事を作成しますね。以下の情報が必要です： 1. 記事のタイトルは？ 2. 記事のコンテンツ：Markdown ファイルを提供するか、テーマを教えていただければ作成します 3. どのカテゴリに属しますか？（既存のカテゴリを確認できます） 複数の言語バージョンを同時に作成しますか？ ``` **ユーザーが URL を提供した場合：** ``` はい、まずサイト情報を取得してから記事を作成します。以下を確認してください： 1. 記事の言語：中国語、英語、日本語、またはすべて？ 2. カテゴリ：既存の「顧客事例」カテゴリを使用しますか、新規作成しますか？ ``` **ユーザーが一括操作を希望する場合：** ``` はい、一括更新しますね。まず確認です： 1. 影響範囲：すべての記事か、特定のカテゴリのみか？ 2. 操作確認：[N] 件の記事を変更します。実行してよろしいですか？ ``` ### 操作検証 操作完了後、Agent は以下を必ず行います： 1. 返された JSON の `success: true` を確認 2. コンテンツが正しく保存されたことを検証 3. 結果とアクセスリンクをユーザーに報告 **成功フィードバック：** ``` 操作完了！ - タイトル：xxx - リンク：https://your-domain.com/docs/<slug> - カテゴリ：xxx - タグ：tag1, tag2 ``` --- ## インストールとログイン ### 環境チェック 操作を実行する前に、Agent はユーザーの環境が整っているかチェックします： ```bash # Node.js と npm のチェック node --version && npm --version ``` ### GEO Wiki CLI のインストール ```bash # インストール npm install -g geowiki-cli # Token ログイン（推奨、90日間有効） geo login --url https://your-domain.com --token geo_xxx # 確認 geo status ``` --- ## よく使う操作クイックリファレンス ### 認証 | コマンド | 説明 | |------|------| | `geo login --url URL --token TOKEN` | Token ログイン（推奨） | | `geo logout` | ログアウト | | `geo status` | 接続状態の確認 | | `geo health` | サーバーヘルスチェック（認証不要） | ### ドキュメント管理 | コマンド | 説明 | |------|------| | `geo doc list --lang LANG` | 指定言語のドキュメント一覧 | | `geo doc list --lang LANG --category CAT` | カテゴリでフィルタ | | `geo doc get --slug SLUG --lang LANG` | ドキュメント内容を取得 | | `geo doc create -f ./doc.md -c CAT --lang LANG` | ファイルから作成 | | `geo doc create --title "タイトル" --slug SLUG --content "内容" -c CAT --lang LANG` | 直接内容を渡して作成 | | `geo doc create -f ./doc.md -c CAT --lang LANG --draft` | 下書きとして保存 | | `geo doc update --slug SLUG -f ./updated.md --lang LANG` | ファイルから更新 | | `geo doc update --slug SLUG --title "新タイトル" --lang LANG` | タイトル更新 | | `geo doc update --slug SLUG --description "説明" --lang LANG` | 説明更新 | | `geo doc update --slug SLUG --author "著者" --lang LANG` | 著者更新 | | `geo doc update --slug SLUG --tags "tag1,tag2" --lang LANG` | タグ更新 | | `geo doc update --slug SLUG --notice "通知" --lang LANG` | 通知更新 | | `geo doc update --slug SLUG --category CAT --lang LANG` | カテゴリ更新 | | `geo doc update --slug SLUG --sort N --lang LANG` | 並び順更新 | | `geo doc update --slug SLUG --content "新コンテンツ" --lang LANG` | コンテンツ更新 | | `geo doc update --slug SLUG -f ./doc.md --lang LANG --draft` | 下書きとして更新 | | `geo doc slug-rename --slug OLD --new-slug NEW` | URL slug のリネーム（全言語同期更新） | | `geo doc delete --slug SLUG --lang LANG` | 指定言語バージョンを削除 | | `geo doc reorder --orders "slug1:0,slug2:1"` | 一括ソート | ### 下書き管理 | コマンド | 説明 | |------|------| | `geo draft list --json` | 下書き一覧 | | `geo draft get --slug SLUG` | 下書き内容を取得 | | `geo draft publish --slug SLUG --lang LANG` | 指定言語の下書きを公開 | | `geo draft delete --slug SLUG --lang LANG` | 指定言語の下書きを削除 | ### カテゴリ管理 | コマンド | 説明 | |------|------| | `geo category list --lang LANG` | カテゴリ一覧 | | `geo category create --name "名前" --slug SLUG` | カテゴリ作成 | | `geo category update --slug SLUG --name "新名前"` | カテゴリ更新 | | `geo category delete --slug SLUG` | カテゴリ削除 | ### タグ管理 | コマンド | 説明 | |------|------| | `geo tag list --lang LANG` | タグ一覧 | | `geo tag create --name "名前" --slug SLUG` | タグ作成 | | `geo tag delete --slug SLUG --json` | タグ削除（サイレント） | ### 検索 | コマンド | 説明 | |------|------| | `geo search "キーワード" --lang LANG` | ドキュメント検索 | | `geo search "CAN bus" --category CAT --lang LANG` | カテゴリで検索 | ### 設定管理 | コマンド | 説明 | |------|------| | `geo config get --json` | 設定取得 | | `geo config update --site-name "新サイト名"` | 設定更新 | ### ユーザー管理 | コマンド | 説明 | |------|------| | `geo user list --json` | ユーザー一覧 | | `geo user create --username USER --password PASS --role ROLE` | ユーザー作成 | | `geo user reset-password --id USER-ID` | パスワードリセット | ### GEO 最適化 | コマンド | 説明 | |------|------| | `geo geo status` | GEO ステータス | | `geo geo rebuild` | llms.txt/sitemap 再構築 | ### 統計 | コマンド | 説明 | |------|------| | `geo stats` | ダッシュボード統計 | | `geo stats metrics` | 詳細システム指標 | ### グローバルパラメータ | パラメータ | 説明 | |------|------| | `--json` | JSON 形式出力 | | `--lang LANG` | 言語指定（zh/en/jp） | | `--category CAT` | カテゴリ指定 | | `--draft` | 下書きとして保存 | --- ## 典型的なワークフロー例 ### 多言語記事の作成 ```bash # 中国語版を作成 geo doc create -f ./article-zh.md --category tech --lang zh --json # 英語版を作成 geo doc create -f ./article-en.md --category tech --lang en --json # 日本語版を作成 geo doc create -f ./article-jp.md --category tech --lang jp --json # 確認 geo doc list --lang zh --category tech --json ``` ### 直接内容を渡して作成 ```bash # ファイル不要、直接内容を渡す geo doc create --title "製品発売" --slug product-launch --category news --lang zh --content "# 製品発売\n\n発表します..." ``` ### 単一フィールドの更新 ```bash # タイトルのみ更新 geo doc update --slug my-doc --title "新タイトル" --lang zh # 説明のみ更新 geo doc update --slug my-doc --description "新説明" --lang zh # 通知のみ更新 geo doc update --slug my-doc --notice "このドキュメントは更新されました" --lang zh ``` ### 下書きレビューフロー ```bash # 下書きとして保存 geo doc create -f ./draft.md --category guide --lang zh --draft # 下書きを公開 geo draft publish --slug draft-slug --lang zh ``` ### 一括更新 ```bash # 特定カテゴリの記事を取得してタグを更新 geo doc list --category tech --lang zh --json | jq -r '.[].slug' | while read slug; do geo doc update --slug "$slug" --tags "tech,audited" --lang zh --json done ``` --- ## SEO / GEO 最適化ワークフロー Agent は CLI でサイト情報を読み取り、最適化コードを生成し、`customHeadHtml` でワンクリック適用できます。コード変更不要、新しいコマンド追加不要。 ### ワークフロー ``` サイト状態の読み取り → コンテンツ構造の分析 → 最適化コードの生成 → customHeadHtml への適用 → GEO 再構築 ``` ### ステップ1：サイトの把握 ```bash # サイト設定を取得（TDK、URL、言語など） geo config get --json # ドキュメント構造を取得 geo doc list --lang zh --json geo doc list --lang en --json # カテゴリ構造を取得 geo category list --lang zh --json # GEO ステータスを取得 geo geo report --json ``` ### ステップ2：最適化コードの生成 Agent がサイト情報に基づいて `<meta>` と `<link>` タグを生成します。**`<meta>` と `<link>` のみ使用可能、`<script>` は使用不可**（セキュリティフィルタでブロックされます）。 #### 検索エンジン認証 ```html <meta name="google-site-verification" content="あなたの認証コード"> <meta name="msvalidate.01" content="あなたのBing認証コード"> <meta name="baidu-site-verification" content="あなたの百度認証コード"> ``` #### 多言語 SEO（hreflang） ```html <link rel="alternate" hreflang="zh" href="https://site.com/?lang=zh"> <link rel="alternate" hreflang="en" href="https://site.com/?lang=en"> <link rel="alternate" hreflang="ja" href="https://site.com/?lang=jp"> <link rel="alternate" hreflang="x-default" href="https://site.com/"> ``` #### GEO 最適化タグ ```html <meta name="ai-content-declaration" content="structured, authoritative, AI-ready"> <meta name="geo.region" content="CN-GD"> <meta name="geo.placename" content="Shenzhen"> ``` #### SNS 補足 ```html <meta property="og:locale" content="zh_CN"> <meta property="og:locale:alternate" content="en_US"> <meta name="twitter:site" content="@your_handle"> ``` ### ステップ3：適用 ```bash # すべての最適化タグを一括適用 geo config update --custom-head ' <meta name="google-site-verification" content="xxx"> <meta name="ai-content-declaration" content="structured, authoritative, AI-ready"> <meta name="geo.region" content="CN-GD"> <link rel="alternate" hreflang="zh" href="https://site.com/?lang=zh"> <link rel="alternate" hreflang="en" href="https://site.com/?lang=en"> ' ``` ### ステップ4：GEO 再構築 ```bash geo geo rebuild ``` ### 注意事項 | ルール | 説明 | |------|------| | ✅ 使用可能 | `<meta>`、`<link>` タグ | | ❌ 使用不可 | `<script>`、`<title>`、`<style>`（フィルタでブロック） | | ❌ 繰り返し禁止 | システムには title、description、og、twitter、canonical、JSON-LD が組み込まれています | | 🔄 上書きルール | 新しいコンテンツは古い customHeadHtml を置き換えます（追加ではありません） | ### Agent 最適化チェックリスト - [ ] Title にブランド名 + コアクエリワードを含む（≤80文字） - [ ] Description にコアバリュー + CTA を含む（≤200文字） - [ ] Keywords にコアビジネスワードをカバー（≤100文字） - [ ] 検索エンジン認証を設定済み（Google/Bing/百度） - [ ] 多言語サイトに hreflang タグを追加済み - [ ] GEO 最適化タグを追加済み（ai-content-declaration） - [ ] llms.txt と sitemap を再構築済み --- ## Agent インテグレーション設定 ```json { "tools": { "geo-wiki": { "command": "geo", "args": ["--url", "https://your-domain.com"] } } } ``` --- ## ベストプラクティス 1. **常に --json 出力を使用**：パースと検証が容易 2. **操作前にログイン確認**：`geo status` 3. **操作後に結果を検証**：`success: true` を確認 4. **各ステップでユーザーにフィードバック**：コミュニケーションの透明性を維持 5. **一括操作前に確認**：影響範囲をユーザーに通知 6. **常に --lang を指定**：他の言語バージョンへの誤操作を防止 --- *最終更新: 2026-07-02 | バージョン: v1.0.7*