mcpField
A
ask-cli

ask-cli

github.com/dl-alexandre开发139 次安装4 周前更新
代码仓库

关于 ask-cli

ask-cli 是用于查询 App StoreKit API 的命令行工具，面向管理应用内购买和交易数据的开发者。它涵盖产品、订阅、交易、权益、通知和事件。

主要功能

  1. 01管理应用内购买产品
  2. 02查看订阅及订阅组
  3. 03查询并验证交易
  4. 04查询客户状态和权益
  5. 05列出通知与事件

适用场景

  1. 01查看应用产品的历史记录
  2. 02验证交易或办理退款
  3. 03检查客户的订阅状态
  4. 04查看近期通知或事件

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/dl-alexandre/skills --skill ask-cli

安装后在 Claude Code 中输入/ask-cli确认已加载。

详细介绍

App StoreKit CLI

使用 ask 命令行工具查询 App StoreKit API。

前提条件

ask --version
export ASK_ISSUER_ID='your-issuer-id'
export ASK_PRIVATE_KEY_PATH='/path/to/key.p8'
ask auth status

身份验证

  • App Store Connect 提供的 Issuer ID 和私钥
  • 环境变量：ASK_ISSUER_ID、ASK_PRIVATE_KEY_PATH
  • 或：使用 ask auth login 进行交互式设置

App 内购买项目

产品
ask products list --app APP_ID
ask products get PRODUCT_ID --app APP_ID
ask products history --app APP_ID --product PRODUCT_ID
订阅
ask subscriptions list --app APP_ID
ask subscriptions get SUBSCRIPTION_ID --app APP_ID
ask subscriptions groups list --app APP_ID
ask subscriptions status --app APP_ID --customer CUSTOMER_ID

交易

ask transactions history --app APP_ID --customer CUSTOMER_ID
ask transactions verify --app APP_ID --transaction-id TX_ID
ask transactions refund --app APP_ID --transaction-id TX_ID --reason "Customer request"

消耗与状态

ask consumption report --app APP_ID --date 2024-06-01
ask status --app APP_ID --customer CUSTOMER_ID --product PRODUCT_ID
ask entitlements --app APP_ID --customer CUSTOMER_ID

通知与事件

ask notifications list --app APP_ID --days 7
ask events list --app APP_ID --type SUBSCRIBED --days 30

Agent 最佳实践

  1. 客户 ID：使用匿名标识符
  2. 分页：对于大型结果集，使用 --cursor
  3. 日期范围：将查询限制在所需时间范围内
  4. 沙盒：在测试环境中使用 --sandbox

评论

支持 Markdown