mcpField
T
tavily-hikari-best-practices

tavily-hikari-best-practices

github.com/ivanli-cnエージェントワークフロー36854 回インストール2 日前に更新
リポジトリ

tavily-hikari-best-practices について

Tavily Hikari を使うエージェントやワークフロー向けのスキルです。CLI の設定、JSON 出力、トークンの安全な扱いに加え、MCP と HTTP 系エンドポイントの違いを説明します。

主な機能

  1. 01CLI 設定ガイド
  2. 02エージェント向け JSON 出力
  3. 03Hikari トークンの取り扱い
  4. 04MCP と API エンドポイントの区別
  5. 05検索範囲と出力に関する指針

活用シーン

  1. 01エージェントワークフロー向けの `tvly-hikari` 設定
  2. 02MCP クライアントまたは CLI 用エンドポイントの選択
  3. 03Hikari のスモークテスト実行

MCP 対応

MCP クライアントが使う `/mcp` エンドポイントと、CLI や HTTP 系クライアント向けの `/api/tavily` インターフェースを区別します。MCP クライアントは bearer 認証で `/mcp` に接続します。

インストール

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

$npx skills add https://github.com/ivanli-cn/tavily-hikari --skill tavily-hikari-best-practices

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

詳細

Tavily Hikari のベストプラクティス

エージェントのワークフローから Tavily Hikari を呼び出す方法を決める際は、このスキルを使用してください。

ルール

  • エージェントが読み取れる出力を得るには、tvly-hikari ... --json を使用してください。

  • th- で始まる Hikari トークンを使用してください。公式の Tavily API キーを後続のエージェントやユーザーのマシンに貼り付けないでください。

  • Hikari の設定は一度だけ行ってください。

    tvly-hikari configure --base-url https://<your-hikari-host> --token th-<id>-<secret>

  • /mcp と /api/tavily/* は異なる統合インターフェースとして扱ってください。

    • MCP クライアントは、ベアラー認証を使用して https://<your-hikari-host>/mcp に接続します。
    • CLI および HTTP スタイルのクライアントは、https://<your-hikari-host>/api/tavily を使用します。

  • 検索範囲は絞り込み、大量の出力は -o または --output-dir で保存し、事実に関する質問に回答する際はソース URL を引用してください。

  • 運用担当者の明示的な承認がない限り、Tavily の本番アップストリームに対してテストしないでください。スモークテストには、ローカルまたはサンドボックスの Hikari エンドポイントを使用してください。

クイックスモークテスト

tvly-hikari doctor
tvly-hikari search "Tavily Hikari smoke test" --json

コメント

Markdown 対応