ウィジェット堂 - Notion 向けウィジェット・動くアイコン・スタートページ・マイページ

はじめての%BRAND%アプリを作る

Web ページと%BRAND%の SDK で小さなアプリを作りましょう。ログイン、スパークでの支払い(50% があなたの収益)、AI、データ保存が使え、コマンドひとつで公開できます。

%BRAND%のアプリマーケットにあるアプリは、どれも普通の Web ページ(HTML / JS / CSS)と SDK でできています。ホスティングは無料。ユーザーは%BRAND%のアカウントでログインし、スパークで支払います。アプリ内で使われたスパークの 50% があなたの収益です。

1. 準備

  • デスクトップ版(ダウンロード)にはコマンドライン widgetstore が入っています。「Agents → コマンドライン」でインストールしてアカウントを接続してください。
  • インストールしなくても、デベロッパーセンターでアプリを作って zip をアップロードできます。
  • コーディングエージェント(Claude Code、Codex、Cursor、私たちの Agents)を使う場合は、まず AGENTS.md を読ませてください。

2. テンプレートから始める

widgetstore app init my-app --template sparks   # blank / sparks / ai
cd my-app
widgetstore app dev                              # http://127.0.0.1:5178/

ローカルプレビューは%BRAND%を模擬します。ユーザー、スパーク(確認画面は出ますが実際には引き落とされません)、AI はすべてダミーです。

3. マニフェストと SDK

ルートに置く widgetstore.app.json:

{ "name": "My App", "version": "1.0.0", "entry": "index.html", "icon": "icon.svg",
  "permissions": ["login", "sparks", "storage"], "network": [] }

ページで https://widgetstore.net/apps/sdk/v1.js を読み込み、次のように使います。

await ws.ready();                                   // 言語、テーマ
const { user } = await ws.login();                  // ニックネーム、アイコン、このアプリだけで有効な匿名 ID
await ws.sparks.charge({ amount: 50, reason: 'プレミアムテーマを解放' });  // ユーザーが確認してから支払い
const { text } = await ws.ai.run({ prompt: 'おはようの一言を書いて' });    // 使用量に応じてユーザーのスパークから
await ws.storage.set('notes', ['…']);              // ユーザーごとのデータ(最大 512 KB)

アプリは独立した安全なサンドボックスで動き、ユーザーの%BRAND%のログイン情報やほかのデータにはアクセスできません。外部サイトに接続するときは、そのドメインを network に書いてください(最大 5 個、審査で確認します)。

アプリのファイルはアプリごとの専用アドレス https://<slug>.youos.link から配信されます(%BRAND%とも、ほかのアプリとも別のサイトです)。ユーザーはこれまでどおり widgetstore.net/apps/<slug> からアプリを開きます。そのため slug に使えるのは英小文字・数字・単独のハイフンだけで、ハイフンで終わる名前や、www・mail・cdn のようなサービス名に見えるものは使えません。

4. 公開

widgetstore app publish --slug my-app   # 初回:アプリを作成(widgetstore.net/apps/my-app)
widgetstore app publish                 # 2 回目以降:新しいバージョン

どのバージョンも自動チェック(マニフェスト、ファイルの種類、サイズ、不審なコード)を受けます。初めての掲載と権限の変更は担当者が審査し、通常 1 日以内に終わります。承認されると自動で公開され、デベロッパーセンターから段階リリースやロールバックができます。

5. 収益と出金

  • 支払いのたびに 50% があなたの取り分です。購入したスパークで支払われた分は出金でき、ログインボーナスなど無料のスパークで支払われた分は記録のみです。自分のアプリへの支払いは分配されません。
  • 収益は 30 日間保留されます(その間はユーザーに返金できます)。500,000 スパーク(約 50 ドル)から出金を申請でき、担当者が確認して手動で送金します。

ルール

%BRAND%やほかのブランドになりすまさないこと、パスワード・カード番号・確認コードを求めないこと、スパークを使ってもらう前に何が得られるかをはっきり書くこと。ユーザーのデータを保存する場合はプライバシーポリシーを用意してください。ルールに違反したアプリは公開を停止します。

最終更新:2026年11月19日