我用 Grok Bot 的 webhook，把 Kobo 變成外文閱讀器

最近 Grok Bot 推出了一個超好用的 webhook 功能，我用它建立了一套用電子閱讀器閱讀網路長文的方法。

長文我比較喜歡在電子閱讀器上讀，比較方便，螢幕看起來也比電腦、手機舒服。搭配翻譯更好用：按下分享，稍等一下，翻好的中文就已經在 Kobo 裡了。

比如在 X 上看到一篇英文長文，我會按「分享」，選捷徑「存入 Kobo」，再選「翻譯並存入 Instapaper」。等一下打開 Kobo，標題前面有【中譯】的那篇就是它。想劃重點、寫筆記的文章，則選「轉 EPUB」，它會變成一本可以劃線的電子書。

這篇把整條流程拆開，一步一步做一次：

1. 先講 webhook 是什麼，為什麼這次特別好用。
2. 流程怎麼運作，四個選項各做什麼。
3. 六個設定步驟：Kobo 連 Instapaper、Kobo 連 Google Drive、Instapaper 權杖、請 Grok Bot 建 webhook、做 iPhone 捷徑（不會做可以請 Bot 帶）、測試。
4. Instapaper 和 EPUB 怎麼選。
5. webhook 加上蘋果捷徑，還能做哪些應用。
6. 常見問題、卡住時先查哪裡，以及兩個提醒。

先懂 webhook：為什麼這次特別好用

webhook 是一個專屬的收件網址。任何能送出網路請求的工具，例如 iPhone 的捷徑、Notion 的自動化，只要把資料送到這個網址，Grok Bot 就會啟動你事先寫好的例行任務。來源：Grok Bot 例行任務與 Webhook

用生活的例子說，webhook 就像門鈴。捷徑按門鈴，Grok Bot 聽到就出來，照你寫好的例行任務做事。

這對讀長文特別好用，原因有三個：

1. 只要設定一次。之後在任何能分享網址的 App 裡按「分享」，就能把文章交給 Grok Bot。
2. 抓全文、翻譯、存檔這些麻煩事，都由 Grok Bot 在背景做完，手機不用一直開著等。
3. 想加新用途，只要在捷徑選單多一個選項、在提示詞多寫一段。

這條流程怎麼運作

1. 在 iPhone 上能分享網址的 App（例如 X、Safari），按「分享」，選捷徑「存入 Kobo」。
2. 捷徑跳出選單，選這篇要怎麼存。
3. 捷徑把文章網址和選的模式，用 POST 送到 Grok Bot 的 webhook。
4. Grok Bot 啟動例行任務：抓全文，需要的話先翻譯，再依模式存進 Instapaper，或轉成 EPUB 放進 Google Drive。
5. Kobo 同步 Instapaper 或 Google Drive，文章就出現在閱讀器上。

選單有四個選項：

選項	捷徑送出的 mode	Grok Bot 做什麼	在 Kobo 哪裡讀
存入 Instapaper	save	原文存進 Instapaper	我的文章
翻譯並存入 Instapaper	translate	翻成台灣繁體中文，再存進 Instapaper	我的文章
轉 EPUB 存到 Kobo	epub	原文轉成 EPUB，上傳到 Google Drive 的「Rakuten Kobo」資料夾	我的 Google Drive，再複製到我的書籍
翻譯並轉 EPUB 存到 Kobo	epub_translate	先翻譯，再轉 EPUB 上傳	同上

mode 是我在捷徑裡自訂的代號。大家可以換成自己好記的字，只要捷徑和 Grok Bot 的提示詞對得起來就好。

開始前要準備什麼

1. iPhone 的「捷徑」App。
2. Grok Bot：要有可用的方案與額度，例行任務每跑一次都會用掉用量。來源：Grok Bot 費用說明、例行任務用量
3. 一台電腦：第 4 步要在 Grok Bot 桌面版打開例行任務，拿 webhook 網址和金鑰。
4. Instapaper 帳號：免費帳號就能連 Kobo。來源：Instapaper Kobo 說明
5. Kobo 電子閱讀器：目前仍受支援的機型都能連 Instapaper。要走 EPUB 路線的話，Google Drive 同步只有 Kobo Forma、Sage、Elipsa、Elipsa 2E、Libra Colour 支援，軟體版本要 4.37 以上。來源：Kobo Google Drive 說明
6. Google 帳號：只有走 EPUB 路線才需要。

