🍎 iOSショートカット設定

Xアプリの共有シートから1タップで取り込み

🎯 ゴール

Xで気になった投稿の「共有」→「X Archiveへ保存」でDBに自動記録。 所要時間: 初回設定3〜5分、以降は2タップで完了。

設定手順（iOSで開く）

1

「ショートカット」アプリを開く

iOS標準の「ショートカット」アプリを開きます。 もしホームにない場合は Spotlight（画面を下にスワイプ）で「ショートカット」と検索。

2

右上の「+」で新規ショートカット作成

名前は「X Archive へ保存」など分かりやすく。

3

「共有シートに表示」を ON にする

ショートカット編集画面で右上の ⓘ →「共有シートに表示」をON。 受け入れるタイプは「URL」にチェック。

4

アクション「URLの内容を取得」を追加

検索欄で「URLの内容を取得」と入力して追加。

URL: 下記をコピーして貼り付け、末尾の = のあとに 「ショートカットの入力」変数 を挿入
/api/submit-url?format=text&url=
※ 「ショートカットの入力」は、長押しメニューの「変数を選択」から追加できます
メソッド: GET
5

アクション「通知を表示」を追加

取得結果（ OK @author 123字 ... ）を iOS 通知で表示。

通知本文には前のアクションの出力（「URLの内容」変数）を指定
6

完了。Xアプリでテスト

Xで長文投稿を開く → 共有アイコン →「X Archive へ保存」をタップ。 通知で「OK @author 1234字 ❤400 🔖100」のように表示されれば成功。

💡 上級者向け: さらに高速化

  • 「実行中に表示しない」をONにすると画面遷移なしで完了
  • 「結果を通知」ではなく「スピーチ」にすると声で「取り込み完了」と読み上げ
  • 同じ内容を Android用に Tasker や HTTP Shortcuts アプリでも再現可能

🔗 APIエンドポイント情報

独自にアプリ連携する場合の仕様:

GET 方式（ショートカット向け）:
/api/submit-url?url=<encoded-url>&format=text
→ 平文 "OK @author 123字..." / "NG <reason>"
POST 方式（アプリ向け）:
/api/submit-url
body: { "url": "https://x.com/.../status/..." }
→ JSON レスポンス
複数URLは改行区切りでまとめて投入可。リプライ/RTも含まれます。