SuperAPI AI 工具集

appmate-setup

通用与其它

查看项目

更新于 10-15 21:41

技能介绍

用途:为 AppMate 插件安装、配置和自检 App Store Connect API 凭据,是整个插件的基础设施,其他 AppMate 工作流都依赖此处配置的凭据。

主要能力:把凭据写入被 gitignore 的 config/ 目录,通过 scripts/asc_client.py 调用;关键词热度/难度来自插件自带的静态参考表 data/keyword_reference_<region>.json,无需额外配置;竞品数据由 competitor-research 技能在本地生成(iTunes Search SERP 重叠,无远程服务)。数据源为 Apple App Store Connect API,提供元数据、销售与下载报告、内购与订阅、评论、构建等信息。

安全限制:AppMate 是只读分析工具,API 密钥不得含任何可写角色。允许的角色为 Sales、Access to Reports、Customer Support、Marketing;禁止 Admin、Developer、App Manager、Finance。scripts/key_safety.py 在启动时探测,scripts/asc_client.py 默认拦截所有非 GET 请求,除非设置 APPMATE_ALLOW_WRITES=1。已知局限:App Manager 无法通过 GET 端点区分,靠角色选择指引与写操作拦截弥补。

使用方式:用户在 App Store Connect 生成密钥并下载 .p8 放入 config/;向 Claude 提供 issuer_id、key_id、.p8 文件名、vendor_number,由 Claude 写入 config/credentials.txt 并执行 pip install -r requirements.txt。自检命令:python3 scripts/appmate_config.py check;python3 scripts/asc_client.py token | head -c 30 && echo "...";以及调用 apps() 列出应用。检查 0 为通用闸门,未通过须吊销密钥重建并删除 data/key_safety.json 后重跑。

适用场景:安装、配置或自检 AppMate,设置 App Store Connect 凭据。限制:需用户本机放置 .p8 文件;analyticsReportRequests POST 在未开启 App Analytics 共享时返回 403;perfPowerMetrics 仅支持 iOS。