Notion API 高級整合：寫作必備自動上傳 Notion 內容到 WordPress

Oscar Chuang

Oscar Chuang

— 11 min read

為什麼要自動化來協助寫作?

如果你和我一樣，思考過經營一個部落格透過分享文章來賺錢的話，我們都試著優化網站的「SEO」來提高流量，但同時也面臨著一個巨大的挑戰：「如何高效地管理和發布大量的文章內容，同時還要保持內容的質量和更新速度。」

這表示我們要在有限的時間內，寫作、更新，還要在不同的平台上發佈。

這不僅僅是一個時間管理的問題，更是一個技術挑戰。其中最讓我最苦惱的是 WordPress 內容的管理和自動化，這是我最想要克服的問題。所以我一直在找尋自動化的方法，但網路上的資訊確實有限，現在我透過 Python 程式來為我上傳文章到 WordPress ，提高了我的寫作生產力，最高興的是我有更多的時間可以寫作。

總之，本文將深入探討如何使用 Notion API 與 WordPress REST API 進行整合，實現自動上傳內容的流程，並討論這種自動化如何顯著提高創造和生產能力。

使用 Notion API 和 WordPress API 進行整合的好處

  1. 提高效率：自動化的內容管理過程可以節省大量的手動輸入和維護時間，使創作者和管理者能夠專注於內容創作而非繁瑣的格式和發布流程。
  2. 增強一致性：通過自動化工具，每一篇文章的格式、風格和發布標準都可以統一，這對於保持品牌的專業形象至關重要。
  3. 即時更新：當內容需要快速反應最新信息或數據時，自動化發布系統可以確保信息在幾乎無延遲的情況下被更新和發布，大大提高了信息的時效性。
  4. 跨平台管理：Notion 和 WordPress 的整合允許內容在多個平台之間無縫對接，為管理多個渠道提供了便利。

Notion → WordPress 自動化程式邏輯怎麼寫?

開始之前，我們需要先梳理一下本程式的邏輯。

mynotion_20240805.png

從流程圖上來看，我們要先建立一個 Notion database 並在上面寫文章內容，以及設定 Properties 包含有 Name、前言和 slug 等等，依你的需求。

再來我們要寫一段程式來取得 Notion database 上的所有資料，然後將資料透過 WordPress REST API 來新增文章。

用 Python 寫自動上傳程式

前置作業：Notion Integration Token 申請

從左上角的 「Settings & members 」進入設定頁面。

mynotion_step6-1-e1673172217724.png

點擊左下方的 Connections ，找到頁面下方的 Develop or manage integrations。

mynotion_step6-2-e1673172249188.png

進入頁面後，點擊 Create new integration。

mynotion_step6-3-e1673172278268.png

輸入自訂名稱，確認 Read content 有打勾，點擊「Submit」即可。

mynotion_step6-4-e1673172308874.png

這樣就完成 Internal Integration Token 的申請，請將 Token 存在某個地方，等一下我們需要使用。

mynotion_step6-5-e1673172341260.png

前置作業：Database Connect

完成 Notion Integration Token 申請後，請不要忘了新增一個 Notion Database ，並且將 Notion Connecting 設定好。

mynotion_20240814.png
mynotion_20240803-4.png

前置作業：準備 Python 程式環境 Google Colab

Google Colab，全名 Google Colaboratory，是 Google 為了推廣機器學習所提供的一個研究工具。它是一個完全基於雲端的 Jupyter 筆記本環境，能夠在瀏覽器中撰寫和執行 Python 等多種語言的程式碼，不需要任何設定。此外，Google Colab 提供了免費的 GPU 使用，使得執行機器學習和深度學習的程式碼更為便利。你可以隨時隨地、在任何裝置上，只需一個 Google 帳戶和網路連線，就能使用 Google Colab 進行程式學習和資料分析。

網址：https://colab.research.google.com/?hl=zh-tw

bookmark

步驟一：取得 Notion database Properties

在先前的文章 Notion API 怎麼用? 基礎教學 Postman 、Typeform 我們有討論過如何取得 Database 的列表。

這次我們要用 Query a database 服務，這個功能和之前的 List databases 有個很大的不同，就是加上了過濾器 Filter ，因為我們並不想要取得所有的項目，而是部份滿足特定條件的項目。

