AppDrift

AppDrift MCP サーバー

Claude Desktop、Cursor、または別の MCP クライアントから、AppDrift のキーワード観測結果、アカウントのアプリ、アクションプランを確認できます。掲載文を生成または翻訳し、結果を確認して、承認したフィールドを編集可能な AppDrift の下書きに適用できます。これらのツールは Apple や Google に公開しません。

このパッケージは、AppDrift REST API 用の小規模なローカル stdio クライアントです。Node.js 22 以降と AppDrift API キーが必要です。API アクセスは対象となる有料プランで利用できます。対象となる初回のサブスクリプションには、カード登録が必要な7日間のトライアルが付属します。トライアルでトークンが追加されることはありません。現在のプランとトークンの利用枠。

インストール

AppDrift を MCP クライアント（Claude Desktop、Cursor、または別の MCP クライアント）の設定に追加します。

{
  "mcpServers": {
    "appdrift": {
      "command": "npx",
      "args": ["-y", "appdrift-mcp"],
      "env": { "APPDRIFT_API_KEY": "ad_live_your_key_here" }
    }
  }
}

1. Developers ダッシュボードでキーを作成します。
2. クライアントのローカル MCP 設定にあるプレースホルダーを置き換えます。キーを共有設定やソース管理に含めないでください。
3. クライアントを再起動します。account_statusを呼び出してから、list_appsを呼び出すよう依頼します。これらの呼び出しでは AI トークンを消費しません。
4. 返されたアプリ ID を選択してから、追跡対象キーワードを取得するよう依頼します。有料アクションや保存済みの下書きへの変更を許可する前に、提案されたテキストを確認してください。

初回実行時に、npx がパッケージとその依存関係をダウンロードします。クライアントが npx を見つけられない場合は、ローカル実行ファイルの絶対パスを使用してください。

npm レジストリを利用しない場合： AppDrift は同じラッパーを、バージョン付きアーカイブとしても提供しています。args で appdrift-mcp の代わりに https://appdrift.co/downloads/appdrift-mcp-0.2.0.tgz を使用し、SHA-256 チェックサムと照合してください。アーカイブにはラッパーの完全なソースと MIT ライセンスが含まれています。server.json は公式 MCP レジストリーへの登録準備用ですが、まだ公開されていません。

ツールとコスト

追加の AI トークンは不要です： API アクセスには対象となるアカウントプランが引き続き必要です。

ツール	結果
keyword_difficulty	競合ベースの旧式の難易度／人気度ヒューリスティックです。実測されたキーワード需要やランキング確率ではありません。ストアのデータ収集は失敗したり、不完全になったりする場合があります。
list_apps	アカウントに接続されているアプリです。アプリ単位のツールで使用する ID も含まれます。
app_keywords	選択したアプリの追跡対象キーワードと、最新の観測順位です。
app_opportunities	11〜30位の追跡対象キーワードを、旧式の難易度ヒューリスティックの順に並べたものです。確認候補であり、成果の予測ではありません。
action_plan	アカウントの優先度付き ASO アクションです。
account_status	プランと残りの AI トークン残高です。
apply_optimization	保存済みのコンテンツを変更します： 承認した title、subtitle、keywords、または short_description のフィールドを、アプリの編集可能な下書きに適用します。確認とストアへの公開は別の操作です。

AI ツール： AppDrift は処理が成功した場合に課金します。返されたトークン消費量とアカウント残高を確認してください。クライアントはこれらのアクションを自動で再試行しません。

ツール	コスト	結果
optimize_for_keyword	3トークン	タイトル、サブタイトル、キーワードの変更案とその根拠です。
generate_metadata	短いフィールドは1トークン、長いフィールドは2トークン	アプリの概要に基づいて生成された掲載フィールドです。
translate_metadata	言語ごとに通常は1トークン、description は3トークン、full_description は5トークン	1つのフィールドを、異なる1〜15のロケールに翻訳します。

有料操作と apply_optimization は、MCP クライアントに書き込み操作として通知されます。タイムアウトや応答の消失があっても、サーバーが処理を停止した、または課金されていないことの証明にはなりません。再試行する前に、アカウントと下書きを確認してください。クライアントは API キーと、指定された掲載テキストを設定済みの AppDrift API に送信します。AI リクエストでは、アカウントに設定されている AI プロバイダーが使用される場合があります。

旧式の keyword_difficulty ツールは、実験的な Keyword analyzer とは別のものです。そのスコアは、順位、トラフィック、ダウンロードの増加を予測するものではありません。

設定

環境変数	必須	デフォルト
APPDRIFT_API_KEY	はい	Developers ダッシュボードで作成します。
APPDRIFT_API_BASE	いいえ	AppDrift の本番 API です。キーとリスティングテキストを預けても信頼できるエンドポイントにのみ変更してください。HTTPS が必須です。HTTP はループバック開発の場合に限り使用できます。
APPDRIFT_REQUEST_TIMEOUT_MS	いいえ	90000。許可範囲は 1000～120000 です。

クライアントはリダイレクトを拒否し、レスポンスサイズを制限し、リクエスト前にツールの入力を検証します。また、プロバイダーのエラーやスタックトレースではなく、作成者が記述したエラーメッセージを返します。これらの保護策は、バックエンドでの認可や、エージェントが提案するアクションの確認に代わるものではありません。

トラブルシューティング

• ツールが表示されない場合： Node 22 以降、npx が利用可能であること、APPDRIFT_API_KEY が空でないことを確認してください。MCP プロトコルメッセージは stdout に、起動エラーは stderr に出力されます。
• キーが無効または失効している場合： Developers で有効なキーを作成または選択し、ローカル設定を更新してください。
• トークンが不足している場合： account_status と現在のトークンのオプションを確認してください。トライアル自体ではトークンは追加されません。
• 編集可能な下書きがない場合： AppDrift でアプリの下書きを作成してから、確認したフィールドのみを適用してください。
• ストアの検索結果がない場合： 後でもう一度お試しください。スコアがないことは、競合がゼロであることを意味しません。
• 有料アクションの実行後にタイムアウトした場合： アクションを再度リクエストする前に、残高と保存状態を確認してください。

開発

ソースのチェックアウト内で、npm ci、npm test、npm run verify:package を実行します。統合チェックでは、ローカルのフィクスチャ API に対して実際の stdio プロセスを起動します。本番環境の認証情報は使用せず、トークンも消費しません。パッケージ検証では、宣言されたランタイムファイルのみをパッケージ化し、ローカルの HTTP URL 経由でクリーンなディレクトリにアーカイブをインストールして、インストール済みの実行ファイルに対して統合テストスイートを実行します。

ライセンス

MIT。詳細は LICENSE を参照してください。