CLI クイックリファレンス

GEO Wiki CLI コマンドクイックリファレンス、エージェントのクイック使用用

# GEO Wiki CLI — エージェントスキル GEO Wiki Pro コマンドライン管理ツール。AI エージェントがナレッジベースを自動管理できるようにします。 ## インストール ```bash # Node.js >= 18 が必要 npm install -g geowiki-cli # インストール確認 geo status ``` ## ログイン ```bash # トークンログイン(推奨) geo login --url https://geowiki.pro --token geo_xxxxx # パスワードログイン geo login --url https://geowiki.pro --user <username> --pass <password> ``` ログイン後、トークンは自動的にローカルに保存され、後続のコマンドは自動的に認証を含みます。 ## ドキュメント管理 ```bash # ドキュメント一覧 geo doc list --category <category> --lang zh --json # ドキュメント作成 geo doc create --file ./article.md --category <category> --lang zh # ドキュメント取得 geo doc get --slug <slug> --lang zh --json # ドキュメント更新 geo doc update --slug <slug> --file ./updated.md # カテゴリのみ更新 geo doc update --slug <slug> --category new-category # ソートのみ更新 geo doc update --slug <slug> --sort 0 # ドキュメント削除(ゴミ箱に移動) geo doc delete --slug <slug> # バッチ並べ替え geo doc reorder --orders "slug1:0,slug2:1,slug3:2" ``` ## カテゴリ管理 ```bash geo category list --json geo category create --name "カテゴリ名" --slug category-slug geo category update --slug <slug> --name "新しい名前" geo category delete --slug <slug> ``` ## タグ管理 ```bash geo tag list --json geo tag create --name "タグ名" --slug tag-slug geo tag delete --slug <slug> ``` ## メディアアップロード ```bash geo media upload --file ./image.png geo media upload --file ./document.pdf --directory docs geo media list --json ``` ## 設定管理 ```bash geo config get --json geo config update --site-name "新しいサイト名" geo config update --hero-title "新しいタイトル" --hero-subtitle "新しいサブタイトル" geo config update --featured-slugs "slug1,slug2,slug3" ``` ## ユーザー管理 ```bash geo user list --json geo user create --username <user> --password <pass> --role editor geo user update --id <user-id> --role admin geo user reset-password --id <user-id> geo user delete --id <user-id> # API トークン管理 geo user token list --json geo user token delete --id <token-id> ``` ## その他のコマンド ```bash geo search "キーワード" --json # ドキュメント検索 geo stats --json # ダッシュボード統計 geo draft list --json # ドラフト管理 geo feedback list --json # フィードバック管理 geo guestbook list --json # 留言板管理 geo geo status # GEO 最適化ステータス geo geo report --json # GEO 分析レポート geo geo rebuild # llms.txt / sitemap の再生成 ``` ## グローバルオプション すべてのコマンドは `--json` フラグをサポートし、構造化された JSON を出力し、エージェントの解析に適しています。 ## エージェント注意事項 ### 1. NAS 上のファイルを sed で直接編集しないでください ```bash # 間違い:ファイルが切り捨てられ、sed は変更された部分のみ保持 ssh user@nas "sed -i 's/old/new/' /path/to/file.md" # 正しい:CLI または API を使用して更新 geo doc update --slug <slug> --file ./updated.md ``` **理由**: `sed -i` は複数行ファイルを処理する際、frontmatter 以外のコンテンツが失われる可能性があります。 ### 2. 中国語ファイル名はエンコーディングが必要 CLI とフロントエンドは自動的に `encodeURIComponent()` でファイル名をエンコーディングします。API を直接呼び出す場合は手動エンコーディングが必要: ```bash # 間違い curl -H "X-Original-Filename: 测试.pdf" ... # 正しい curl -H "X-Original-Filename: %E6%B5%8B%E8%AF%95.pdf" ... ``` ### 3. すべての書き込み操作に CSRF トークンが必要 CLI は自動的に処理します。API を直接呼び出す場合は、Cookie から `XSRF-TOKEN` を抽出し、リクエストヘッダーに含める必要があります。 ### 4. サポートされているファイルアップロードタイプ 画像:JPG, PNG, GIF, WebP 動画:MP4, WebM 音声:MP3, WAV, OGG ドキュメント:PDF, DOC, DOCX, TXT, MD 3D モデル:STEP, STP, IGS ## エージェント使用例 ```bash # 完全なワークフロー:ログイン → ドキュメント作成 → GEO 再生成 geo login --url https://geowiki.pro --token geo_xxxxx geo doc create --file ./new-article.md --category guide --lang zh geo geo rebuild # バッチインポート for f in ./docs/*.md; do geo doc create --file "$f" --category docs --lang zh done # 検索結果の処理 geo search "API" --json | jq '.[] | {slug, title}' ```