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}'
```