費用方面，除了 Grok Bot 本身的方案，這條流程沒有其他支出。Instapaper API 我用免費帳號就能存文章，不需要 Premium。

第 1 步｜Kobo 連上 Instapaper

1. Kobo 主畫面點底部的「更多」。
2. 點「我的文章」，再點「連結 Instapaper」。
3. 用電腦打開 kobo.com/instapaper，或用手機掃 Kobo 畫面上的 QR 碼。
4. 輸入 Kobo 上顯示的代碼，點「連結 Instapaper」，在「應用程式存取」頁面授權。

連好之後，「我的文章」會列出 Instapaper 裡的文章。下載文章要連 Wi-Fi。來源：Kobo 說明中心

第 2 步｜Kobo 連上 Google Drive（只走 EPUB 才需要）

1. Kobo 主畫面點「更多」，選「我的 Google Drive」，點「開始使用」，記下畫面上的代碼。
2. 用電腦或手機打開 kobo.com/googledrive，輸入代碼，登入 Google 帳號後點「允許」。
3. 連結後，Google Drive 會自動建立「Rakuten Kobo」資料夾。要在 Kobo 讀的檔案，都要放在這個資料夾裡。

來源：Kobo 說明中心

第 3 步｜在 Instapaper 產生自己的存取權杖

Grok Bot 要把文章存進 Instapaper，需要 Instapaper API 的存取權杖（access token）。如果只給自己的帳號用，不必走完整的 OAuth 授權流程：

1. 登入 Instapaper，打開開發者頁面的「Applications」，建立一個新的 application，名稱自己取，例如「Kobo 捷徑」。
2. 打開這個 application，點「Generate access token」。
3. 權杖只會顯示一次，先存在安全的地方。之後在同一頁可以重新產生或撤銷，舊的權杖會立刻失效。

來源：Instapaper API 驗證說明

權杖不要貼在一般對話裡。我的權杖只放在 Mac Studio 的 ~/.config/instapaper/，Grok Bot 在 Mac Studio 上呼叫 Instapaper API 時直接讀這個設定檔，權杖不會出現在對話裡。沒有自己的電腦接給 Bot 的話，可以等 Bot 跟你要金鑰時，在它跳出的安全密鑰卡片裡輸入，內容不會留在對話紀錄，模型也看不到。來源：Grok Bot 安全與隱私

翻譯版要怎麼存進 Instapaper？原文直接給網址就能存。翻譯後的文章沒有公開網址，要把譯文放在 content，private_source 填一個來源名稱（我填「Grok Bot」），而且不能帶 url，因為 Instapaper 不接受 url 和 private_source 同時送。存好之後，這篇在 Instapaper 的來源會顯示「Grok Bot」，不會連到原網址，所以原文連結要放在文章最後面。來源：Instapaper API Bookmarks

第 4 步｜請 Grok Bot 幫你建 webhook 例行任務

webhook 不用自己設。直接在 Grok Bot 的對話裡，把下面這段提示詞整段貼給它，請它建立例行任務。提示詞把「收到什麼、照什麼條件做什麼、存到哪裡、做完回報什麼」都寫清楚了，大家可以直接照抄，再依自己的工具調整：

幫我建一條例行任務，加上 webhook 觸發。這條任務會收到 iPhone 捷徑送來的 JSON，裡面有 url 和 mode。收到之後：

1. 先讀取 url 的全文。X 的文章透過 FxTwitter 取全文，一般網頁直接抓。讀不到全文就回報給我，不要自己補內容。
2. mode 是 save：把 url 存進我的 Instapaper。
3. mode 是 translate：把全文翻成台灣繁體中文，做成 HTML，標題前加【中譯】，文末附原文連結；用 Instapaper API 新增書籤，譯文放 content，private_source 填「Grok Bot」，不要帶 url。
4. mode 是 epub：用 pandoc 把全文轉成 EPUB，套用 kobo.css，上傳到 Google Drive 的「Rakuten Kobo」資料夾。
5. mode 是 epub_translate：先照第 3 點翻譯，再照第 4 點轉 EPUB 上傳。
6. 檔名不要有 | " : ? < > 這些字元。
7. 完成後簡短回報標題和存到哪裡。

