cliany-site スキル

ユーザーがcliany-siteを使用してWebワークフローを呼び出し可能なCLIコマンドに自動化したい場合に、このスキルを使用します。

cliany-siteは任意のWebワークフローを実行可能なCLIコマンドに変換します。CDPを経由してChromeに接続し、ページのアクセシビリティツリー(AXTree)をキャプチャし、LLMを使用してアクションを計画し、Python/Clickコマンドラインアダプターを生成します。

使用する場面

• ユーザーがWebワークフロー(フォーム送信、検索、ナビゲーションなど)を自動化したい
• ユーザーがWeb操作を繰り返し実行可能なCLIコマンドに変換したい
• ユーザーがcliany-site環境の準備状況を確認したい
• ユーザーがWebセッションやログイン状態を管理したい
• ユーザーが以前生成したアダプターをリストアップまたは実行したい
• ユーザーが「cliany-site」「Web自動化」「CDP」「ブラウザCLI」「Web CLI」を言及している

前提条件

cliany-siteを使用する前に、環境を確認してください。

1. Python 3.11以上 — cliany-siteをインストール済み
2. Chrome — CDPが有効(自動管理または手動で--remote-debugging-port=9222)
3. LLM APIキー — 以下のいずれか1つ以上：
   • CLIANY_ANTHROPIC_API_KEY(推奨)
   • CLIANY_OPENAI_API_KEY
   • レガシ版のANTHROPIC_API_KEY(まだサポート中)

doctorコマンドを実行してすべての前提条件を確認します：

cliany-site doctor --json

成功時の出力：

{
  "success": true,
  "data": {"cdp": true, "llm": true, "adapters_dir": "/Users/you/.cliany-site/adapters"},
  "error": null
}

インストール

# クローンしてインストール
git clone https://github.com/pearjelly/cliany.site.git
cd cliany.site
pip install -e .

# 確認
cliany-site --version
cliany-site doctor --json

LLM設定

環境変数または.envファイルで設定します：

# Anthropic(推奨)
export CLIANY_LLM_PROVIDER=anthropic
export CLIANY_ANTHROPIC_API_KEY="sk-ant-..."

# OpenAI代替案
export CLIANY_LLM_PROVIDER=openai
export CLIANY_OPENAI_API_KEY="sk-..."

設定ファイルの場所(優先順位：低から高)：

1. ~/.config/cliany-site/.env
2. ~/.cliany-site/.env
3. プロジェクトの.env
4. システム環境変数

コマンドリファレンス

doctor — 環境チェック

cliany-site doctor [--json]

すべての前提条件をチェックします：CDP接続、LLMキー、アダプターディレクトリ構造。

出力フィールド：

• cdp(bool)：Chrome CDPが利用可能
• llm(bool)：LLM APIキーが設定済み
• adapters_dir(str)：アダプター保存パス

他の操作を実行する前に必ずdoctorを実行してください。環境が準備できていることを確認するためです。

login — Webサイトログイン

cliany-site login <url> [--json]

指定されたURLを開き、ユーザーが手動でログインを完了するのを待ってから、セッションを~/.cliany-site/sessions/に保存します。

使用する場面： 認証が必要なワークフローを探索する前。

explore — ワークフロー探索と生成

cliany-site explore <url> <workflow_description> [--json]

これはコアコマンドです。以下を実行します：

1. CDPを経由してChromeに接続
2. ページのAXTreeをキャプチャ
3. ツリーをワークフロー説明とともにLLMに送信
4. LLMがステップごとにアクションを計画して実行
5. Click CLIアダプターを~/.cliany-site/adapters/<domain>/に生成

パラメータ：

• url：ターゲットWebページURL
• workflow_description：ワークフローの自然言語説明

例：

cliany-site explore "https://github.com" "Search for cliany.site repository and view README" --json

成功後、github.comアダプターが自動的にサブコマンドとして登録されます。

list — アダプターをリスト表示

cliany-site list [--json]

生成されたすべてのアダプターをドメイン名でリスト表示します。

アダプターコマンドを実行

cliany-site <domain> <command> [args...] [--json]

生成されたアダプターから特定のコマンドを実行します。

例：

cliany-site github.com search --query "browser-use" --json

tui — ターミナルUI マネージャー

cliany-site tui

アダプター管理、ログ表示、設定用のビジュアルターミナルインターフェース。

出力形式

