iPhoneショートカットでGAS・GitHub Actionsを実行する方法と、専用アプリとの違い

この記事は、比較対象の1つ「Pocket Actions」の開発者が書いています。仕様は確認日時点のAppleとGitHubの公式ドキュメント(リンク先)にもとづいています。確かめられなかったことは「未確認」と書いています。

ショートカットで十分か、アプリを入れるべきか

GASやGitHub Actionsで作った自動化を、iPhoneからボタン1つで動かしたい。そう考えたとき、最初に候補になるのはiPhoneに最初から入っている「ショートカット」アプリです。追加のアプリもお金もいらず、ホーム画面やSiriから実行できます。

一方で、ショートカットでAPIを呼ぶには、URL・ヘッダー・トークン・送るデータを自分で組み立てる必要があります。1本だけなら気になりませんが、ワークフローが増えたり、入力値を毎回変えたくなったりすると、作るのも直すのも手間になります。

この記事では、ショートカットで組む方法の要点を示したうえで、専用アプリを使う場合と何が違うのかを比べます。結論を先に書くと、動かしたいものが1〜2本で、APIを組むのが苦にならないならショートカットで十分です。本数が多い、入力が多い、トークンの扱いを自分で考えたくない、という場合は専用アプリが楽になります。

ショートカットでできること(公式の仕様)

Appleのショートカットユーザガイドによると、ショートカットは次のような方法で実行できます(ショートカットユーザガイド)。

  • ショートカットアプリから
  • Siri、コントロールセンター、アクションボタン、背面タップ
  • ホーム画面のウィジェット、ホーム画面に追加したアイコン、検索画面

また、Web APIを呼び出すためのアクション(「URLの内容を取得」など)があり、JSONの解析もできます。つまり「HTTPリクエストを送るボタン」は、ショートカットで作れます。

GitHub Actionsをショートカットから動かす

GitHub Actionsのワークフローを外から動かす公式の方法は、REST APIの「workflow dispatch イベントの作成」です(GitHub REST API: workflows)。

  • エンドポイント:POST /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches
  • 送るもの:ref(ブランチかタグ。必須)と inputs(ワークフローで定義した入力。最大25個)
  • 前提:ワークフローに on: workflow_dispatch が書かれていて、そのファイルがデフォルトブランチにあること(Events that trigger workflows)
  • 認証:classic PATなら repo スコープ。Fine-grained PATなら「Actions」の書き込み権限(Fine-grained PATに必要な権限)

ショートカットで組むなら、だいたい次の流れです。

  1. 「URLの内容を取得」アクションを置き、上のURLを入れる
  2. 方法をPOSTにし、ヘッダーに Authorization: Bearer <トークン> と Accept: application/vnd.github+json を入れる
  3. 本文をJSONにして、ref と inputs を入れる
  4. 入力値を毎回変えたいなら、その前に「入力を要求」アクションを置き、変数として渡す

ここで気をつけたいのはトークンの置き場所です。この作り方では、トークンはショートカットの中に書くことになります。ショートカットを人に共有するときや、iCloudで同期するときに、トークンが一緒に動かないか注意してください(共有・同期時の扱いの詳細は、この記事では確認していません)。

GASをショートカットから動かす

GASを外から動かすよくある方法は、スクリプトを「ウェブアプリ」としてデプロイし、doGet や doPost の関数をURLで呼ぶ方法です。ショートカットからは「URLの内容を取得」でそのURLを開くだけなので、GitHub Actionsより簡単です。

ただし、ウェブアプリを「誰でもアクセス可」にすると、URLを知っている人は誰でも実行できます。URLの扱いはパスワードと同じように考えましょう。また、GASには実行時間(1回6分まで)などの上限があります(Apps Script の割り当てと制限)。

専用アプリを使う場合

