CLI コマンドリファレンス
GEO Wiki Pro CLI コマンドリファレンス、15 個のコマンドすべてのパラメータと使用方法をカバー
# CLI コマンドリファレンス
> GEO Wiki Pro CLI は 15 個のコマンドを提供し、ドキュメント管理、カテゴリ管理、タグ管理、検索、設定、ユーザー管理などのすべての機能をカバーします。
---
## コマンド概要
| コマンド | 説明 | ログイン必要 |
|---------|------|------------|
| `geo login` | サーバーにログイン | いいえ |
| `geo logout` | ログアウトして資格情報をクリア | いいえ |
| `geo status` | 接続ステータスを表示 | いいえ |
| `geo doc` | ドキュメント管理(CRUD + 並べ替え + ゴミ箱) | はい |
| `geo category` | カテゴリ管理(CRUD + 並べ替え) | はい |
| `geo tag` | タグ管理(CRUD) | はい |
| `geo search` | ドキュメント検索 | いいえ |
| `geo config` | サイト設定の読み書き | はい |
| `geo user` | ユーザー管理 + トークン管理 | はい |
| `geo draft` | ドラフト管理(一覧/表示/公開/削除) | はい |
| `geo stats` | ダッシュボード統計 | はい |
| `geo feedback` | ユーザーフィードバック管理 | はい |
| `geo guestbook` | 留言板管理 | はい |
| `geo media` | メディアファイルのアップロード/一覧/削除 | はい |
| `geo geo` | GEO ステータス、レポート、再生成 | はい |
---
## 認証コマンド
### geo login
GEO Wiki Pro サーバーにログイン、2 つの認証方法をサポート。
#### トークンログイン(推奨)
```bash
geo login --url https://geowiki.pro --token geo_xxxxx
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--url` | `-u` | サーバーアドレス | はい |
| `--token` | `-t` | API トークン | はい |
> **推奨**: トークンログインは 90 日間有効で、キャプチャ不要、CLI や自動化スクリプトに適しています。トークンは管理パネルの「設定 -> API トークン」で生成できます。
#### パスワードログイン
```bash
geo login --url https://geowiki.pro --user admin --pass your-password
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--url` | `-u` | サーバーアドレス | はい |
| `--user` | `-U` | ユーザー名 | はい |
| `--pass` | `-p` | パスワード | はい |
::: warning
パスワードログインにはキャプチャ認証が必要で、ブラウザシナリオに適しています。トークンログインを推奨します。
:::
### geo logout
ローカルに保存された認証情報をクリア。
```bash
geo logout
```
### geo status
現在の接続ステータスとユーザー情報を表示。
```bash
geo status
```
---
## ドキュメントコマンド
### geo doc list
すべてのドキュメントを一覧表示。
```bash
geo doc list
geo doc list --category can-motion
geo doc list --lang zh --json
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--category` | | カテゴリでフィルタ | いいえ |
| `--lang` | `-l` | 言語(デフォルト zh) | いいえ |
| `--page` | | ページ番号(デフォルト 1) | いいえ |
| `--limit` | | 1 ページあたりの件数(デフォルト 50) | いいえ |
### geo doc get
ドキュメントコンテンツを取得。
```bash
geo doc get --slug quick-start
geo doc get --slug quick-start --lang en
geo doc get --slug quick-start --format json
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--slug` | `-s` | ドキュメントスラッグ | はい |
| `--lang` | `-l` | 言語(デフォルト zh) | いいえ |
| `--format` | `-f` | 出力形式:markdown または json | いいえ |
### geo doc create
新しいドキュメントを作成。
```bash
geo doc create --file ./my-doc.md --category can-motion --lang zh
geo doc create --file ./my-doc.md --sort 1
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--file` | `-f` | Markdown ファイルパス | はい(または --title) |
| `--title` | `-t` | ドキュメントタイトル(ファイルなしの場合) | はい(または --file) |
| `--category` | `-c` | カテゴリスラッグ | いいえ |
| `--slug` | `-s` | カスタムスラッグ | いいえ |
| `--lang` | `-l` | 言語コード(デフォルト zh) | いいえ |
| `--tags` | `-T` | カンマ区切りのタグ | いいえ |
| `--author` | `-a` | 著者(デフォルト Agent) | いいえ |
| `--sort` | | ソート値(デフォルト 999) | いいえ |
::: tip
ファイルには YAML frontmatter(title、slug、category、tags、author)が必要です。ファイルに frontmatter が含まれている場合、コマンドラインパラメータは省略でき、CLI が自動的に抽出します。
:::
### geo doc update
ドキュメントを更新。単一フィールド更新をサポート — 指定されたフィールドのみを変更し、他のフィールドは変更しません。
```bash
# ファイル更新(最も安全)
geo doc update --slug my-doc --file ./updated.md
# ソート値のみ更新
geo doc update --slug my-doc --sort 0
# カテゴリのみ更新
geo doc update --slug my-doc --category new-category
# コンテンツのみ更新
geo doc update --slug my-doc --content "# 新しいタイトル\n\n新しいコンテンツ"
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--slug` | `-s` | ドキュメントスラッグ | はい |
| `--file` | `-f` | 更新されたファイルパス | はい(いずれか) |
| `--content` | | インラインコンテンツ | はい(いずれか) |
| `--category` | `-c` | 新しいカテゴリ | いいえ |
| `--sort` | | 新しいソート値 | いいえ |
| `--lang` | `-l` | 言語コード | いいえ |
::: note
単一フィールド更新は指定されたフィールドのみを変更し、他のフィールドは変更しません。
:::
### geo doc delete
ドキュメントを削除(ゴミ箱に移動、30 日後自動削除)。
```bash
geo doc delete --slug my-doc
geo doc delete --slug my-doc --yes # 確認をスキップ
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--slug` | `-s` | ドキュメントスラッグ | はい |
| `--lang` | `-l` | 言語コード | いいえ |
| `--yes` | `-y` | 確認プロンプトをスキップ | いいえ |
### geo doc trash / recover
ゴミ箱内のドキュメントを表示・復元。
```bash
geo doc trash # ゴミ箱を一覧表示
geo doc trash --clear # ゴミ箱を空にする
geo doc recover --file my-doc-zh-123456.md # ドキュメントを復元
```
### geo doc reorder
ドキュメントの並べ替えを一括調整。
```bash
geo doc reorder --orders "quick-start:0,faq:1,architecture:2"
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--orders` | `-o` | 形式:`slug1:ソート値,slug2:ソート値` | はい |
---
## カテゴリコマンド
### geo category list
すべてのカテゴリを一覧表示。
```bash
geo category list
geo category list --json
```
### geo category create
カテゴリを作成。
```bash
geo category create --name "CAN モーター" --name-en "CAN MOTION" --slug can-motion \
--description "CAN バスクローズドループステッピングモーター" --description-en "CAN bus closed-loop stepper motors"
```
| パラメータ | 説明 | 必須 |
|-----------|------|------|
| `--name` | カテゴリ名(デフォルト言語) | はい |
| `--name-en` | 英語名 | いいえ |
| `--name-jp` | 日本語名 | いいえ |
| `--slug` | カテゴリスラッグ | はい |
| `--description` | カテゴリ説明 | いいえ |
| `--description-en` | 英語説明 | いいえ |
| `--description-jp` | 日本語説明 | いいえ |
::: note
スラッグが既に存在する場合、既存のカテゴリを更新します(upsert セマンティクス)。
:::
### geo category update
カテゴリ情報を更新。
```bash
geo category update --slug can-motion --name "新しい名前" --name-en "New Name"
```
### geo category reorder
カテゴリの並べ替えを一括調整。
```bash
geo category reorder --orders "products:0,technical:1,support:2"
```
### geo category delete
カテゴリを削除。
```bash
geo category delete --slug old-category
```
---
## タグコマンド
### geo tag list / create / delete
```bash
geo tag list
geo tag list --json
geo tag create --name "CAN Bus" --slug can-bus
geo tag delete --slug can-bus
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--slug` | `-s` | タグスラッグ | はい |
| `--name` | `-n` | タグ表示名 | はい(create) |
---
## 検索コマンド
### geo search
ドキュメントを検索。
```bash
geo search "CAN bus"
geo search "motor" --category can-motion
geo search "Arduino" --lang en --json
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--category` | `-c` | カテゴリでフィルタ | いいえ |
| `--lang` | `-l` | 言語(デフォルト zh) | いいえ |
| `--limit` | | 最大結果数(デフォルト 20) | いいえ |
---
## 設定コマンド
### geo config get
サイト設定を取得。
```bash
geo config get
geo config get --json
```
### geo config update
サイト設定を更新。
```bash
geo config update --site-name "マイナレッジベース"
geo config update --hero-title-zh "ようこそ" --hero-title-en "Welcome"
geo config update --hero-subtitle-zh "製品ドキュメント" --hero-subtitle-en "Product docs"
geo config update --featured-slugs "quick-start,faq,overview"
geo config update --logo-url "/media/logo.png" --favicon-url "/media/favicon.ico"
geo config update --custom-head '<meta name="theme-color" content="#2563EB">'
```
| パラメータ | 説明 | 必須 |
|-----------|------|------|
| `--site-name` | サイト名 | いいえ |
| `--site-desc` | サイト説明(SEO) | いいえ |
| `--default-lang` | デフォルト言語(zh, en, jp) | いいえ |
| `--hero-title` | Hero セクションタイトル | いいえ |
| `--hero-title-zh` | Hero タイトル(中国語) | いいえ |
| `--hero-title-en` | Hero タイトル(英語) | いいえ |
| `--hero-title-jp` | Hero タイトル(日本語) | いいえ |
| `--hero-subtitle` | Hero サブタイトル | いいえ |
| `--hero-subtitle-zh` | Hero サブタイトル(中国語) | いいえ |
| `--hero-subtitle-en` | Hero サブタイトル(英語) | いいえ |
| `--hero-subtitle-jp` | Hero サブタイトル(日本語) | いいえ |
| `--featured-slugs` | カンマ区切りの特集ドキュメントスラッグ | いいえ |
| `--logo-url` | ロゴ画像パス | いいえ |
| `--favicon-url` | ファビコンパス | いいえ |
| `--custom-head` | カスタム HTML(`<head>` に注入) | いいえ |
---
## ユーザーコマンド
### geo user list / create / update / delete
```bash
geo user list
geo user list --json
geo user create --username editor1 --password MyPass123 --role editor
geo user update --id user-xxx --role admin
geo user reset-password --id user-xxx
geo user delete --id user-xxx
```
| パラメータ | 説明 | 必須 |
|-----------|------|------|
| `--id` | ユーザー ID(update/delete/reset-password に必要) | はい |
| `--username` | ユーザー名(create に必要) | はい |
| `--password` | パスワード(create に必要) | はい |
| `--role` | ロール:admin / editor / viewer(デフォルト editor) | いいえ |
### geo user token
API トークンを管理。
```bash
geo user token list # すべてのトークンを一覧表示
geo user token list --json # JSON 形式で出力
geo user token delete --id token-id # トークンを無効化
```
::: note
API トークンの作成は管理パネルの「設定 -> API トークン」でのみ可能です。
:::
---
## ドラフトコマンド
```bash
geo draft list # すべてのドラフトを一覧表示
geo draft list --json # JSON 形式で出力
geo draft get --slug my-draft # ドラフトコンテンツを表示
geo draft publish --slug my-draft # ドラフトを公開
geo draft delete --slug my-draft # ドラフトを削除
```
---
## 統計コマンド
```bash
geo stats # ダッシュボード統計を表示
geo stats --json # JSON 形式で出力
```
---
## フィードバックコマンド
```bash
geo feedback list # すべてのフィードバックを一覧表示
geo feedback list --json # JSON 形式で出力
geo feedback delete --id "feedback-id" # フィードバックを削除
geo feedback promote --id "feedback-id" # フィードバックをドキュメントコンテンツまたは FAQ に昇格
```
---
## 留言板コマンド
```bash
geo guestbook list # すべてのエントリを一覧表示
geo guestbook list --json # JSON 形式で出力
geo guestbook toggle --enabled true # 留言板を有効化
geo guestbook toggle --enabled false # 留言板を無効化
geo guestbook update --id "entry-id" --status approved # 承認
geo guestbook update --id "entry-id" --status rejected # 拒否
geo guestbook delete --id "entry-id" # エントリを削除
```
---
## メディアコマンド
```bash
geo media upload --file ./diagram.png
geo media upload --file ./manual.pdf --directory docs
geo media upload --file ./model.step --directory models
geo media list --json
geo media delete --file old-image.jpg
```
| パラメータ | 短縮形 | 説明 | 必須 |
|-----------|--------|------|------|
| `--file` | `-f` | ローカルファイルパス(アップロード)またはファイル名(削除) | はい |
| `--directory` | `-d` | public/media のサブディレクトリ | いいえ |
### サポートされているファイルタイプ
| タイプ | 形式 |
|--------|------|
| 画像 | JPG, PNG, GIF, WebP |
| 動画 | MP4, WebM |
| 音声 | MP3, WAV, OGG |
| ドキュメント | PDF, DOC, DOCX, TXT, MD |
| 3D モデル | STEP, STP, IGS |
---
## GEO コマンド
### geo geo status
GEO 最適化ステータスを表示。
```bash
geo geo status
```
### geo geo rebuild
GEO ファイル(llms.txt、sitemap.xml)を再生成。
```bash
geo geo rebuild
```
### geo geo report
GEO 分析レポートを表示。
```bash
geo geo report
geo geo report --json
```
### geo geo llms / sitemap / manifest
```bash
geo geo llms # llms.txt コンテンツを表示
geo geo sitemap # sitemap.xml コンテンツを表示
geo geo manifest # サイトマニフェストを表示
```
---
## グローバルオプション
すべてのコマンドは `--json` フラグをサポートし、機械可読な JSON 形式を出力し、エージェントの解析に適しています。
---
## 関連ドキュメント
- [CLI インストールとログイン](/docs/cli-install) — インストールとログインガイド
- [CLI クイックリファレンス](/docs/cli-quick-reference) — エージェントクイックリファレンスマニュアル
- [GEO Wiki Pro ユーザーマニュアル](/docs/geo-wiki-pro-user-manual) — 完全なユーザーマニュアル
- [REST API ドキュメント](/docs/rest-api) — API エンドポイントリファレンス