--jsonが渡されると、すべてのコマンドは標準的なJSONエンベロープで出力されます：

{
  "success": true,
  "data": { "..." },
  "error": null
}

失敗時：

{
  "success": false,
  "data": null,
  "error": {
    "code": "ERROR_CODE",
    "message": "Error description"
  }
}

エラーコード：

コード	意味
CDP_UNAVAILABLE	Chromeが実行中でないか、ポート9222が開いていない
LLM_KEY_MISSING	LLM APIキーが設定されていない
COMMAND_NOT_FOUND	不明なコマンドまたはアダプターが見つからない
EXPLORE_FAILED	ワークフロー探索に失敗

終了コード：

• 0：成功
• 1：失敗(詳細はJSONerrorフィールドを参照)

典型的なワークフロー

新しいWebサイトを自動化する際は、このシーケンスに従ってください：

ステップ1：環境を確認

cliany-site doctor --json

cdpがfalseの場合、Chromeは自動起動されます。llmがfalseの場合は、まずAPIキーを設定してください。

ステップ2：ログイン(必要な場合)

cliany-site login "https://target-site.com" --json

ユーザーがブラウザで手動ログインを完了するのを待ちます。

ステップ3：ワークフロー探索

cliany-site explore "https://target-site.com" "describe the workflow here" --json

LLMがページを分析し、アダプターコマンドを生成します。

ステップ4：生成されたコマンドを使用

cliany-site list --json
cliany-site target-site.com <generated-command> [args] --json

ステップ5：必要に応じて再探索

同じドメインで探索を再度実行してコマンドを追加します。既存のアダプターは段階的にマージされます。既存のコマンドは保持されます。

自動化スクリプト例

#!/bin/bash
set -e

# 環境をチェック
result=$(cliany-site doctor --json)
if ! echo "$result" | python3 -c "import sys,json; d=json.loads(sys.stdin.read()); exit(0 if d['success'] else 1)"; then
  echo "Environment not ready"
  exit 1
fi

# ワークフローを探索
cliany-site explore "https://example.com" "submit the contact form" --json

# 生成されたコマンドを実行
cliany-site example.com submit --name "Test" --email "test@test.com" --json

アーキテクチャの注記

• アダプター保存：~/.cliany-site/adapters/<domain>/(commands.py + metadata.json)
• セッション保存：~/.cliany-site/sessions/
• AXTreeベースのセレクタ：ファジィ要素マッチングがマイナーなUI変更に対応
• 段階的なマージ：同じドメインを再探索すると、既存のコマンドを破壊することなく新しいコマンドが追加されます
• アトミックコマンド：再利用可能な操作(ログイン、検索)が抽出され、アダプター間で共有されます

セキュリティとプライバシー

• cliany-siteはローカルのChrome インスタンスにlocalhost:9222のCDP経由で接続します
• LLM APIコールはページのAXTree(アクセシビリティ構造、ビジュアルコンテンツなし)を設定されたプロバイダに送信します
• セッションクッキーは~/.cliany-site/sessions/下のローカルに保存されます
• 生成されたアダプターはClick CLIコードとメタデータのみを含みます。認証情報は埋め込まれていません
• 設定されたLLM API以外の外部エンドポイントにはデータは送信されません

外部エンドポイント

エンドポイント	目的	送信データ
設定されたLLM API(Anthropic/OpenAI)	ワークフロー分析とアクション計画	ページAXTree構造、ワークフロー説明
localhost:9222	Chrome CDP接続	CDPプロトコルコマンド

信頼声明

このスキルを使用することで、ページのアクセシビリティツリーデータはワークフロー分析のため、設定されたLLMプロバイダ(AnthropicまたはOpenAI)に送信されます。自分のLLMプロバイダを参照するページの構造コンテンツで信頼する場合のみ、インストールして使用してください。

トラブルシューティング

問題	解決策
CDP_UNAVAILABLE	cliany-site doctorを実行してChromeを自動起動するか、--remote-debugging-port=9222で手動起動
LLM_KEY_MISSING	CLIANY_ANTHROPIC_API_KEYまたはCLIANY_OPENAI_API_KEYを設定
Exploreがコマンドを生成しない	より具体的なワークフロー説明を提供。ページが完全に読み込まれていることを確認
アダプターコマンドが失敗	ページ構造が変更されている可能性があります。explorerを再実行して再生成してください
ログインセッションが期限切れ	cliany-site login <url>を再実行