mynotion_20240805-1.png

如果你已經取得 Token 和登入 Google Colab 帳戶了，從 Notion API Guides 可以找到

那可以輸入程式：

import requests
import json
notion_database_id = 'b5d07b515a304163a0d1b7c931df9e57'
notion_integration_token = 'secret_MgXY2xxxxxxxxxxxxxxxxxVfw7NoxxQBls'
headers = {
            "Accept": "application/json",
            "Notion-Version": "2022-06-28",
            "Content-Type": "application/json",
            "Authorization": notion_integration_token,
        }
notion_payload = {
    "page_size": 10,
    "filter": {
        "and": [
            {
                "property": "Checkbox",
                "checkbox": {
                    "equals": True
                }
            },
        ]
    }}
notion_api_url = f"https://api.notion.com/v1/databases/{notion_database_id}/query"
response = requests.post(notion_api_url, json=notion_payload, headers=headers)
datas = response.json().get('results', [])
print('找到資料數 = ',len(datas))

簡單變數說明：

以上是個簡單的 Python 程式碼示例，請自行替換 notiondatabaseid 和 notionintegrationtoken ，並確保資料庫中有新增 Property checkbox 並且打勾。

mynotion_20240805-2.png

步驟二：取得 Notion Page 內容

獲取 database Properties 後，接下來我們想取得 Notion Page 內容，這必須使用 Retrieve block children 功能。

mynotion_20240805-3.png

依 Notion API Guides 的內容，我們可以輸入程式：

import requests
import json
page_id = 'c30e4aa7-7dcc-4a64-bcf5-b0a08c003b15'
notion_integration_token = 'secret_MgXY2xxxxxxxxxxxxxxxxxVfw7NoxxQBls'
def get_content(page_id, notion_integration_token):
    headers = {
        "Authorization": f"Bearer {notion_integration_token}",
        "Content-Type": "application/json",
        "Notion-Version": "2022-06-28"
    }
    # 初始化URL和空列表用于存储所有blocks
    url = f"https://api.notion.com/v1/blocks/{page_id}/children"
    all_blocks = []
    more_data = True
    start_cursor = None
    while more_data:
        # 如果有分页，添加cursor参数到请求中
        if start_cursor:
            url_with_cursor = f"{url}?start_cursor={start_cursor}"
        else:
            url_with_cursor = url
        response = requests.get(url_with_cursor, headers=headers)
        if response.status_code == 200:
            data = response.json()
            all_blocks.extend(data.get('results', []))  # 添加当前页的blocks到总列表
            more_data = data.get('has_more', False)  # 检查是否还有更多数据
            start_cursor = data.get('next_cursor')  # 获取下一个cursor
        else:
            raise Exception(f"Failed to fetch content: {response.status_code}, URL: {url_with_cursor}")
    return all_blocks
content = get_content(page_id,notion_integration_token)
print(content)

簡單變數說明：

  • more_data：檢查是否有子 block ，某些塊的 Type 是帶有子資料，我們需要將子資料也找出來。
  • startcursor：如果有子 block ，加入 startcursor 参数。
  • all_blocks ：用來儲存所有的資料

page_id：可以從頁面連結中取得。例如說：https://www.notion.so/lashiblog/Notion-43d892c22a0d4b90a566c8cb22d5785d?pvs=4。其中 “43d892c22a0d4b90a566c8cb22d5785d” 就是id，輸入程式時，請加上”-”。

mynotion_20240805-4.png

你取得資料為所有的 blocks ，但我們只是想要 blocks 的內容的部份。

mynotion_20240805-5.png

步驟三：將 Block 轉成 HTML 資料

找到 Page Content 的資料後，在上傳到 WordPress 之前，我們還需要一個重要的動作，就是將資料轉換成 WordPress 可以讀取的內容，像是 HTML 檔案。

怎麼做呢? 我們可以輸入程式：

elements = []
full_content = ''
for i in content:
    block_type = i['type']
    content_data = i.get(block_type, {})
    rich_text_list = content_data.get("rich_text", [])
    for rt in rich_text_list:
        if rt['type'] == 'text':
            text_content = rt["text"]["content"]
            link = rt["text"].get("link")
            if link:
                text_content = f'<a href="{link["url"]}">{text_content}</a>'
            full_content += text_content
    if block_type == 'heading_2':
        elements.append(f"<h2>{full_content}</h2>")

