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. 05JSON、テーブル、Markdown出力

活用シーン

  1. 01最近の顧客フィードバックの確認
  2. 02App 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 を調べる必要はありません。

アプリ 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?（「USA」や「GBR」などの ISO 3166-1 alpha-3 コード）。

値が nil のオプションフィールドは JSON 出力から省略されます。

reviews get — 個別のレビューを取得する
asc reviews get --review-id <REVIEW_ID> [--pretty]

注：単一取得用の API エンドポイントから親アプリの ID が返されないため、appId は空（""）になります。

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 対応