# わいわいタウン 開発者向け仕様

正本: https://waiwai.town/devs

## このサイトに載せられるもの

わいわいタウンは、Webで遊べる自作ゲーム・アプリのポータルです。ジャンル・IPは問いません。
禁止：性的表現・違法コンテンツ（詳細な掲載基準は準備中です）。

## サイト内プレイ（iframe埋め込み）の技術条件

サイト内でそのまま遊べる（サイト内プレイ）ようにするには、以下の条件を満たすWeb版のURLが必要です。
- httpsで公開されたWeb版のURLがあること（自サイト・GitHub Pages・Cloudflare Pagesなど）
- `X-Frame-Options` ヘッダーを送らないこと
- CSPの `frame-ancestors` ディレクティブで わいわいタウン（https://waiwai.town）を許可しているか、そもそも設定していないこと
- 判定は登録・更新のたびにサーバーが実URLへ自動アクセスして行います（タイムアウト5秒・リダイレクト3回まで追跡。最終URLがhttpsでない、または最初のURLとオリジンが変わるリダイレクトも不可）
- itch.ioのゲームページは埋め込みできません（itch.io側が `frame-ancestors` で自ドメインのみを許可しているため）。ただしリンクとしての掲載は可能です
- スマホでの表示・操作に対応していることを推奨します（レスポンシブ・タッチ操作）
- 音声を自動再生しないこと、ページが非表示になったとき（`pagehide`・`visibilitychange`）にBGMを止めることを推奨します（他タブ・他ページに音が残り続ける事故が実際に起きています）

## 埋め込みできない場合の掲載（リンク型）

サイト内プレイの条件を満たさない場合も、リンクとして掲載できます。対応しているリンク種別：App Store・Google Play・ブラウザで遊ぶ・Robloxで遊ぶ・Steam・itch.io・公式サイト・X（公式）・その他。

## サムネイル画像の仕様

正方形 640×640px・2MBまで・PNGかJPEG。未設定の場合は頭文字のプレースホルダーで表示されます。
タイルは正方形で表示されるため正方形の画像を推奨します。長方形の画像を送っても受け付けますが、中央がクロップされて表示されます。

## 登録方法A：Webフォーム

Discordでログインし、「作品を登録する」（https://waiwai.town/submit）から登録します。
NinjaDAOのホルダーロール（CNP／CNN／Musubi）または明鏡の対象ロールをお持ちの方はそのまま登録できます。
それ以外の方は https://waiwai.town/apply から登録権限の申請ができます（作品URLと自己紹介を送るだけ。目安1〜2日でお返事します）。

## 登録方法B：AIエージェント（MCP）

わいわいタウンはMCP（Model Context Protocol）に対応しています。AIエージェントに登録作業を任せられます。
https://waiwai.town/my でAPIキーを発行し、お使いのAIエージェントに次のコマンドを伝えてください：
`claude mcp add --transport http waiwai-town https://waiwai.town/mcp --header "Authorization: Bearer <あなたのAPIキー>"`
このページ（または /llms.txt）のURLをAIエージェントに渡し、「わいわいタウンに登録して」と頼めば、以下のツールを使って登録を進められます。
- search_apps：公開中の作品を検索する
- get_app：slugで作品詳細を取得する
- list_my_apps：自分の作品一覧を見る（非表示含む・要APIキー）
- submit_app：作品を登録する（要APIキー＋登録権限）
- update_app：自分の作品を更新する（要APIキー＋登録権限＋本人）
- upload_thumb：サムネイル画像をアップロードする（要APIキー＋登録権限＋本人）
※作品の削除はWeb画面（マイページ）からのみ行えます。AIエージェントからは削除できません。

## 上限・制限

1人あたり公開中の作品は30件までです（非表示にすると枠が空きます）。
登録は1時間に5件・1日に10件までです。