searching-packages

Robomotion パッケージを検索する

Robomotion のパッケージ、ノード、テンプレートを見つけます。すべての検索は robomotion CLI 経由で行うため、別途 MCP クライアントは必要ありません。

4 つの動詞ですべての検索に対応

robomotion search <query>                        # cross-source fuzzy+semantic search
robomotion get <resource> [query] [flags]        # list or filter a resource
robomotion describe <resource> <name>            # full detail of one thing
robomotion docs <namespace>                      # read a package's llms.txt

get のリソース：packages | nodes | templates | categories | tags（実行時データには vaults | vault-items | robots も使用できます）。 describe の対象：node | package | template。

フローを作成する際の一般的なワークフロー

1. 利用可能なものを探す — まだパッケージやノードがわからない場合：

   robomotion search "http request"              # mixed results across sources
   robomotion get nodes click                    # nodes with "click" in the name
   robomotion get nodes --in Core.Browser        # every node in one package
   robomotion get templates bmi                  # match by slug/name/summary
   robomotion get templates --category "Web Scraping"
   robomotion get templates --tag api
   robomotion get categories                     # vocabulary
   robomotion get tags                           # vocabulary
   

2. プロパティを確認する してから記述します：

   robomotion describe node Core.Net.HttpRequest
   robomotion describe node Core.Net.HttpRequest,Core.Flow.GoTo   # batch
   

   プロパティ名、型、説明、列挙値、デフォルト値、一般的なプロパティ（delayBefore、continueOnError、…）を含む完全なカードが返されます。

3. Core.* 以外のパッケージを接続する場合は、パッケージのドキュメントを読む：

   robomotion docs Robomotion.WordPress                   # compact (first 100 lines)
   robomotion docs Robomotion.WordPress --full            # whole llms.txt
   robomotion docs Robomotion.WordPress --grep auth       # line-filtered
   robomotion docs Robomotion.WordPress --section CreatePost
   

   docs には、ノードスキーマには記載されていない認証パターンやパッケージ固有の注意事項が含まれています。使用する Core.* 以外のパッケージごとに実行してください。多くのパッケージには llms.txt がありません（例：Robomotion.HermesAgent）。その場合、docs は "available":false を返し、パッケージ独自の説明がドキュメントとなります。ノードとバージョンについては robomotion describe package <ns> を、接続する各ノードについては robomotion describe node <type> を読んでください（すべてのプロパティに説明があります）。

検索エンジンの機能

内部では、robomotion search は Bleve の全文検索を使用し、次の機能を備えています。

機能	動作
全文検索	タイトル、名前、説明、コンテンツ、キーワードを対象に BM25 でランキング
あいまい検索	Levenshtein 距離 ≤ 2 — タイプミスを許容します（browsr → browser、wordpres → wordpress）
セマンティック検索	同義語を拡張します — browser は chrome、firefox、web、scraping にも一致します
複数ソース	パッケージドキュメント（llms.txt）とテンプレートを一度の呼び出しで検索

組み込みの同義語グループ：

• browser ↔ chrome · firefox · web · scraping
• automation ↔ robot · flow · workflow · process
• wordpress ↔ blog · cms · post · article
• database ↔ sql · sqlite · query · table
• email ↔ mail · smtp · send · message
• file ↔ filesystem · directory · folder · path

フィルターフラグ

robomotion search "automation" --limit 5
robomotion get nodes "click" --package Core.Browser
robomotion get templates --tag api --limit 10
robomotion describe node Core.Browser.ClickElement --json     # raw MCP response

初回呼び出し時のウォームアップ

robomotion search は内部で robomotion-sdk-mcp を起動します。Bleve インデックスの構築には、コールドスタート時に約 3～6 秒かかります。CLI は "Search index not ready" が返された場合に自動で再試行するため、セッションごとに最初の検索は時間がかかりますが、その後はほぼ瞬時に完了します。

クイックリファレンス

やりたいこと	コマンド
キーワードであらゆる項目を検索する	robomotion search <query>
すべてのパッケージを一覧表示する	robomotion get packages
パッケージを検索する	robomotion get packages <keyword>
パッケージ内のノードを一覧表示する	robomotion get nodes --in <namespace>
キーワードでノードを検索する	robomotion get nodes <keyword>
ノードスキーマ全体を取得する	robomotion describe node <type>
パッケージドキュメントを読む	robomotion docs <namespace>
パッケージドキュメントを grep 検索する	robomotion docs <namespace> --grep <pattern>
利用可能な Vault を一覧表示する	robomotion get vaults
ロボットを一覧表示する	robomotion get robots

関連スキル

• creating-flow — 見つけたノードからフローを生成します
• validating-flow — 結果を pspec-check します
• running-flow — 送信し、エージェントイベントをストリーム配信します