mcpField
C
cli-anything-openrefine

cli-anything-openrefine

github.com/hkudsデータ・データベース57.6k195 回インストール5 週間前に更新
リポジトリ

cli-anything-openrefine について

自動化されたエージェントのワークフローで OpenRefine を利用し、データのクリーニングや変換、操作履歴の再利用、CSV／TSV 出力を行うコマンドラインスキルです。JSON 出力と分離されたセッションにより、スクリプト実行や CI での失敗検出に対応します。

主な機能

  1. 01データのクリーニングと変換
  2. 02OpenRefine 操作履歴の再利用
  3. 03CSV と TSV のエクスポート
  4. 04JSON 出力と分離セッション
  5. 05パイプ入力 REPL と失敗状態

活用シーン

  1. 01インポートした CSV データの自動クリーニング
  2. 02既存の操作履歴の適用
  3. 03処理済みデータの CSV／TSV 出力
  4. 04CI での実行と失敗検出

インストール

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

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-openrefine

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

詳細

CLI-Anything OpenRefine

自動化されたエージェントワークフローから OpenRefine のデータクレンジング、変換、再利用可能な操作履歴、または CSV/TSV エクスポートが必要なタスクでは、このスキルを使用してください。

前提条件

ハーネスをインストールします:

cd openrefine/agent-harness
python -m pip install -e .

バックエンドコマンドの前に OpenRefine を起動します:

openrefine -i 127.0.0.1 -p 3333

OPENREFINE_URL=http://127.0.0.1:3333 でカスタムサーバーを設定するか、--base-url を渡します。

エージェント向けのコマンドルール

  • すべてのワンショットコマンドで --json を優先してください。
  • 分離されたタスク状態には --session <path> を使用してください。
  • row、apply、export、undo、redo の各コマンドの前に、プロジェクトをインポートまたは開いてください。
  • 既存の OpenRefine 操作履歴 JSON は、そのまま data apply に渡すことができます。
  • 生成されるファイルは通常の OpenRefine 操作 JSON およびエクスポートされた CSV/TSV データです。

一般的なコマンド

cli-anything-openrefine --json server ping
cli-anything-openrefine --json project list
cli-anything-openrefine --json --session run/session.json project import messy.csv --name cleanup
cli-anything-openrefine --json --session run/session.json data rows --limit 10
cli-anything-openrefine --json ops text-transform run/trim.json --column Name --expression 'value.trim()'
cli-anything-openrefine --json --session run/session.json data apply run/trim.json
cli-anything-openrefine --json --session run/session.json data export run/clean.csv --format csv
cli-anything-openrefine --json --session run/session.json session undo
cli-anything-openrefine --json --session run/session.json session redo

REPL

サブコマンドを指定せずに cli-anything-openrefine を実行すると、REPL に入ります。

自動化されたユーザージャーニーでは、改行区切りの REPL コマンドを stdin 経由でパイプします。リダイレクトされたストリームは自動的に ASCII のみの入出力パスを使用し、 対話型ターミナルは Unicode バナー、プロンプト履歴、スタイリングを保持します:

printf 'help\nexit\n' | cli-anything-openrefine

REPL がリダイレクトされると、Unicode ペイロードは可逆的な ASCII バックスラッシュエスケープとして レンダリングされ、レガシーな Windows の出力エンコーディングによって成功したコマンドが 失敗したジャーニーになることを防ぎます。

パイプされたワークフローは、いずれかのコマンドが失敗した場合、exit または EOF で非ゼロの終了ステータスを返すため、 CI が失敗したユーザージャーニーを検出できます。

エラーハンドリング

--json が設定されている場合、コマンドの失敗は ok: false を含む JSON オブジェクトを stderr に書き込みます。

コメント

Markdown 対応