mcpField
A
asc-customer-reviews

asc-customer-reviews

github.com/tddworks营销与增长583 次安装5 周前更新
代码仓库

关于 asc-customer-reviews

asc-customer-reviews 是用于读取 App Store 客户评价和管理开发者回复的命令行技能。它支持列出和获取评价、提交回复及删除回复，JSON 输出还提供后续操作命令。

主要功能

  1. 01按应用列出评价
  2. 02获取单条评价
  3. 03创建评价回复
  4. 04删除已有回复
  5. 05支持 JSON、表格和 Markdown 输出

适用场景

  1. 01查看近期客户反馈
  2. 02回复 App Store 评价
  3. 03替换已提交的回复
  4. 04按地区检查评价数据

安装

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

$npx skills add https://github.com/tddworks/asc-cli-skills --skill asc-customer-reviews

安装后在 Claude Code 中输入/asc-customer-reviews确认已加载。

详细介绍

使用 asc 查看客户评价并管理评价回复

查看 App Store 商品页上的客户评价，并管理开发者回复——回复反馈、修改回复或删除回复。

身份验证

执行任何评价相关命令前，请先设置凭据：

asc auth login --key-id <id> --issuer-id <id> --private-key-path ~/.asc/AuthKey.p8

CAEOAS — 按照引导采取下一步操作

每个 JSON 响应都包含可直接运行的命令 "affordances"：

CustomerReview 可直接执行的命令：

{
  "id": "rev-001",
  "appId": "123456789",
  "rating": 5,
  "title": "Great app!",
  "body": "Love using this app every day.",
  "reviewerNickname": "user123",
  "territory": "USA",
  "affordances": {
    "getResponse": "asc review-responses get --review-id rev-001",
    "respond": "asc review-responses create --review-id rev-001 --response-body \"\"",
    "listReviews": "asc reviews list --app-id 123456789"
  }
}

CustomerReviewResponse 可直接执行的命令：

{
  "id": "resp-001",
  "reviewId": "rev-001",
  "responseBody": "Thank you for your feedback!",
  "state": "PUBLISHED",
  "affordances": {
    "delete": "asc review-responses delete --response-id resp-001",
    "getReview": "asc reviews get --review-id rev-001"
  }
}

直接复制可执行命令即可，无需查找 ID。

确定 App ID

请参阅 project-context.md——在询问用户或运行 asc apps list 前，先检查 .asc/project.json。

命令

reviews list — 列出应用的所有评价
asc reviews list --app-id <APP_ID> [--pretty] [--output table|markdown]

返回的评价按时间从近到远排序。字段：id、appId、rating（1-5）、title?、body?、reviewerNickname?、createdDate?、territory?（ISO 3166-1 alpha-3 代码，例如 "USA"、"GBR"）。

JSON 输出中会省略值为 Nil 的可选字段。

reviews get — 获取单条评价
asc reviews get --review-id <REVIEW_ID> [--pretty]

注意：appId 将为空（""），因为单条 GET API 端点不会返回父级应用 ID。

review-responses get — 获取评价回复
asc review-responses get --review-id <REVIEW_ID> [--pretty]

使用评价 ID（而非回复 ID）获取关联的回复。

review-responses create — 回复评价
asc review-responses create --review-id <REVIEW_ID> --response-body "Thank you for your feedback!"

新回复初始状态为 PENDING_PUBLISH——约 24 小时内会发布。

review-responses delete — 删除回复
asc review-responses delete --response-id <RESPONSE_ID>

如需修改回复，请先删除现有回复，再创建新回复。

典型工作流

APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')
# If empty: ask user or run `asc apps list | jq -r '.data[0].id'`

# 1. List reviews for the app
asc reviews list --app-id "$APP_ID" --output table

# 2. Read a specific review in detail
asc reviews get --review-id rev-001 --pretty

# 3. Check if there is already a response
asc review-responses get --review-id rev-001

# 4. Respond to the review
asc review-responses create \
  --review-id rev-001 \
  --response-body "Thank you! We fixed the crash in v2.1."

# 5. To revise, delete and recreate
asc review-responses delete --response-id resp-001
asc review-responses create \
  --review-id rev-001 \
  --response-body "Updated response with more detail."

回复状态

状态含义
PUBLISHED回复已在 App Store 上发布
PENDING_PUBLISH回复已提交，等待发布（最长 24 小时）

语义布尔值：isPublished、isPending。

输出标志

--pretty          # Pretty-print JSON
--output table    # Table format
--output markdown # Markdown table

评论

支持 Markdown