需要 Instapaper 權杖或 Google Drive 權限時，請用安全的方式跟我要，不要叫我貼在對話裡。

這段提示詞裡有三個地方特別重要：

1. 第 1 點的「讀不到就回報」一定要寫。抓不到全文的時候，Bot 有可能自己把內容補起來。
2. 第 3 點的 content、private_source、不帶 url，是 Instapaper 存翻譯版的規則，少一個就會存失敗。
3. 第 6 點是因為 Kobo 說明裡提到，放進 Google Drive 的檔名不要用特殊字元。

Bot 建好之後，接著拿 webhook 的網址和金鑰：

1. 在桌面版點對話頂端的 Bot 名稱，進入 Details，找到 Routines，打開剛剛建的例行任務。
2. Webhook 區塊有三個欄位：POST to 是收件網址；key 是金鑰，送資料時以「Authorization: Bearer 金鑰」的格式放在標頭；header 是完整的標頭，可以直接複製。
3. 點欄位就能複製。這兩個值等一下要貼進捷徑，先不要關掉這個頁面。

來源：Grok Bot 例行任務管理與 Webhook

我實際的分工是這樣：

1. 抓全文：X 的文章透過 FxTwitter 取全文，一般網頁直接抓。
2. 翻譯：可以讓 Grok Bot 自己翻，也可以指定其他模型。我目前是派給 Mac Studio 上的 Claude Code，先整理術語表，再逐段意譯，最後用台灣用語順一遍。
3. 存進 Instapaper：Grok Bot 在 Mac Studio 上直接呼叫 Instapaper 官方 API，不是用分享或寄信。
4. 轉 EPUB：Grok Bot 在它自己的雲端電腦上用 pandoc 轉，套一份把字級調小的 kobo.css，再上傳到「Rakuten Kobo」資料夾。

EPUB 路線還需要 Bot 能寫入你的 Google Drive，開始前先確認它有這個權限。

第 5 步｜做 iPhone 捷徑「存入 Kobo」

捷徑有兩種做法。不熟捷徑的話，先用做法 A，請同一個 Bot 一步一步帶你做；熟的話直接照做法 B 的動作清單做。兩種做法最後都要把 webhook 的網址和金鑰貼進捷徑，方法寫在後面的「把網址和金鑰貼進捷徑」。

做法 A｜捷徑不會做？請同一個 Bot 帶你做

回到剛剛建 webhook 的 Grok Bot 對話，把這套流程告訴它，請它一次教你一個步驟。可以直接貼這段：

帶我在 iPhone 的捷徑 App 做一個捷徑，名稱叫「存入 Kobo」，要送到你剛剛建的 webhook：

1. 在分享表單中顯示，接收 URL 和 Safari 網頁。
2. 先放兩個「文字」動作：第一個放 webhook 網址，第二個放「Bearer 」加金鑰。
3. 跳出選單讓我選：存入 Instapaper、翻譯並存入 Instapaper、轉 EPUB 存到 Kobo、翻譯並轉 EPUB 存到 Kobo，分別對應 mode：save、translate、epub、epub_translate。
4. 用「取得 URL 內容」以 POST 送出 JSON，欄位是 url（捷徑輸入的網址）和 mode；標頭放 Authorization 和 Content-Type: application/json。
5. 送出後顯示通知「已送出」。

請用台灣繁體中文介面的動作名稱，一次告訴我一個步驟，我做完會回來說「下一步」。網址和金鑰我自己貼，不要叫我貼給你。

最後一句要留著。金鑰只貼在自己的捷徑裡，不要貼進任何對話。

做法 B｜照動作清單自己做

我的捷徑結構如下，大家照著做一次就好：

1. 捷徑詳細資訊打開「在分享表單中顯示」，接收類型勾 URL 和 Safari 網頁。來源：Apple 捷徑使用手冊
2. 加一個「文字」動作，貼上 Webhook 網址（POST to 那一格），存成變數 WebhookURL。
3. 再加一個「文字」動作，貼上 header 那一格的完整值，也就是「Bearer 」加金鑰，存成變數 Auth。
4. 加「從選單中選擇」，放四個選項：存入 Instapaper、翻譯並存入 Instapaper、轉 EPUB 存到 Kobo、翻譯並轉 EPUB 存到 Kobo。
5. 每個選項底下放一個「文字」動作，分別寫 save、translate、epub、epub_translate，再存成變數 Mode。
6. 選單結束後加「取得 URL 內容」：網址選變數 WebhookURL；方法選 POST；標頭加兩個，Authorization 選變數 Auth，Content-Type 填 application/json；要求內文選 JSON，加兩個欄位，url 選「捷徑輸入」，mode 選變數 Mode。來源：Apple API 請求設定
7. 最後加「顯示通知」，寫「已送出」。

