AppDrift

本地服务

appdrift.co商业与营销04 周前更新

关于 AppDrift

AppDrift MCP Server 是连接 AppDrift REST API 的本地 stdio 客户端，供应用团队查看关键词观察、应用数据和 ASO 行动计划。它可生成或翻译商店文案，并将审核通过的字段写入可编辑草稿，但不会发布到应用商店。

主要功能

01查看应用及追踪关键词排名
02查看关键词机会与 ASO 行动计划
03生成或翻译商店列表文案
04将审核通过的字段应用到草稿
05查询账户方案与 AI Token 余额

适用场景

01检查应用追踪关键词的最新排名
02为应用商店列表起草或翻译文案
03将审核后的优化字段保存到草稿
04执行付费 AI 操作前查看 Token 余额

MCP 相关

该本地 stdio 客户端将 AppDrift REST API 功能作为工具提供给 MCP 客户端。使用需要 AppDrift API 密钥；工具不会将文案发布到 Apple 或 Google。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "blaze-apps-appdrift": {
      "command": "npx",
      "args": [
        "-y",
        "appdrift-mcp"
      ],
      "env": {
        "APPDRIFT_API_KEY": "<APPDRIFT_API_KEY>"
      }
    }
  }
}

启动命令npx -y appdrift-mcp

需要配置的环境变量

APPDRIFT_API_KEY密钥API key from the AppDrift Developers dashboard. API access requires a paid plan.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmappdrift-mcp0.2.1stdio

工具

收录的工具列表 · 更新于 3 周前

参数	类型	必填	说明
country	string	否	两位字母的国家/地区代码（例如 us、gb、de）。默认值为 us。
keyword	string	是	要评分的关键词或短语。
platform	enum	否	要评估的商店。默认值为 ios。ios \| android

详细介绍

AppDrift MCP 服务

通过 Claude Desktop、Cursor 或其他 MCP 客户端查看 AppDrift 关键词观察数据、账户应用和行动计划。生成或翻译应用商店文案、审核结果，并将接受的字段应用到可编辑的 AppDrift 草稿中。这些工具不会向 Apple 或 Google 发布内容。

此软件包是一个小型本地 stdio 客户端，用于调用 AppDrift REST API。它需要 Node.js 22 或更高版本以及 AppDrift API 密钥。符合条件的付费套餐可使用 API。符合条件的首次订阅可享受七天试用，但需要绑定银行卡；试用不会增加令牌。查看当前套餐和令牌额度。

安装

将 AppDrift 添加到 MCP 客户端（Claude Desktop、Cursor 或其他 MCP 客户端）的配置中：

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

在开发者控制面板中创建密钥。
在客户端的本地 MCP 配置中替换占位符。请勿将密钥放入共享配置或源代码管理中。
重启客户端。让它调用 account_status，然后调用 list_apps。这些调用不会消耗 AI 令牌。
在请求其跟踪的关键词之前，先选择返回的应用 ID。允许执行付费操作或更改已保存的草稿前，请先审核拟议文本。

首次运行时，npx 会下载此软件包及其依赖项。如果客户端找不到 npx，请使用其本地可执行文件的绝对路径。

不使用 npm registry： AppDrift 也提供相同封装程序的版本化归档文件。在 args 中使用 https://appdrift.co/downloads/appdrift-mcp-0.2.0.tgz 替代 appdrift-mcp，并使用其 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–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`。

客户端会拒绝重定向、限制响应大小、在发送请求前验证工具输入，并返回编写好的错误消息，而非提供商错误或堆栈跟踪。这些防护措施不能替代后端授权，也不能替代对 Agent 提议操作的审核。

故障排除

没有工具： 确认 Node 22+、npx 可用，并且 APPDRIFT_API_KEY 非空。MCP 协议消息使用 stdout；启动错误使用 stderr。
密钥无效或已撤销： 在 Developers 中创建或选择一个有效密钥，并更新本地配置。
令牌不足： 查看 account_status 和当前的令牌选项。试用本身不会增加令牌。
没有可编辑的草稿： 在 AppDrift 中创建应用的草稿，然后仅应用你审核过的字段。
没有商店结果： 稍后重试。缺少评分不代表竞争为零。
付费操作超时： 再次请求该操作前，先检查余额和保存状态。

开发

在源代码检出目录中，运行 npm ci、npm test 和 npm run verify:package。集成检查会启动实际的 stdio 进程，并对接本地模拟 API；它们不会使用生产凭据或消耗令牌。软件包验证仅打包声明的运行时文件，通过本地 HTTP URL 将归档安装到干净目录中，并针对已安装的可执行文件运行集成测试。