mcpField
K
kirha

kirha

github.com/kirha-ai生産性526 回インストール2 週間前に更新
リポジトリ

kirha について

kirhaは、KIRHA CLIでリアルタイム情報を検索し、構造化された結果を提示するデータ取得スキルです。クエリの調整、カタログを使った再検索、費用の事前確認、エラー処理を扱います。

主な機能

  1. 01項目と期間を指定したクエリ調整
  2. 02検索と構造化JSONの解析
  3. 03分野とプロバイダーの確認
  4. 04プランと推定クレジットの確認
  5. 05認証とCLIエラーへの対応

活用シーン

  1. 01特定の質問に関する最新情報の取得
  2. 02結果が不十分な場合の検索範囲の変更
  3. 03検索プランの費用確認

インストール

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

$npx skills add https://github.com/kirha-ai/kirha-skill --skill kirha

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

詳細

KIRHA スキル

KIRHA CLI（kirha）を使ってリアルタイム情報を取得するデータ取得エージェントです。このワークフローに正確に従ってください。

事前チェック

CLI がインストールされていることを確認します。

kirha --version

コマンドが見つからない場合は、処理を中止してユーザーに次のように伝えてください。

まず KIRHA CLI をインストールしてください：curl -fsSL https://cli.kirha.com/install.sh | sh（または npm install -g @kirha/cli）。https://github.com/kirha-ai/kirha-cli をご覧ください。

CLI は API キーを自動的に解決します（kirha auth login、KIRHA_API_KEY 環境変数、または --api-key フラグから取得します）。自分で処理する必要はありません。後続の kirha search が AUTH_REQUIRED または AUTH_INVALID エラーを返した場合は、ユーザーに次のように伝えてください。

https://app.kirha.com/api-keys で API キーを取得し、kirha auth login --api-key <key> を実行するか、KIRHA_API_KEY をエクスポートしてください。

ステップ 1 — クエリを絞り込む

ユーザーの元の入力を、具体的で明確な質問に書き換えます。具体的なクエリほど、結果の精度が大幅に向上します。単位、期間、取得したい正確な項目を加え、「それ」や「それら」ではなく対象を明示します。また、暗黙の期間があれば日付を明確に指定します（KIRHA は「今日」がいつか分かりません。あなたが指定してください）。

ステップ 2 — 検索を実行する

kirha search "<refined query>"

KIRHA はすべての分野からプロバイダーを自動的に選ぶため、デフォルトでは分野を指定しないでください。

デフォルトでは生の JSON 出力を使用します。 CLI は直接解析できる構造化された data を返します。これは KIRHA に要約を依頼するよりも高速で、低コストです。ステップ 4 で、回答を自分でユーザー向けに整えます。

フラグ：

  • --focus <slug> — 検索対象を 1 つの分野に限定します。再試行するとき（下記参照）またはユーザーがドメインを指定したときにのみ使用してください。
  • --runtime standard — 複雑な複数段階のクエリで、より正確なプランニングを行います（デフォルトは fast で、応答は速いものの精度は低くなります）。
  • --summarize — サーバー側で自然言語の要約を追加します。デフォルトでは使用せず、ユーザーが KIRHA 独自の説明を明示的に求めた場合にのみ使用してください（生の検索に加えて、遅延とクレジットが増えます）。

CLI が --focus を不明なオプションとして拒否する場合は、バージョンが古いため、kirha upgrade を実行して再試行してください。

コストのかかる処理を実行する前にコストを確認するには：

kirha plan create "<query>"
# review the steps and estimated credits, then:
kirha plan exec <id>

ステップ 3 — 分野を指定して再試行する

検索結果が空、無関係、または乏しい場合は、同じ形式でただ再試行しないでください。 KIRHA が現在対応している分野を一覧表示します（カタログは随時拡充されるため、決めつけないでください）。

kirha discovery verticals list

分野ごとにスラッグ、説明、プロバイダー、プロンプト例を記載した Markdown の一覧が表示されます。最適な分野を選び、クエリを絞り込んで、--focus <slug> を指定して再検索します。複数の分野が該当する可能性がある場合は、kirha discovery verticals get <slug> で比較します。複数分野にまたがる質問では、分野ごとに検索対象を絞って検索し、結果をまとめます。プロバイダーの情報は kirha discovery providers list と kirha discovery providers get <slug> で確認できます。

内容の異なる検索を 2～3 回実行してから、データが見つからなかったことをユーザーに伝えてください。

同じ discovery コマンドで、「KIRHA では何ができますか？」という質問にも直接回答できます。

ステップ 4 — 結果を提示する

CLI は stdout に 1 行の JSON を出力します。それを解析し、data から自分で回答をまとめます。

  1. data から事実を抽出します — 数値、日付、名前、URL、エンティティ、関係性など。
  2. ユーザーの質問に直接答える簡潔な導入文を、自分の言葉で書きます。
  3. 構造化された形式を使います — 比較には表、事実には箇条書き、技術データにはコードブロックを使用します。
  4. 情報の新しさに触れます — データに含まれていれば、タイムスタンプまたは「～時点」の日付を記載します。
  5. 関連する追加質問を提案します — データから関連するクエリが示唆される場合は、簡潔に触れてください。

--summarize の使用により応答に summary フィールドが含まれている場合は、それを出発点として利用してもかまいません。ただし、通常は data から自分でまとめるほうが速く、ユーザーの質問により適した回答になります。

エラー処理

エラーは、安定したコードとともに stderr に JSON 形式で出力されます。

  • AUTH_REQUIRED / AUTH_INVALID — API キーが未設定または無効です。ユーザーに kirha auth login --api-key <key> または export KIRHA_API_KEY=... の実行と、https://app.kirha.com/api-keys の確認を案内してください。
  • RATE_LIMIT — 数秒待ってから一度だけ再試行してください。それでも制限される場合は、ユーザーに伝えてください。
  • PLAN_EXPIRED — プレビューしたプランの有効期限が切れています。kirha plan create で新しいプランを作成してください。
  • NETWORK — 一度だけ再試行してください。問題が続く場合は、接続の問題として報告してください。
  • VALIDATION / USAGE — 入力を修正して再試行してください。
  • API_ERROR / INTERNAL — KIRHA は一時的に利用できません。少し時間をおいて再試行するよう提案してください。

終了コード：0 成功、2 使用方法、3 認証、4 レート制限、5 ネットワーク、6 プランの有効期限切れ。

コメント

Markdown 対応