iPhoneから workflow_dispatch を実行できるアプリはいくつかあります(詳しくはGitHub Actions向けiPhoneアプリ比較)。ここでは代表として2つを取り上げます。

  • GitHub公式アプリ:2024年7月から、ワークフローの画面で workflow_dispatch を手動実行できます(GitHub Changelog)。GitHubにサインインするだけで、トークンの用意はいりません。ログも見られます。GASは対象外です。
  • Pocket Actions:GitHub ActionsとGASのウェブアプリを、1〜3タップで実行するアプリです。ワークフローの inputs から入力フォームを自動で作ります。トークン(PAT)は端末内の安全な領域にだけ保存します。

比較表

比較表
項目iOSショートカットGitHub公式アプリPocket Actions
費用iPhone標準(無料)無料1日5回・週17回まで無料。プレミアム 月額¥380/買い切り¥5,980
GitHub Actionsの実行APIを自分で組めばできるできる(入力も)できる(入力フォームを自動作成)
GASの実行ウェブアプリのURLを呼べばできるできないできる
実行までのタップ数ホーム画面・Siri・背面タップなどから1タップにできるリポジトリ→Actions→ワークフロー→Run workflowとたどる1〜3タップ
ブランチの指定自分で ref を書く(自由)選べるmain固定(選べない)
入力値「入力を要求」で自作画面で入力自動でフォームを作る
トークンの置き場所ショートカットの中不要(GitHubにサインイン)端末内の安全な領域だけ
結果・ログの確認自分でAPIを追加で呼べば一部可能見られる見られない(受け付けの確認のみ)
GASのエラー検知返り値を自分で判定すれば可能—スクリプトがエラーでも「成功」と表示される
Android—ありなし(クローズドテスト中)

それぞれの長所と短所

iOSショートカット

  • 長所:無料、追加アプリ不要。起動方法が多く、アクションボタンや背面タップに割り当てれば本当に1タップ。リクエストの中身を自由に組めるので、ブランチ指定や結果の取得まで自分で作り込める。
  • 短所:APIの仕様を読んで組む必要がある。ワークフローが増えるたびにショートカットを作る。入力フォームも手作業。トークンをショートカットの中に書くことになる。
  • 向いている人:動かしたいものが少なく、APIを読むのが苦にならない人。

GitHub公式アプリ

  • 長所:無料。サインインだけで使え、トークン管理がいらない。ログや失敗通知もある。
  • 短所:ワークフローを動かすまでに画面をいくつかたどる。GASは扱えない。
  • 向いている人:GitHubのことはまず公式アプリで済ませたい人。

Pocket Actions

  • 長所:GitHub ActionsとGASを1つのアプリにまとめて、1〜3タップで動かせる。入力フォームを自動で作る。サーバーもアプリのアカウント登録もいらない。
  • 短所:
    • 実行はmainブランチ固定です。
    • GASは、呼び出しが受け付けられれば、スクリプト内でエラーが起きても「成功」と表示されます。結果はGAS側で確認が必要です。
    • 実行結果やログはアプリ内で見られません。
    • iOSのみで、Android版はクローズドテスト中です。
    • 無料は1日5回・週17回までです。
    • 自動化そのものは自分で書く必要があります(ノーコードではありません)。
  • 向いている人:GitHub ActionsとGASの両方、または本数の多い自動化を、手早く動かしたい人。

ショートカットを最後まで組んでみる

GitHub Actions用(入力付き)

  1. 「メニューから選択」でquickとfullを用意し、それぞれに同じ文字の「テキスト」を置く
  2. 「入力を要求」で、メモ欄(テキスト)を用意する
  3. 「辞書」で、modeにメニューの結果、noteに入力された値を入れる(数値や真偽値ではなく、テキストとして入れる)
  4. 「URLの内容を取得」で、方法をPOSTにし、ヘッダーにAccept: application/vnd.github+jsonとAuthorization: Bearer トークンを入れる。本文はJSONにして、refにmain、inputsに3の辞書を入れる
  5. 「辞書の値を取得」でhtml_urlを取り出し、値があれば「URLを開く」で実行ページを開き、なければ「結果を表示」で応答を見る

