mcpField
P
pgyer

pgyer

github.com/pgyerクラウド・DevOps156 回インストール23 週間前に更新
リポジトリ

pgyer について

pgyerは、iOS、Android、HarmonyOSのビルドをPGYERにアップロードし、アプリ情報や配布手順を扱うスキルです。タスクに応じて公式MCPサーバー、同梱のシェルスクリプト、API呼び出しを使い分けます。

主な機能

  1. 01IPA、APK、HAPビルドのアップロード
  2. 02アプリ一覧と詳細の確認
  3. 03タスクに応じたMCP・シェル・APIの選択
  4. 04CI/CD設定の案内
  5. 05アップロード認証情報の安全な管理

活用シーン

  1. 01モバイルアプリのテスト版配布
  2. 02アプリのバージョンとインストールリンクの確認
  3. 03CIパイプラインからのビルド公開

MCP 対応

利用可能な場合、アップロード、アプリ一覧、ショートカット検索にはPGYER公式MCPサーバーを優先します。MCPツールで必要なパラメーターや詳細を扱えない場合は、同梱のシェルスクリプトまたはHTTP APIを使います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pgyer/pgyer-skill --skill pgyer

インストール後、Claude Code で/pgyerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
LICENSE
install.sh
CHANGELOG.md
README.md
docs/
use-with-other-agents.md
examples/fastlane/
README.md
examples/github-actions/
android.yml
harmony.yml
ios.yml
examples/gitlab-ci/
android.yml
ios.yml
references/
api-cheatsheet.md
mcp-tools.md
troubleshooting.md
scripts/
UPSTREAM-README.md
pgyer_upload.sh
README.md
tests/
scenarios.md

詳細

PGYER（蒲公英）— 公式スキル

PGYER（https://www.pgyer.com）は、中国を代表するiOS／Android／HarmonyOS向けベータ配布サービスです。このスキルを使うと、ビルドのアップロード、インストールリンクの取得、アプリメタデータの確認、PGYERとのCI/CD連携ができます。

このスキルの構成

このスキルは、PGYERの公式MCPサーバーがインストールされている場合はそれを優先し、そうでない場合は同梱の公式シェルスクリプトにフォールバックします。どちらの方法も、同じAPIを使用します。

各タスクの開始時に、このセッションでMCPツールupload-app、list-my-apps、get-app-info-by-shortcutが利用可能か確認してください。そのうえで、タスクごとにどの方法（MCP／シェル／curl）を使うか、MCPでは不十分なため下位の方法に切り替える必要があるケースも含め、以下の機能マップを唯一の基準として使用してください。HTTPの詳細はreferences/api-cheatsheet.mdに記載されています。

認証情報

PGYERの認証には、https://www.pgyer.com/account/api から取得したAPIキーを使用します。

以下の順にキーを確認します（最初に見つかったものを使用します）。

  1. $PGYER_API_KEY環境変数
  2. ~/.pgyer/config内のapi_key=...の行

どちらも存在しない場合は、設定するようユーザーに依頼してください。今後のセッションでも使えるよう、保存しておくことを推奨します。

mkdir -p ~/.pgyer && chmod 700 ~/.pgyer
echo 'api_key=<key>' > ~/.pgyer/config && chmod 600 ~/.pgyer/config

キーをチャットに書き戻したり、リポジトリにコミットしたりしないでください。

機能マップ

タスク優先する方法フォールバック
ipa/apk/hapのアップロードMCP upload-appscripts/pgyer_upload.sh -k $KEY <file>
パスワード／有効期限／インストール種別を指定してアップロードシェルスクリプト（MCPで公開されるのはfilePathのみ）—
自分のアプリ一覧MCP list-my-appsPOST /apiv2/app/listMy
ショートカットURLからアプリ情報を取得MCP get-app-info-by-shortcutPOST /apiv2/app/getByShortcut
アプリの全情報（パスワード、QR、有効期限、ダウンロード数）curl（MCPでは公開されません）appKeyを指定してPOST /apiv2/app/view
プッシュ時のCI/CDpgyer-upload-app-actionを推奨examples/を参照（プラットフォーム別テンプレート）

filePath以外のアップロードパラメーター（パスワード、インストール種別、有効期限、チャンネルショートカット、更新内容）をユーザーが指定した場合、MCPのupload-appツールでは対応できません。代わりに、同梱のシェルスクリプトを使用してください。

一般的なワークフロー

