search-registry-items

レジストリー項目を検索する

項目の name と description を対象に全文検索を行い、インデックス化された shadcn レジストリーのカタログ項目を検索します。レジストリーの名前空間と、npx shadcn@latest add 用の addCommandArgument を返します。

デフォルトのツール呼び出し：

CallMcpTool({ "server": "user-shoogle", "toolName": "search_registry_items", "arguments": { "query": "button" } })

ワークフロー

進行状況：

• user-shoogle で、短いキーワードまたは名前の一部を使って search_registry_items を呼び出します（全文ではなく）
• 該当項目を以下の出力テーブルにまとめます。生の JSON をそのまま出力しないでください
• 同じ名前のレジストリーが複数ある場合は、どのレジストリーを使用するか尋ねます
• npx shadcn@latest add {addCommandArgument}（またはプロジェクトのパッケージランナー）でインストールします
• 必要な場合のみページネーションします（offset += limit、pagination.hasMore が true の間）

ユーザーが追加先を正確に指定している場合（例：@cult-ui/gradient-button）は、検索を省略して view / add に進みます。

検索後のインストールと構成のルールについては、shadcn スキルを参照してください。

注意点

• MCP ツールは 1 つだけです。 user-shoogle が公開しているのは search_registry_items です。ブロック検索およびセマンティック検索の MCP ツール（search、search_vectors）は利用できません。代わりに shoogle.dev/search を使用してください。このワークフローでは npx shadcn@latest search を使用しないでください。
• name と description を対象とした全文検索です。 両方のフィールドを対象に全文検索で照合されます。項目のタイトルを対象にした検索でも、セマンティック検索やベクトル検索でもありません。たとえば carousel で検索すると、名前が carousel の項目や、説明に carousel について記載されている項目が一致する場合があります。
• 意図ではなくキーワードを使います。 「ダークモード対応のログインページ」のような複数の概念を含む自然言語のクエリは、うまく機能しません。セマンティックなブロック検索が必要な場合は、ユーザーに shoogle.dev/search を案内してください。
• レジストリーのプレフィックスではなく、項目名を検索します。 @acme/button ではなく button を使用してください。結果は registry で絞り込みます。
• 文章より短い語句が適しています。 button、hero、data-table を優先してください。空のクエリや空白のみのクエリでは何も返されません。
• 結果がありませんか？ より短い語句や類義語（dialog と modal など）を試してください。
• インストール先には addCommandArgument を使用します。 その値を変更せずに使用してください：npx shadcn@latest add cult-ui/gradient-button。@registry/name から組み立て直さないでください。
• ページネーションの上限は 100 です。 デフォルトのページサイズは 100 です。結果が複数ページにわたる場合は pagination.total を伝えてください。

MCP が利用できない場合は、shoogle.dev/mcp-install を案内してください。パラメーターやレスポンスの詳細については、references/TOOL-REFERENCE.md を参照してください。

出力形式

必ず Markdown テーブルで回答してください：

name	registry	add command	type	description

• add command：addCommandArgument がある場合は、npx shadcn@latest add {addCommandArgument} を記載します
• 説明が空の場合は — を使用します
• 該当件数と、必要に応じてページ情報を最後に記載します

例 — ユーザーが複数のレジストリーからボタンコンポーネントを求めている場合：

name	registry	add command	type	description
button	shadcn	npx shadcn@latest add shadcn/button	registry:ui	クリック可能なボタンコンポーネント
button	cult-ui	npx shadcn@latest add cult-ui/button	registry:ui	アニメーション付きのボタンバリエーション

2 件が見つかりました（2 件中 1～2 件を表示）。どのレジストリーから追加しますか？

対象外

必要な項目	代わりに使用
名前または説明からレジストリー項目を検索	search_registry_items（このスキル）
ブロックのキーワード検索	shoogle.dev/search
セマンティック検索／レイアウト検索	shoogle.dev/search
既知の項目をインストール	shadcn CLI add / view
1 つのレジストリーを閲覧	npx shadcn@latest search @registry -q "…"