簡單變數說明：

  • elements：儲存 HTML
  • full_content：轉化成 HTML 的文字格式
  • block_type：block 格式
  • richtextlist ：儲存 rich_text 的內容
  • if blocktype == 'heading2' ：假如 type 為 heading_2 ，就…

這步驟困難在於轉換成 HTML 時，需要考慮許多不同的格式，包含 H2 大標題、H3 小標題、Text 文字、Image 圖片…等，所有我們可能會用到的格式。

上面的的範本只有 H2 喔! 剩下的，請看下去…

步驟四：上傳資料到 WordPress

什麼是 WordPress RestAPI?

WordPress RestAPI 是一種讓開發者能夠透過 HTTP 請求與 WordPress 網站互動的工具。透過這個 API，開發者可以讀取、創建、更新及刪除網站的文章、頁面、媒體等內容，並且可以進行使用者認證等操作。它使得開發者可以更方便地整合 WordPress 資訊到其他應用程式或服務中。

更多完成的文件：Reference – REST API Handbook | Developer.WordPress.org

怎麼啟用 REST API ?

要啟用 WordPress REST API，通常不需要額外的步驟，因為從 WordPress 4.7 版本開始，REST API 已經內建在 WordPress 中。不過，我們還是一些動作，來確認你的 WordPress REST API 是否正常運作。

測試 REST API：可以通過訪問以下 URL 來測試 REST API 是否運作正常。

<https://yourdomain.com/wp-json/wp/v2/posts>

如果 REST API 正常運作的話，應該看得到文章的資訊，如果失敗的話，有些主題或插件可能會限制 REST API 的功能。檢查是否有安裝任何可能會影響 REST API 的插件，例如安全性插件可能會禁用 API 端點。

mynotion_20240805-6.png

設置 WordPress API 帳戶

在寫程式之前，建議你創建一個新帳戶，具有編輯權限的用戶，以便 API 可以進行文章的發布和管理。

Step1. 新增使用者

請登入自己網站的 WordPress 後台頁面，在功能欄找到「使用者」→ 新增使用者，並輸入下列設定，然後新增。

  • 使用者名稱 → MyNotion (自定)
  • 電子郵件 → 自訂，請輸入到頁面的 「WordPress Acount Name」
  • 使用者角色 → 編輯
Mynotion_step3-1-e1673146950336.png

Step2. 設定權限

Mynotion_step3-2-e1673147994123.png

Step3. 新增應用程式密碼

新增後，請進入其使用者的頁面，在頁面的下方找到「應用程式密碼」，新增一個應用程式密碼。

Mynotion_step3-3-e1673148048431.png

▼ 請將反白的密碼複製下來，貼到個人頁面的 「WordPress App Password」中。

Mynotion_step3-4-e1673148085531.png

寫個自動上傳程式

完成後，我們將帳戶和應用程式密碼先存在文件中。

再來，我們可以輸入程式：

headers = {
         "Content-Type": "application/json",
          "User-Agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
}
data = {
    "title": title,
    'slug':slug,
    "content": content,
    "status": "publish",
}
response = requests.post(f"{wp_url}/wp-json/wp/v2/posts", headers=headers, json=data,auth=(wp_user, wp_password))

總結

恭喜親愛的朋友看到這裡，坦白說從程式小白到完整寫完程式，到現在我請 AI 幫我更完整它，可能也花了兩年左右的時間。總之，完整的程式早就開放在網路上，更完整的內容和使用方法，請看： NotionPress ：簡單地將 Notion 文章同步到 WordPress

免費下載喔!

Read more

WooCommerce 教學指南：基本設定簡介