GitHubの現在のREST APIドキュメントでは、workflow dispatchが成功すると200が返り、本文にworkflow_run_id・run_url・html_urlが入ります(REST API)。古いAPIバージョンで本文のない204が返るかどうかは未確認なので、2xxなら成功と考えてください。失敗するとmessageにエラーの内容が入ります。

GAS用(合言葉付き)

function doGet(e) {
  const key = PropertiesService.getScriptProperties().getProperty('SHARED_KEY');
  if (e.parameter.key !== key) {
    return ContentService.createTextOutput('{"ok":false}')
      .setMimeType(ContentService.MimeType.JSON);
  }
  // 実際の処理
  return ContentService.createTextOutput('{"ok":true}')
    .setMimeType(ContentService.MimeType.JSON);
}

アクセスできるユーザーを「全員」にすると、URLを知っている人は誰でも実行できます。そのため、合言葉を確認して、URLだけでは動かないようにしておきます。ショートカットは、応答のJSONからokを読んで、成否を通知できます。

よくあるエラー

よくあるエラー
表示原因対処
Not Foundトークンの権限不足、または名前の打ち間違いリポジトリ名、ファイル名、トークンの対象を確認する
Unexpected inputs providedYAMLにない入力名を送っている辞書のキーをYAMLに合わせる
GASからHTMLが返るログインが必要な設定、またはエラー画面Safariで開いて内容を確認する
GASの修正が反映されない/execはデプロイ済みの版を動かすデプロイを管理 → 編集 → 新しいバージョン(デプロイ)

エラーメッセージの文言は公式に記載がないため、表の文言は目安です(未確認)。

入力の追加やトークンの入れ替えのたびに、ショートカットも直す必要があります。

タイプ別のおすすめ

  • 1〜2本だけ、APIを組める:ショートカット。アクションボタンや背面タップに割り当てると快適です。
  • GitHub Actionsだけ、ログも見たい:GitHub公式アプリ。
  • GASとGitHub Actionsの両方、または入力つきのワークフローが多い:Pocket Actions。
  • 組み合わせる:Pocket Actionsで動かし、結果は公式アプリやGASの実行ログで確認する、という使い分けもできます。

使い方の一例(開発者の場合)

開発者自身は、気になった銘柄をAIに評価させる自動化を、必要なときにPocket Actionsから実行しています。毎日決まった時間に動かす必要のない処理なので、手動実行のボタンとして使っています。

まずは無料で試す

ショートカットを組む前に、どのくらい手間が減るか試してみてください。1日5回まで無料です。

App StoreでPocket Actionsを見る

よくある質問

ショートカットだけでGitHub Actionsは動かせますか? 動かせます。workflow dispatchのREST APIに、トークンとref・inputsを付けてPOSTするショートカットを作れば実行できます。

ショートカットに書くトークンは何を選べばいいですか? GitHubはFine-grained PATを推奨しています。workflow dispatchには「Actions」の書き込み権限が必要です。対象のリポジトリと有効期限を絞りましょう。

GASのウェブアプリはショートカットから呼べますか? 呼べます。ウェブアプリのURLを「URLの内容を取得」で開きます。誰でもアクセスできる設定にした場合、URLの扱いに注意してください。

Pocket Actionsはブランチを選べますか? 選べません。GitHub Actionsはmainブランチで実行されます。

Pocket ActionsでGASがエラーになったら分かりますか? 分かりません。呼び出しが受け付けられれば「成功」と表示されます。GASの実行ログで確認してください。

関連記事

最終確認日:2026-11-01(Apple ショートカットユーザガイド、GitHub Docs、GitHub Changelog、Apps Script Docs)。仕様は変わることがあるので、利用前に公式ドキュメントを確認してください。