AppKittie — 面向 AI 代理的 App Store 情报平台

完整 API 文档： www.appkittie.com/docs

将 Cursor、Claude Code 或任何兼容 Agent Skills 的助手，转变为 App Store 研究伙伴：涵盖应用发现、ASO（应用商店优化）、竞品分析、增长洞察、营收估算与广告情报——全部由 AppKittie API 提供实时数据支持（覆盖 200 万+ iOS 应用，含营收/下载估算、增长窗口期及广告信号）。

安装技能（Skills）

当前主流编程代理从本地磁盘加载 Agent Skills：每个技能为一个文件夹，内含 SKILL.md（及可选配套文件），需置于工具默认查找路径下，常见路径包括 .cursor/skills/、.claude/skills/、.agents/skills/ 或 .codex/skills/。安装方式有三种：手动 复制 文件夹、通过远程规则 订阅（仅 Cursor 支持），或使用 CLI 工具从 GitHub 拉取（Claude Code 支持）。

Claude Code — 官方安装器；自动下载本仓库并注册所有技能：

npx skills add appkittie/mcp

仅安装指定技能：

npx skills add appkittie/mcp --skill keyword-research competitor-analysis

若已克隆本仓库：执行 cp -r mcp/skills/* .claude/skills/

Cursor — 打开 设置（⌘⇧J）→ Rules → Add Rule → 选择 Remote Rule (GitHub) → 输入地址：https://github.com/appkittie/mcp；或 手动复制技能至本地：

其他任意 Agent — 克隆仓库后，按客户端文档要求将 skills/ 目录指向对应路径：

git clone https://github.com/appkittie/mcp.git
cp -r mcp/skills/* .cursor/skills/   # 或 .claude/skills/, .agents/skills/, .codex/skills/

安装 MCP 服务器

技能定义了如何围绕 App Store 工作进行推理；MCP 则暴露了面向 AppKittie 的实时工具（如 search_apps、关键词相关接口等）。请先在 appkittie.com/settings/api-keys 创建 API 密钥（密钥仅在创建时显示一次，请立即复制保存）。

Claude Code — 注册托管式服务器（HTTP 传输 + Bearer 认证）：

claude mcp add appkittie --transport http https://mcp.appkittie.com --header "Authorization: Bearer YOUR_API_KEY"

请将 YOUR_API_KEY 替换为您的实际密钥。

Cursor 及其他 MCP 客户端 — 在应用的 MCP 配置中使用相同 URL 与 Authorization: Bearer … 请求头。示例 JSON 如下：请将下方 MCP 服务器配置接入您的环境。

您将获得的能力

技能支持组合调用：例如 competitor-analysis 可能引导至 keyword-research，再进一步触发 metadata-optimization 执行落地。

接入 MCP 服务器

部署于 Cloudflare 的工作节点负责将请求转发至 AppKittie 后端。Claude Code 用户可通过上方 claude mcp add 命令完成注册；其余用户（如 Cursor）通常需手动粘贴如下配置：

1. 创建 API 密钥：访问 appkittie.com/settings/api-keys（密钥仅显示一次，请立即复制）。
2. 注册服务器：

{
  "mcpServers": {
    "appkittie": {
      "url": "https://mcp.appkittie.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

MCP 工具列表

MCP 提示词（Prompts）

技能目录

情报与定位

增长、营收与广告

共享上下文

示例提示语与命令

自然语言指令（技能安装完成后即可使用）：

• “列出营收最高的健康与健身类应用。”
• “为一款冥想类应用生成美国市场关键词集，并按机会度排序。”
• “对应用 ID 1234567890 进行竞品分析。”
• “近期哪些公司在生产力类应用上投放 Meta 广告？”
• “本周增速最快的应用有哪些？”
• “基于以下关键词，分别重写标题与副标题，各提供三个版本。”
• “记录我的营销上下文，确保后续对话保持一致性。”
• “教育类应用的大致营收区间是多少？谁占据该区间的头部？”

斜杠式快捷入口：/app-discovery、/keyword-research、/metadata-optimization、/competitor-analysis、/growth-analysis、/ad-intelligence、/revenue-analysis。

代理典型运行流程

1. 加载对应 SKILL.md（含模板、安全约束与输出格式规范）。
2. 通过 MCP 工具或原生 HTTP 调用 AppKittie：例如以 category 和 sortBy: revenue 参数调用 search_apps，或对种子词列表调用 batch_keyword_difficulty，再对筛选出的关键词调用 get_keyword_difficulty。
3. 合成结构化输出：生成表格、核心结论与下一步行动建议，而非原始 JSON 数据。

REST API 快速参考

基础地址： https://appkittie.com/api/v1
认证方式： Authorization: Bearer —— 与控制台共用同一套密钥。

curl -sS "https://appkittie.com/api/v1/apps?search=fitness&limit=5" 
  -H "Authorization: Bearer YOUR_API_KEY"

路由与计费说明

响应数据结构

成功响应主体使用顶层 data 字段。列表类响应支持游标分页：

{
  "data": [{ "title": "Calm", "score": 4.8, "downloads": 85000 }],
  "pagination": { "nextCursor": 50, "totalCount": 12450 }
}

通过添加查询参数 cursor= 获取下一页；当 nextCursor 为 null 时表示已无更多结果。

GET /api/v1/apps 过滤参数（AND 组合）

完整参数矩阵详见：tools/REGISTRY.md。

cURL 示例

高营收健身类应用切片：

curl -sS "https://appkittie.com/api/v1/apps?search=fitness&categories=Health+%26+Fitness&minRevenue=10000&sortBy=revenue&sortOrder=desc&limit=10" 
  -H "Authorization: Bearer YOUR_API_KEY"

批量关键词分析（美国商店）：

curl -sS -X POST "https://appkittie.com/api/v1/keywords/difficulty" 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"keywords":["meditation","sleep tracker","mindfulness","breathing exercises","yoga"],"country":"US"}'

积分与响应头

• 应用列表： 每返回 1 行结果消耗 1 点积分；若账户余额低于请求的 limit，API 将自动截断响应页。
• 应用详情： 每次调用消耗 1 点积分。
• 关键词（单次）： 每次调用消耗 10 点积分。
• 关键词（批量）： 每个返回数据的关键词消耗 10 点积分；重复关键词在计费前自动去重。

所有响应均可能包含 X-Credits-Used 与 X-Credits-Remaining 头部字段。账户余额亦可在 API Keys 页面查看。

速率限制

按密钥粒度限制，采用 60 秒滑动窗口。关键响应头如下：

返回 429 状态码时，响应中会包含重试时间信息，请退避或等待。

错误响应

JSON 响应体中包含 error 字段；校验失败时额外提供 details 字段（按字段逐条说明）。

可预期字段

• 列表项字段： 标题、图标、开发者、分类、评分、评论数、下载/营收估算（如最近 30 天营收）、多周期增长数据、上架/更新时间戳。
• 详情字段： 包含以上全部字段，外加描述文案、截图、版本历史、IAP 商品目录、Meta 广告创意（素材、文案、状态、时间）、按国家/地区划分的 Apple Search Ads 投放情况、创作者合作信息、联系方式线索、社交账号、招聘标识、以及排名/评论/营收/下载的历史序列数据。
• 关键词字段： 热度与难度（0–100 分）、竞争应用数量、流量分（0–100 分）、头部应用片段（标题、图标、评论数、评分、排名）。

许可证

MIT