把網址和金鑰貼進捷徑

1. 在 Grok Bot 桌面版的例行任務頁，點「POST to」複製網址，貼進捷徑的第一個「文字」動作。
2. 回到例行任務頁，點「header」複製完整標頭（Bearer 加金鑰），貼進第二個「文字」動作。
3. 貼好後檢查一次：網址是 https 開頭、header 的 Bearer 後面有一個空格。

例行任務頁開在電腦上，捷徑在 iPhone 上，怎麼把內容貼過去？如果電腦是 Mac，可以用「通用剪貼板」：在 Mac 拷貝，直接在 iPhone 貼上。條件是兩台裝置都開啟 Wi-Fi、藍牙和「接力」，登入同一個 Apple 帳號，而且距離在 10 公尺以內。來源：Apple 在 Mac 和其他 Apple 裝置之間拷貝和貼上

做完之後要知道的兩件事

1. 捷徑跳出「已送出」，只代表手機把資料送出去了。Grok Bot 回應 200，代表它收到並開始跑，還沒做完。有沒有做完，要回 Grok Bot 的對話看結果。來源：Grok Bot Webhook 回應說明
2. 想把捷徑分享給朋友，可以把網址和金鑰這兩個文字動作設成「匯入問題」，對方匯入時會被要求貼上自己的網址和金鑰。我的捷徑就是這樣設的，所以分享出去的檔案裡不會有我的金鑰。來源：Apple 將輸入問題加入分享的捷徑

第 6 步｜測試，再到 Kobo 找文章

1. 在 X 或 Safari 打開一篇文章，按「分享」，選「存入 Kobo」，先選「存入 Instapaper」。
2. 看到通知後，到 Grok Bot 的對話確認它回報完成。
3. Instapaper 路線：Kobo 連上 Wi-Fi，到「更多」，點「我的文章」。沒看到新文章，點灰色欄位的選單圖示，選「重新整理」。
4. EPUB 路線：Kobo 主畫面點上方的「同步」圖示，點「立即同步」，再到「更多」，點「我的 Google Drive」。點那本書，它會複製到「我的書籍」。沒看到的話，點右上角「功能表」，選「重新整理」或「全部下載」。
5. 四個選項各跑一次，確認都沒問題，再開始日常使用。

來源：Kobo Instapaper 說明、Kobo Google Drive 說明

Instapaper 還是 EPUB？

	Instapaper	EPUB
適合	讀完就好的文章	要劃重點、做筆記、反覆讀的長文
劃線、筆記	不支援	可以，跟一般電子書一樣
同步方式	Kobo 內建的 Instapaper 整合	Google Drive「Rakuten Kobo」資料夾
支援機型	目前受支援的 Kobo 都可以	Forma、Sage、Elipsa、Elipsa 2E、Libra Colour
額外費用	0 元	0 元

Instapaper 整合目前不支援資料夾、標籤、劃線與筆記，也不支援影片和 PDF。Kobo 會同步 Home、Liked、Archive 三個列表；文章放進資料夾就不會同步，要移回主清單才會出現。來源：Instapaper Kobo 說明、Kobo 說明中心

我自己的分法很簡單：要做筆記的才轉 EPUB，因為只有 EPUB 能劃線、寫筆記；其他文章都存 Instapaper。

webhook 加上蘋果捷徑，還能做什麼

「存入 Kobo」只是其中一種用法。同一套組合，捷徑負責「從手機丟東西出去」，webhook 負責「叫 Grok Bot 開工」，例行任務的提示詞決定它要做什麼。換一段提示詞，就是另一個工具。以下是幾個可以延伸的方向，提示詞都是範例，要依自己的工具調整：

