mcpField
O
opencli-usage

opencli-usage

github.com/jackwenerエージェントワークフロー30.7k21.1k 回インストール2 日前に更新
リポジトリ

opencli-usage について

opencli-usageは、OpenCLIの使い方をエージェントに案内するスキルです。コマンド検索、ブラウザーセッション、サイトアダプター、プラグイン、認証、デーモン管理に加え、JSON出力とエラー処理を説明します。

主な機能

  1. 01コマンド一覧の検索とページ送り
  2. 02コマンドヘルプと出力形式の確認
  3. 03Chromeブラウザーセッションの管理
  4. 04サイトアダプターの初期化とテスト
  5. 05プラグイン、認証、デーモンの管理

活用シーン

  1. 01サイトで使えるCLIコマンドを検索
  2. 02Chromeに接続してブラウザー状態を確認
  3. 03サイトアダプターのコマンドをテスト
  4. 04認証やブリッジプロセスの状態を診断

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jackwener/opencli --skill opencli-usage

インストール後、Claude Code で/opencli-usageを入力して読み込まれたか確認します。

詳細

OpenCLI

OpenCLI は、エージェント向けに再利用可能なウェブサイトアダプターと、Chrome の直接操作ツールを提供します。

opencli list search
opencli list --site github --limit 20
opencli github search --help -f json

list [query] は、組み込み機能とアダプター全体からコマンド名と説明を検索します。 結果は簡潔なページ分割形式です：{ok:true,data:{commands,total,nextOffset?}}。 続きの結果を取得するには、--offset <nextOffset> を渡します。正確な入力を確認するには、コマンドのヘルプを参照してください。 アダプターの一覧をハードコードしたり、すべてのコマンドをコンテキストに出力したりしないでください。

結果

コマンドの出力形式はデフォルトで JSON です：{ok:true,data:...}。失敗時は終了コードが 0 以外になり、 標準出力に {ok:false,error:{code,message,hint?,...}} が出力されます。ログは標準エラー出力に出力されます。 コマンドのヘルプに記載されている場合は、-f table|yaml|csv|md|plain による明示的なエクスポートを利用できます。ヘルプ、バージョン、補完、明示的な plain エクスポートでは、それぞれ固有の形式が維持されます。 ブラウザーの追従モードでは、1 行につき 1 つの JSON エンベロープがストリーミングされます。

エラーコードと提示された候補やキーを使って復旧してください。書き込み操作の結果が不明な場合は、操作を繰り返す前に状態を確認してください。成功したものの結果が空である場合と、実行に失敗した場合は異なります。

ブラウザー

opencli browser open https://example.com --session research
opencli browser state --session research
opencli browser close --session research
opencli browser chrome describe

ページコマンドでは --session を使用します。Chrome のネイティブメソッドではセッションは不要です。--profile は、接続済みの Chrome プロファイルを選択します。profile list でプロファイルを確認し、 profile use <name> でデフォルトを選択します。接続を診断するには doctor を使用します。 操作、API の証拠、タブやグループの管理については、opencli-browser を参照してください。

アダプターとインストール

opencli adapter init example/search
opencli adapter check example/search
opencli adapter test example/search --args '{"query":"hello"}'
opencli adapter status

実装については opencli-adapter-author を参照してください。adapter eject を実行すると、公式サイトのアダプターをローカルで編集できるようになります。adapter reset は、そのローカルオーバーライドを削除します。アダプターのテストでは実際のコマンドが実行され、書き込みが行われる場合があります。

plugin list|install|update|uninstall|create は、プラグインパッケージを管理します。auth status はウェブサイトのログイン状況を報告し、auth refresh はセッションにアクセスします。daemon status|restart|stop はブリッジプロセスを管理します。選択した機能のヘルプを参照してください。

バンドルされたスキルコンテンツは、skills list および skills read opencli-browser -f plain から利用できます（JSON の場合は -f plain を省略してください）。

コメント

Markdown 対応