Reference
公開ToolSetの発見
Explore APIで公開ToolSetを検索する方法
概要
Explore APIを使って、公開されているToolSetを検索・発見できます。認証不要で利用できます。
公開ToolSet一覧
API
curl "https://tool-registry-api.jinba.io/v1/explore/toolsets"クエリパラメータ
| パラメータ | 型 | 説明 |
|---|---|---|
tag | string | タグでフィルタリング |
q | string | テキスト検索 |
limit | number | 取得件数(デフォルト: 50、最大: 100) |
offset | number | オフセット(ページネーション) |
フィルタリング例
# タグでフィルタリング
curl "https://tool-registry-api.jinba.io/v1/explore/toolsets?tag=slack"
# テキスト検索
curl "https://tool-registry-api.jinba.io/v1/explore/toolsets?q=weather"
# ページネーション
curl "https://tool-registry-api.jinba.io/v1/explore/toolsets?limit=10&offset=20"公開ToolSetの詳細
curl "https://tool-registry-api.jinba.io/v1/explore/toolsets/{orgSlug}/{toolsetSlug}"レスポンスにはToolSetのメタデータ、ツール一覧、バージョン情報、組織情報が含まれます。
タグ一覧
人気のタグとその使用数を取得できます。
curl "https://tool-registry-api.jinba.io/v1/explore/tags"利用フロー
公開ToolSetを発見して利用するまでの流れ:
- 発見: Explore APIまたはWeb UIでToolSetを検索
- APIキー発行: APIキーを発行(まだ持っていない場合)
- 実行: 公開エンドポイントでツールを実行
REST APIで実行
curl -X POST https://tool-registry-api.jinba.io/v1/public/{orgSlug}/{toolsetSlug}/tools/{toolSlug}/run \
-H "Authorization: Bearer $JINBA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input": {"query": "Hello"}}'MCPで接続
{
"mcpServers": {
"toolset-name": {
"url": "https://tool-registry-api.jinba.io/v1/public/{orgSlug}/{toolsetSlug}/mcp",
"headers": {
"Authorization": "Bearer jtr_xxxxx"
}
}
}
}実行コストは利用者の組織のクレジットから消費されます。詳しくはクレジットと課金を参照してください。