1. 社群發文：把 Notion 當寫文後台。文章寫好、把狀態切到「交給 Grok Bot」，Notion 自動化就透過 webhook 通知 Bot，它去讀這一頁、照你的語氣潤稿，再用排程工具排到 Threads、FB。Notion 的「傳送 Webhook」動作需要付費方案，而且只會送欄位、不會送頁面內文，所以提示詞要叫 Bot 自己回 Notion 讀全文。來源：Notion Webhook 動作
2. 訂單管理：把訂單通知或訂單截圖分享給捷徑，請 Bot 整理出品項、數量、金額、收件資訊，寫進你的訂單表，遇到缺貨或資料不完整就回報你。
3. CRM 管理：收到合作來信、名片或私訊，分享給捷徑，請 Bot 建立或更新聯絡人資料，記下聊過什麼、下次什麼時候跟進。
4. 把社群內容整理成筆記：滑到好貼文、好影片，按分享丟給 Bot，選單可以分成「紀錄」「分析」「當題材」，例如：「看完這則內容，告訴我它的開頭怎麼抓人、結構怎麼排，最後給我 3 點可以借用的做法，存進我的 Notion。」

做這些延伸應用時要注意三件事：

1. Bot 要先能存取對應的工具（Notion、試算表、排程工具），沒有權限就做不了。
2. 會對外送出的動作，例如發文、寄信，建議在 Grok Bot 設成「Ask first」，先問過你才做。來源：Grok Bot 核准與自訂規則
3. 每個用途各開一條例行任務，各自有網址和金鑰，出問題時比較好查。

常見問題

1. 沒有 Kobo 也能用嗎？可以先只走 Instapaper：文章存進 Instapaper 之後，在 Instapaper 的 App 或網頁也能讀。EPUB 自動同步這段是 Kobo 的 Google Drive 功能，換其他閱讀器要看各家的做法。
2. 一定要付費嗎？Grok Bot 要有可用的方案，例行任務每跑一次都會用到額度。Instapaper 用免費帳號就可以，Kobo 連 Instapaper、Google Drive 也不用另外付費。
3. Android 可以嗎？這篇用的是 iPhone 內建的捷徑 App。Android 要找能送出 POST 請求的自動化 App，送的內容一樣是 url 和 mode，這部分我沒有實測。
4. 翻譯品質可以調整嗎？可以。翻譯可以讓 Grok Bot 自己做，也可以在提示詞裡指定交給其他模型。我自己是派給 Mac Studio 上的 Claude Code，先整理術語表，再逐段意譯，最後用台灣用語順一遍。
5. 付費牆或要登入的文章呢？Bot 可能讀不到全文。提示詞裡寫了「讀不到就回報」，它會停下來告訴你，不會自己補內容。
6. 一次丟很多篇會怎樣？每分享一篇就觸發一次例行任務，各自計算用量。想省額度，可以只把真的想讀的文章丟過去。

卡住的時候，先查這幾個地方

1. 通知跳了，Bot 沒動：檢查例行任務有沒有被暫停、捷徑裡的金鑰是不是最新的那一把、header 的 Bearer 後面有沒有空格。Grok Bot 沒有回 200，就代表任務沒啟動。
2. Bot 說完成，Kobo 裡沒有：確認文章沒有被放進 Instapaper 的資料夾，Kobo 有連 Wi-Fi，也按過「重新整理」。
3. EPUB 沒出現：確認檔案在「Rakuten Kobo」資料夾裡、檔名沒有特殊字元，以及你的機型有支援 Google Drive。
4. 翻譯版沒進 Instapaper：確認提示詞有寫「譯文放 content、private_source 填來源名稱、不要帶 url」。
5. 內容不完整：有些網站要登入或有付費牆，Bot 可能讀不到全文。提示詞裡那句「讀不到就回報」，會讓它停下來告訴你。
6. 通用剪貼板貼不過去：確認兩台裝置都開了 Wi-Fi、藍牙和「接力」，登入同一個 Apple 帳號，距離在 10 公尺以內。

兩個提醒

1. 翻譯只給自己讀。別人的文章翻成中文後，不要公開轉貼或分享出去，EPUB 翻譯版也一樣。
2. 金鑰好好保存。webhook 金鑰和 Instapaper 權杖都等於鑰匙。分享捷徑前先清掉自己的網址和金鑰。萬一外流，先暫停這條例行任務，再換新的金鑰，捷徑也要一起更新；Instapaper 權杖可以在 application 頁面撤銷重發。