# AIエージェント向け利用案内 — Frontend Tools

> CSS・SVG・UI・モーションの実装を試せる、Stella Createの公開ツールを案内します。対象は https://stella-create.co.jp/tools/ 以下です。

## ツールを探す

- [全ツールのMarkdown](https://stella-create.co.jp/tools/index.md): 名前・説明・URL・タグ。
- [JSONカタログ](https://stella-create.co.jp/tools/catalog.json): ツールID、カテゴリ、検索キーワードも含むサイト独自形式。
- [JSON Schema](https://stella-create.co.jp/tools/catalog.schema.json): カタログの形式定義。
- [エージェント向け索引](https://stella-create.co.jp/tools/llms.txt)
- [サイトマップ](https://stella-create.co.jp/tools/sitemap.xml)
- [HTMLの一覧](https://stella-create.co.jp/tools/)

カタログはHTMLの公開一覧から自動生成しています。個別ツールの入力項目、保存形式、対応ブラウザはリンク先で確認してください。カタログは遠隔操作APIではありません。

一覧の検索URLは `https://stella-create.co.jp/tools/?q=GSS&category=experiment` のように共有できます。検索語は最大200文字。カテゴリは `all` / `generator` / `motion` / `layout` / `state` / `color` / `experiment` です。

## Agent Skills — ツールの利用手順

- [SKILL.md](https://stella-create.co.jp/tools/agent-skills/stella-frontend-tools/SKILL.md): 目的からのツール選び、現在の画面での設定、依頼されたコードや素材の取得・確認までを案内します。
- [Agent Skills索引](https://stella-create.co.jp/tools/agent-skills/index.json): 発見仕様draft 0.2.0の形式で、スキルの名前・説明・URL・SHA-256を提供します。

カタログは「何を作れるか」の一覧、スキルは「どう使うか」の手順です。対応するエージェントが読み込んで利用する文書で、個別ツールを遠隔実行するAPIではありません。WebMCPなしでもカタログと通常UIで利用できます。ファイルの上書きやサイト公開など、依頼に含まれない操作を許可するものではありません。全エージェントでの自動発見・利用を保証しません。

## WebMCP — 一覧ページだけの操作

一覧ページを開いていて、ブラウザとエージェントがWebMCPに対応している場合に利用できます。通常の検索UIと同じ処理を使います。公開範囲を他のオリジンへ明示的に拡張していません。

### search_frontend_tools

検索・カテゴリ・URLを変更し、画面に該当する全件を表示します。返却結果のみ `limit` と `offset` で区切ります。

入力例: `{"query":"GSS","category":"experiment","limit":12,"offset":0}`

- `query`: 文字列、最大200文字、既定値は空文字。名前・説明・検索キーワードから検索。
- `category`: 上記カテゴリ、既定値 `all`。現在選択中のカテゴリを引き継ぎません。
- `limit`: 1〜50の整数、既定値12。
- `offset`: 0〜10000の整数、既定値0。
- 未定義の入力プロパティや不正な値は拒否します。入力を検証してから表示を変更します。
- 結果: `query`, `category`, `total`（登録総数）, `matches`（該当総数）, `categories`, `url`, `offset`, `limit`, `hasMore`, `results`。
- `results` の各項目: `id`, `name`, `description`, `url`, `category`, `tags`。
- ツールのページを開いたり、ファイルを保存したり、個別ツールの設定を変更したりはしません。

### get_frontend_tool

入力例: `{"id":"gss-scene-studio"}`

ID（URLスラッグ）から1件の情報を読み取ります。画面・URLを変更しません。存在する場合は `found: true` と上記ツール情報、存在しない場合は `found: false` と `id` を返します。

### get_frontend_tools_state

入力: `{}`。現在の `query`, `category`, `total`, `matches`, `categories`, `url` を返します。画面を変更しません。

## 対応範囲と注意

- WebMCPは提案段階のWeb標準です。ブラウザ側の対応・有効化が必要な場合があります。全エージェントでの利用を保証しません。[Chrome公式案内](https://developer.chrome.com/docs/ai/webmcp?hl=ja)
- WebMCPが使えない環境でも、HTMLの検索と静的カタログは利用できます。
- リモートMCPサーバー、個別ツールの一括操作API、OAuth認証は提供していません。
- ファイルの読み込み、カメラ・マイクの利用、保存・ダウンロードは、利用者の意図を確認してから行ってください。
- 各ツールの利用条件と対応環境を確認してください。実験的な機能を使うツールもあります。
- 生成コードは実際の組み込み先で表示・操作・アクセシビリティを確認してください。
- 一覧とこの案内は、対応するApache設定のもとで `Accept: text/markdown` を明示すると同じURLでMarkdownを返します。HTMLも指定した場合はAcceptの優先度に従います。`q=0` はその形式を除外します。どちらも受け入れ不可なら406を返します。未指定やワイルドカードだけの場合は通常のHTMLです。Markdownファイルを直接取得することもできます。個別ツールの操作画面は対象外です。
- llms.txtは提案に基づく案内であり、認証・アクセス制御やAI学習の許諾を追加するものではありません。

[HTML版の利用案内](https://stella-create.co.jp/tools/agent-guide/) / [更新情報（X）](https://x.com/hiro_ghap1)