「このビルドをPGYERにアップロードして」
  1. ファイルパスを特定します。曖昧な場合は、build/、dist/、またはプロジェクトのルート以下で、最新の*.ipa、*.apk、*.hapを探します。
  2. 認証情報を確認できることを確かめます。
  3. アップロードを実行します（MCPが利用可能な場合はMCP、それ以外の場合はscripts/pgyer_upload.shを使用）。
  4. アプリ名、バージョン、ビルド番号、インストール用の短縮URL（https://www.pgyer.com/<buildShortcutUrl>）、QRコードURL、設定されている場合はパスワードを報告します。
「今、PGYERには何がある？」

アプリ一覧を取得します（MCP list-my-appsまたはPOST /apiv2/app/listMy）。名前、バージョン（buildVersion／buildVersionNo／buildBuildVersion）、ショートカットURL、アップロード日時を含む簡潔な表を表示します。

「アプリXについて教えて」

ユーザーからappKey（32文字の16進数）が指定された場合、全記録（パスワード、インストールルール、QR、有効期限）を取得するためにapp/viewを呼び出します。 ユーザーからbuildShortcutUrl（URLのスラッグ）が指定された場合、app/getByShortcutまたはMCP get-app-info-by-shortcutを呼び出します。

"main へのマージごとに PGYER へ公開する CI を設定"

**（CI プラットフォーム × 対象 OS）**に基づいてテンプレートを選びます。examples/ から該当するファイルを読み込み、ユーザーのプロジェクトに合わせて（スキーム名、ビルド出力パス、ブランチ）調整します。追加するシークレット／変数をユーザーに伝えてください。

CI プラットフォームAndroidiOSHarmonyOS
GitHub Actionsexamples/github-actions/android.ymlexamples/github-actions/ios.ymlexamples/github-actions/harmony.yml
GitLab CIexamples/gitlab-ci/android.ymlexamples/gitlab-ci/ios.yml—（harmony.yml のアップロード専用パターンを使用）
fastlaneexamples/fastlane/README.md（公式プラグイン）同左—
Bitrise / Jenkins / その他—（テンプレートはまだありません。gitlab-ci のシェルスクリプトパターンを使用）同左同左

パスワード／有効期限／チャネルが必要ですか？ PGYER/pgyer-upload-app-action GitHub Action が受け付けるのは _api_key と appFilePath のみです。追加パラメーターが必要な場合は、アクションを scripts/pgyer_upload.sh に置き換えてください。GitHub Actions の各テンプレートには、置き換え方法を示すコメント付きの「with password」ブロックがあります。GitLab CI のテンプレートはすでにスクリプトを直接使用しており、fastlane プラグインはこれらのフラグにネイティブ対応しています。

ユーザーから説明がない場合に確認する標準的な質問：

  1. どの CI プラットフォームを使用しますか？（指定がなければ GitHub Actions が既定です。）
  2. どの OS／パッケージタイプですか？（.apk → android、.ipa → ios、.hap → harmony）
  3. インストールパスワード／有効期限／チャネルは必要ですか？（アップロード手順の選択に影響します。上記の注記を参照してください。）

HarmonyOS に関する注意：SDK は GitHub ホステッドランナーにはありません。セルフホストランナーがない場合は、harmony.yml の末尾にあるアップロード専用の方法を案内してください。

結果を報告する際の規約

  • 必ずインストール用短縮 URL（https://www.pgyer.com/{buildShortcutUrl}）を含めてください。人が使用する URL はこちらです。
  • モバイルテスターがスキャンできるよう、QR コード URLも含めてください。
  • アプリでパスワード付きインストール（buildInstallType=2）を使用する場合は、**buildPassword**を提示してください。
  • 該当する場合は、**appExpiredDate**についても触れてください。PGYER のアプリは更新しないと期限切れになります。
  • アップロードについては、ビルドが反映されたことをユーザーが確認できるよう、buildVersion／buildBuildVersionも提示してください。

次に確認する場所

  • references/mcp-tools.md — MCP ツールの正確なスキーマと呼び出し例。
  • references/api-cheatsheet.md — HTTP エンドポイント、パラメーター、レスポンス形式。
  • references/troubleshooting.md — 一般的なエラーコード、ネットワーク／ドメインの代替方法、署名に関する問題。
  • scripts/pgyer_upload.sh — 同梱の公式アップロードスクリプト（複数ドメイン、全パラメーター対応）。
  • examples/ — <platform>/<os>.yml 形式で整理された CI/CD テンプレート。
    • github-actions/{android,ios,harmony}.yml
    • gitlab-ci/{android,ios}.yml
    • fastlane/README.md

コメント

Markdown 対応