料金
X Bot はほとんどのコミュニティにとって無料です。利用量の多いユーザーには2つのパスがあります — クレジットカードの サブスクリプション（継続課金、月間投稿数がおよそ1,000件以上のチャットで割安）または ETH の クレジットパック（一括購入、無期限）。この2つはきれいに併用できます。1クレジット = API から返される X 投稿1件。
要約 — まず FREE で始める（月100投稿、カード不要）。使い切ったら：Stripe でサブスクリプション（月19ドル、最初の1,000投稿は無料、以降は1投稿あたり0.02ドルの従量課金）、または ETH クレジットパックを購入（1クレジット0.02ドル、1,000〜100,000のパック、無期限）。この2つはきれいに併用できます — 1つのチャットは ETH クレジット と Stripe サブスクリプションの両方を保有できます。取得ごとの課金はまず ETH クレジットを消費し、次にサブスクリプションの月間付与分、その後は従量課金となります。
購入・アップグレードは3タップで：/setup → 💳 クレジット購入
購入フロー全体が Telegram 内で完結します。料金や残高の確認のためにボットを離れる必要は一切ありません。
チャットから
/setup→ 💳 クレジット購入 を開きます。- 💰 クレジット購入・アップグレード をタップします。
- ボットは支払いオプションカードで応答します。表示されるオプションは現在のプランによって異なります：
| 現在のプラン | 表示されるオプション |
|---|---|
| FREE | 両方 — Stripe サブスクリプション または ETH クレジットパック |
| PRO・クレジット（既存の ETH 残高あり） | 両方 — ETH での追加購入を続けるか、その上に Stripe サブスクリプションを重ねる（ETH クレジットは残り、取得のたびに先に消費されます） |
| PRO・サブスクリプション（既存の Stripe サブスクリプションあり） | カード管理への引き継ぎ — すでに従量課金プランのため、追加購入は不要 |
- パスを選びます：
パス A — Stripe サブスクリプション（FREE チャット → PRO サブスクリプション）
- 💳 クレジットカードで支払う をタップします。
- ボットは Stripe Checkout セッションを作成し、チェックアウトリンクのボタンで応答します。
- ボタンをタップすると、ブラウザで Stripe Checkout が開きます。
- カード情報を入力し、支払いを完了させます。
- Stripe が Telegram に戻します（
https://t.me/BWS_X_Bot?start=payment_success_<chatId>）。 - Stripe の webhook が数秒以内にボットのアクティベーションハンドラーを起動します —
/setup→ 💳 クレジット購入 にPRO ✓（サブスクリプション）と表示されます。 - ボットはチャットの指定管理者に DM でアクティベーション完了を通知します。
請求される内容：
- サブスクリプションが有効な間、毎月 19ドルの基本料金（翌月の初日に請求、以降は日割り）。
- 当月に取得された投稿のうち、1,000件を 超えた 分について 1投稿あたり0.02ドル — Stripe による従量課金で、その月の請求書に追加されます。
- 毎月最初の1,000投稿は基本料金に含まれます — これは 無料しきい値 であり、繰り越し可能なクレジット残高ではありません。
いつでも解約可能 — /setup → 💳 クレジット購入 → 🛠 サブスクリプション管理 で Stripe カスタマーポータルが開きます。解約は現在の支払い期間の終了時に反映されます。それまでは同じ従量課金ルールのまま PRO を維持します。
パス B — ETH クレジットパック（FREE → PRO・クレジット、または PRO・クレジット → 追加購入）
🪙 ETH で支払う をタップします。
ボットは短時間有効な購入セッションを作成し、約15分間有効なリンクボタンで応答します。
タップすると、ブラウザで
xbot.ninja/buy-ethereum.htmlが開きます。ウォレット（MetaMask、WalletConnect など）を接続します。
ドロップダウンからクレジットパックを選びます：
パックサイズ 価格（USD） 1 000 クレジット $20 2 000 クレジット $40 3 000 クレジット $60 4 000 クレジット $80 5 000 クレジット $100 10 000 クレジット $200 50 000 クレジット $1 000 100 000 クレジット $2 000 ページは現在のスポットレートに基づく ETH 換算額を表示します。
トランザクションに署名します。資金は Ethereum メインネット上の BWS トレジャリーコントラクトに送られます。
オンチェーンの確認が完了すると、バックエンドがチャットにクレジットを付与します。
/setup→ 💳 クレジット購入 でCredits remaining: <balance>として確認できます。
請求される内容：継続課金は一切ありません。パックごとに1回支払うだけで、支払い方法は ETH のみです。
後から追加購入：同じフローです — 同じドロップダウンから別のパックを選びます。既存のクレジットに新しいパックの分が加算されます。クレジットは無期限です。
パス A とパス B はきれいに併用できます
1つのチャットは 両方 を同時に保有できます。取得ごとの課金は、次の順序でバケットを消費します：
- まず ETH クレジット（
LICENSES.REMAINING_CREDITSのアトミックな減算）。 - サブスクリプションの月間付与分（PRO・サブスクリプションでの無料1,000投稿）。
- Stripe の従量課金による超過分（付与分を超えた分は1投稿あたり0.02ドル）。
5,000の ETH クレジットを持った状態でサブスクリプションに登録した場合、次の5,000回の取得はクレジットを消費します（Stripe への課金なし）。5,001〜6,000回目の取得はサブスクリプションの月間付与分を使用します。6,001回目以降は従量課金となります。ETH 残高はアップグレード後も維持されます。
残る唯一の制約：すでに PRO・サブスクリプションのチャットは、現時点では ETH パックを 追加 できません（購入フローがブロックします）。クレジットのみの課金に切り替えたい場合は、まずサブスクリプションを解約してください。
購入後
クレジット残高とプランはいつでも確認できます：
/setup → 💳 Buy Credits
💳 Buy Credits & Plan
Plan: PRO ✓ (credits)
Credits remaining: 4 152
Total purchased: 5 000
[💰 Buy credits / upgrade]
[🛠 Manage subscription]
[📊 Usage this month]（Stripe サブスクリプションのチャットでは、Plan: PRO (subscription) ✓ と表示され、クレジット残高はありません — 利用量は保存されたカウントから差し引かれるのではなく、従量課金として計測されます。📊 今月の利用状況 では、従量課金のしきい値を左右する fetched_posts の累積カウンターが表示されます。）
プラン一覧
| FREE | PRO サブスクリプション | PRO クレジット（ETH） | |
|---|---|---|---|
| 継続コスト | $0 | $19 / month | $0 |
| 投稿単価 | なし — 月100件のハードキャップ | 最初の1,000件/月は$0、それ以降は1投稿あたり0.02ドル（従量課金） | 一律 1クレジットあたり0.02ドル |
| クレジット残高 | なし — STATS カウンターのみ | なし — STATS カウンター + Stripe メーター | REMAINING_CREDITS 台帳 |
| カードが必要か | 不要 | 必要（Stripe checkout） | 不要（ETH ウォレット） |
| 自動更新 | なし | 毎月、いつでも解約可能 | なし（一括購入） |
| クレジットの有効期限 | 毎月100にリセット | なし | 無期限 |
| 枯渇時の挙動 | ボットが取得を停止、管理者に DM | なし（無制限、課金されるだけ） | 自動的に FREE にダウングレード、ボットが月100件の上限を再適用 |
| 向いている用途 | お試しグループ、小規模コミュニティ、ソロ KOL | 安定した本番コミュニティ、予測可能な月間投稿量 | 突発的／単発／クリプトネイティブなチーム。無期限予算としてのクレジット |
クレジット計算、正直な話
1クレジット = API から返される X 投稿1件。 フィルターがデイリーレポートで47件の投稿を取得した場合、47クレジットが引き落とされる（PRO・クレジット）か、当月のしきい値（PRO・サブスクリプション）または月100件の上限（FREE）に対して47件がカウントされます。
カウントされるもの：
- X API 呼び出しで返される個別のツイートはすべてカウントされます。たとえ話題から外れて取得後に除外された場合でも同様です。
- X 投稿自動リレーのポーリングは、ほとんどのティックで0件（無料）を返し、実際に投稿があったティックでは1〜10件を返します（転送された投稿1件につき1クレジット）。
- 引用ツイートもカウントされます：X API には
exclude=quotesがないため、ボットは引用ツイートを取得してからクライアント側でフィルタリングします。チャットのノイズは減らせますが、クレジットは節約できません。
カウントされないもの：
- サーバー側の
exclude=retweets/exclude=replies— これらの投稿は API から返されないため、何も引き落とされません。 - データを返す前に 4xx エラーになった失敗した取得。
/setup→ 📊 レポート → 📰 前回のレポート表示 で再提供されるキャッシュ済みの投稿。
月間必要量の見積もり
よくあるパターン：
| パターン | 投稿量 | 最適なプラン |
|---|---|---|
| ソロアカウントのポートフォリオ、1日1〜2投稿 | 月約50投稿 | FREE |
| 小規模コミュニティ、30フォロワー、軽度の $TOKEN トラフィック | 100〜300 | FREE — またはたまのスパイク月には1,000クレジットの ETH パック（20ドル） |
| 5人 KOL のエージェンシー、24時間デイリーレポート + 話題関連のみ | 800〜1,500 | FREE と PRO・サブスクリプションの境界。定期的に1,000を超えるならサブスクリプション、単発の月なら ETH パック |
| 大規模プロジェクト、ハッシュタグキャンペーン、投稿者50人以上 | 3,000〜8,000 | PRO・サブスクリプション：19ドル +（0.02ドル × 約5,000超過分）≈ 月119ドル — 予測可能 |
| 重い自動リレー（5アカウント × 1日5投稿 × 30日） | リレーだけで月750 | リレーのみなら：他が軽ければ FREE のまま。レポートも併用するなら：PRO・サブスクリプション。 |
どちらを選ぶべきか
FREE のままにする
- コミュニティの月間話題関連投稿が100件以下。
- ソロ KOL のポートフォリオ（アカウント1つ、低頻度）。
- コミットメントなしで製品を評価中。
- テスト／ステージング用のグループ。
PRO サブスクリプション（月19ドル）へ移行
- 安定した本番コミュニティ — 予測可能な月間投稿量。
- 複数のキャンペーンや名前付きフィルターを同時運用 — ETH パックを繰り返し購入するより、従量課金でスパイクを吸収する方が簡単。
- アクティブな KOL エージェンシー — 多数のクライアント向けにデイリーレポート。
- クレジット残高について考えたくない — 「使った分だけ請求してほしい」。
ETH クレジットパックを購入する
- 突発的：ローンチ／コンテスト／キャンペーン期間中にスパイクし、その後落ち着く場合。
- 単発プロジェクト — 5,000クレジットを購入し、N か月かけて使用。
- オンチェーン決済を好み、継続的なカード認証を避けたいクリプトネイティブなチーム。
- 継続的なカード請求を禁止するコンプライアンス／会計上の要件がある場合。
- 無期限の予算：今日購入したクレジットは1年後でも使用可能。
- 上限付きの契約 — 「クライアントがこのキャンペーンを400ドルに上限設定、超過なし」：20,000のパックを購入し、残高がゼロになったら確実に停止。
請求に関する FAQ
Q. 同じチャットで Stripe サブスクリプションと ETH クレジットの両方を持てますか？はい — 併用できます。Stripe でサブスクリプションに登録した PRO・クレジットのチャットは、ETH 残高を維持したままです。取得ごとの課金はまず ETH 残高を消費し、次にサブスクリプションの月間付与分、その後は残りを従量課金します。現時点での唯一の制約：すでにアクティブな Stripe サブスクリプションのあるチャットは、同じフローで ETH パックを 追加 できません（buy.mjs が2回目の購入をブロックします）。クレジットのみに戻したい場合は、まずサブスクリプションを解約してください。
Q. PRO・クレジットの残高がゼロになるとチャットはどうなりますか？ ライセンスは自動的に FREE にダウングレードします。次回の取得は月100投稿の上限の対象になります（当月の FREE プランのカウンターがそのまま引き継がれます）。次に /buy を実行すると、ボットは再び Stripe と ETH の両方のオプションを提示します。
Q. PRO・サブスクリプションで月1,000投稿を超えるとどうなりますか？ 従量課金になります。1,000のしきい値を超えた投稿ごとに Stripe へ record_usage の呼び出しが送られ、次回の月次請求書に 0.02ドル × 超過分 が含まれます。ハードキャップも予期しない停止もありません — ボットは取得を続け、請求額が増えていきます。
Q. クレジットはチャットごとですか、ユーザーごとですか？ チャットごとです。各 Telegram グループは独自の残高とライセンスを持ちます。ボットを2つ目のグループに追加すると、2つ目の FREE 月100件の割り当てが得られます。
Q. 1つのサブスクリプションを複数のチャットで共有できますか？ いいえ — 各チャットは独自の Stripe 顧客とサブスクリプションを持ちます。
Q. クレジットは月をまたいで繰り越されますか？
- FREE：いいえ、毎月新たに100件になります。未使用の100件分は蓄積されません。
- PRO・サブスクリプションの1,000件込み分：いいえ — しきい値は請求サイクルごとにリセットされます。
- ETH で購入したクレジット：はい、無期限です。3月に購入したパックの残りは11月でも残っています。
Q. クレジットを購入したのに残高が変わりません
- Stripe：webhook は通常数秒以内に発火します。5分以上経ってもクレジットが反映されない場合は、Stripe の領収書とチャット ID（
/setup→ ℹ️ 情報）を添えてサポートに連絡してください。 - ETH：オンチェーンの確認には1〜3分かかることがあります。10分経ってもクレジットが表示されない場合は、トランザクションハッシュとチャット ID を添えてサポートに連絡してください。
Q. 返金してもらえますか？ 未使用のサブスクリプション期間については：可能です、サポートに連絡してください — 日割りで返金します。すでに一部消費されたクレジットパックについては：ケースバイケースですが、一般的にボットが明らかに誤動作していた場合に限られます。ETH での購入は、トランザクションが確定すると返金不可です（プロトコル上、取り消しはできません）。
Q. 管理画面の「生涯支払い合計」が自分の領収書と一致しません Stripe はサブスクリプションと課金でグループ化の方法が異なります。管理画面は 成功した課金 + 支払い済みの請求書 を合計しています。ETH での購入は含まれません（Stripe ではなくオンチェーンのトレジャリーで追跡されるため）。返金は差し引かれません（別途フラグが立ちます）。監査証跡が必要な場合は、Stripe ダッシュボード → 顧客 → チャット ID で検索してください。
Q. 月の途中でサブスクリプションを解約しました — いつ PRO でなくなりますか？ 現在の請求期間の終了時です。Stripe は cancel_at_period_end: true を設定し、ボットの webhook は期間終了時に発火する実際の解約イベント（customer.subscription.deleted）でライセンスを FREE に戻します。
Q. PRO の無料トライアルはありますか？ FREE プランがトライアルの役割を果たします。月100投稿は評価用として十分な量です。テスト中に使い切った場合、最小の ETH パック（1,000クレジット = 20ドル）が最も安価な延長方法です。
次に読むもの
- インストール — 3ステップでチャットを稼働させる。
- /setup メニュー — サブスクリプション画面の詳しいツアー。
- トラブルシューティング — 請求関連の症状別マトリクス。
- サポート — エスカレーションテンプレートと応答 SLA。
各料金プランが対応するユースケース（KOL エージェンシーの追跡、コミュニティエンゲージメント、ソロ KOL のポートフォリオ、マルチクライアントエージェンシー）については、製品概要 をご覧ください。