開発者向けガイド

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

わいわいタウンは、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件までです。