完成安裝、物流金流設定後，還有一些設計我們可以看一下。 在 WooCommerce 中，設置功能非常重要，它能幫助你設定你的網店的所有基本和進階設定。 在管理頁面中，你可以看到左側欄目有一個名為「設定」的選項，這裡包含了關於商店的很多設定部分。 一開始可能會有點複雜，但不用擔心。因為設定都可以修改，那我們就一步一步地完成它吧。 以下是一些 WooCommerce 設定中的主要部分： 1. 一般設定： * 設置商店的基本資訊，比如商店地址、銷售地區、貨幣等。 2. 產品設定： * 管理產品頁面，包括產品的尺寸單位、評論設定以及庫存管理。 3. 運送方式： * 設定運送地區和費用的選項，可以根據不同地區設定不同的運費方案。 4. 付款： * 管理可供客戶選擇的付款方式，像是信用卡、銀行轉帳、第三方支付平台等。 5. 帳號及隱私權： * 設定客戶帳號的註冊和登入方式，以及管理客戶的隱私設定。 6. 電子郵件： * 在這裡你可以設定系統發送給客戶的各類通知，比如訂單確認、發票等。

By Oscar Chuang

想讓你的產品快速曝光嗎？如何在 WooCommerce 添加新產品

想知道如何快速上架新產品嗎？了解如何輕鬆添加新產品到你的 WooCommerce 商店，讓你的客戶更加便捷地找到心儀的商品！ 配置正確的產品類別和標籤，能有效增強顧客的購物體驗和提高銷售量，這可是每個電商商家必備的技能！ 如何添加新產品 Step1. 點擊「新增」 進入後台，找到 WooCommerce 選擇商品，點擊「新增」選項。 Step2. 商品設定 以我的客戶的商品為例，我們可以設定： * 商品標題 * 商品說明 * 商品圖片 * 商品圖庫 * 商品資料 * 商品簡短說明 這些設定都對應我們前端網頁的內容。 商品資料可以選擇： 1. 簡單商品 * 用途：這是最基本的商品類型。適用於沒有任何變種、額外選項或是需要特殊配置的單一產品。例如，一本書或一件無需選擇大小或顏色的T恤。 * 特點：設置簡單，只需填寫基本信息如價格、庫存等。 1. 組合商品 * 用途：用於銷售由多個已有商品組合而成的套裝產品。這適合那些想要以套裝形式出售多個產品以提供更好的價值的商家。 * 特點：顧客可以購買包含多個單獨商品的組合包，

By Oscar Chuang

2025 台灣人最適合的加密貨幣交易所：MAX 使用指南

如何註冊 Max 交易所：享 20% 手續費優惠 用我的推薦碼：dfe4b014 註冊，立享 20% 手續費折扣！ 掃描下方 QR Code，也能快速加入👇 Step1.建立帳號 請選擇「個人戶」並輸入可以收發 Email 的電子郵件地址。 設定你的密碼和打勾「我已滿 20 歲」，記得看看 使用條款和服務條款。 Step2. 啟用帳號： EMail 驗證 Step3. Lv1 的帳號驗證 請依續完成： * 手機號碼 * 基本資料驗證 * 台灣國籍或是 ARC 身分驗證 Step4. 進階認證：Lv2 的帳號驗證 請依續完成： * 台灣手機號碼 * 銀行帳號驗證 完成

By Oscar Chuang

【MAX 交易所安全嗎】3 個指標幫助我們選擇交易所 | 讀者優惠

元宇宙是現下最流行的話題，在 20 年前如果錯過 WEB 投資機會，這次的元宇宙可能是更好、更為龐大和成熟的市場。 在網路世代的我們，數位生活和數位工具的應用就是一種趨勢，你可以試想一下，如果你可以在家透過網路和電腦來工作，下班後到附近的海邊散步。 由於是在家工作，所以不需要住在人潮擁擠的地方，每年安排 1-2 次出國，而且一待就是一個月，反正工作只需要網路就可以。 在工作和生活中找到平衡，也不用付擔住在市區的高房價問題，彈性的工作和生活，讓你活得更加健康也能為早點安排退休的生活。 大叔覺得這才是元宇宙為我們生活帶來意義，我們不可能像電影一級玩家一樣，多數時間都活動在虛擬世界，因為 AR 和 VR 不太可能取代我們現有的體驗和生活。 但它可以帶我們生活新樣貌，所以更有可能是「共存」，而不太可能是「取代」，就像電影最後，我們還是要和愛的人上上館子，多抱抱他們，這才是現實生活。 如果我們要投資元宇宙的話，AR 和 VR 的設備商可以是一種選擇，但虛擬世界的最強大基本支撐其實是「加密貨幣」。 想像一下，我們如果在元宇宙的世界裡，

By Oscar Chuang