OpenSEO 的這個教學只處理標題中的具體任務。 Cloudflare 部署只是應用程式託管層，關鍵字、排名、外鍊和稽核資料仍由 DataForSEO 計費；MCP 存取還需要單獨控制身分、專案範圍和預算。
以下所有操作都先放在測試儲存庫、測試帳號或僅回環監聽的服務中。指令中的網域名稱、使用者名稱、路徑與金鑰是佔位符，執行前需要替換。
先拆開 Cloudflare 與 DataForSEO 的職責
這一節解決的是「先拆開 Cloudflare 與 DataForSEO 的責任」。先記錄目前狀態，再執行最小動作，最後用獨立證據確認結果。
對 OpenSEO 而言，判斷依據是：Cloudflare 部署只是應用託管層，關鍵字、排名、外鍊和稽核資料仍由 DataForSEO 計費；MCP 存取還需要單獨控制身分、專案範圍和預算。不要在這個階段順手打開更多權限。
|
|
執行後保留命令輸出和時間戳記。若輸出依賴目前終端機裡的臨時變量，開啟新終端複查一次。
建立獨立 Cloudflare 專案環境
按下面順序處理：
- 讀取實際版本和目前配置。
- 只改變與本節相關的一項設定。
- 執行一個唯讀或可撤銷的請求。
- 檢查日誌、退出碼和最終檔案。
- 失敗時恢復剛才那一項修改。
|
|
這裡的完成標準不是介面出現，而是「建立獨立 Cloudflare 專案環境」有可重複結果。
DataForSEO Key 不應該放在哪裡
| 要檢查的內容 | 合格表現 | 需要停止的信號 |
|---|---|---|
| DataForSEO Key 不應該放在哪裡 | 輸入和輸出範圍明確 | 自動擴大到其他項目或帳號 |
| 權限 | 只獲得完成任務所需權限 | 要求管理員權限或完整金鑰 |
| 日誌 | 能定位失敗且已經脫敏 | 出現 Token、Cookie 或私有正文 |
| 回退 | 能恢復上一步狀態 | 修改不可逆且沒有備份 |
|
|
表格中的停止訊號一旦出現，先撤銷本節改動，不要繼續後面的自動化。
用 wrangler 檢查目前帳戶
圍繞「用 wrangler 檢查目前帳戶」準備一個成功樣本和一個失敗樣本。成功樣本驗證正常路徑，失敗樣本驗證限制是否真的生效。
|
|
建議記錄以下四項：
- 執行前的版本或 Git 提交。
- 實際輸入，不記錄秘密值。
- 可觀察的輸出、狀態碼或 diff。
- 恢復動作以及恢復後的複查結果。
如果失敗原因仍不清楚，每次只修改一個變數；不要同時更換連接埠、執行時間、Provider 和代理程式。
資料庫和 Worker 配置的部署順序
這一節解決的是「資料庫和 Worker 配置的部署順序」。先記錄目前狀態，再執行最小動作，最後用獨立證據確認結果。
對 OpenSEO 而言，判斷依據是：Cloudflare 部署只是應用託管層，關鍵字、排名、外鍊和稽核資料仍由 DataForSEO 計費；MCP 存取還需要單獨控制身分、專案範圍和預算。不要在這個階段順手打開更多權限。
|
|
執行後保留命令輸出和時間戳記。若輸出依賴目前終端機裡的臨時變量，開啟新終端複查一次。
首次請求先選擇低成本任務
按下面順序處理：
- 讀取實際版本和目前配置。
- 只改變與本節相關的一項設定。
- 執行一個唯讀或可撤銷的請求。
- 檢查日誌、退出碼和最終檔案。
- 失敗時恢復剛才那一項修改。
|
|
這裡的完成標準不是介面出現，而是「首次請求先選擇低成本任務」有可重複結果。
為每類 SEO 查詢設定預算
| 要檢查的內容 | 合格表現 | 需要停止的信號 |
|---|---|---|
| 給每類 SEO 查詢設定預算 | 輸入和輸出範圍明確 | 自動擴大到其他項目或帳號 |
| 權限 | 只獲得完成任務所需權限 | 要求管理員權限或完整金鑰 |
| 日誌 | 能定位失敗且已經脫敏 | 出現 Token、Cookie 或私有正文 |
| 回退 | 能恢復上一步狀態 | 修改不可逆且沒有備份 |
|
|
表格中的停止訊號一旦出現，先撤銷本節改動，不要繼續後面的自動化。
MCP Token 與網頁登入分開管理
圍繞「MCP Token 與網頁登入分開管理」準備一個成功樣本和一個失敗樣本。成功樣本驗證正常路徑，失敗樣本驗證限制是否真的生效。
|
|
建議記錄以下四項：
- 執行前的版本或 Git 提交。
- 實際輸入，不記錄秘密值。
- 可觀察的輸出、狀態碼或 diff。
- 恢復動作以及恢復後的複查結果。
如果失敗原因仍不清楚，每次只修改一個變數；不要同時更換連接埠、執行時間、Provider 和代理程式。
讓 Agent 只能存取指定項目
這一節解決的是「讓 Agent 只能存取指定項目」。先記錄目前狀態，再執行最小動作，最後用獨立證據確認結果。
對 OpenSEO 而言，判斷依據是：Cloudflare 部署只是應用託管層，關鍵字、排名、外鍊和稽核資料仍由 DataForSEO 計費；MCP 存取還需要單獨控制身分、專案範圍和預算。不要在這個階段順手打開更多權限。
|
|
執行後保留命令輸出和時間戳記。若輸出依賴目前終端機裡的臨時變量，開啟新終端複查一次。
觀察請求量與異常費用
按下面順序處理：
- 讀取實際版本和目前配置。
- 只改變與本節相關的一項設定。
- 執行一個唯讀或可撤銷的請求。
- 檢查日誌、退出碼和最終檔案。
- 失敗時恢復剛才那一項修改。
|
|
這裡的完成標準不是介面出現，而是「觀察請求量與異常費用」有可重複結果。
輪換金鑰時避免服務中斷
| 要檢查的內容 | 合格表現 | 需要停止的信號 |
|---|---|---|
| 輪換密鑰時避免服務中斷 | 輸入和輸出範圍明確 | 自動擴展到其他項目或帳號 |
| 權限 | 只獲得完成任務所需權限 | 要求管理員權限或完整金鑰 |
| 日誌 | 能定位失敗且已經脫敏 | 出現 Token、Cookie 或私有正文 |
| 回退 | 能恢復上一步狀態 | 修改不可逆且沒有備份 |
|
|
表格中的停止訊號一旦出現，先撤銷本節改動，不要繼續後面的自動化。
撤銷 Worker、MCP 和資料存取
圍繞「撤銷 Worker、MCP 和資料存取」準備一個成功樣本和一個失敗樣本。成功樣本驗證正常路徑，失敗樣本驗證限制是否真的生效。
|
|
建議記錄以下四項：
- 執行前的版本或 Git 提交。
- 實際輸入，不記錄秘密值。
- 可觀察的輸出、狀態碼或 diff。
- 恢復動作以及恢復後的複查結果。
如果失敗原因仍不清楚，每次只修改一個變數；不要同時更換連接埠、執行時間、Provider 和代理程式。
預覽環境與正式環境分開
這一節解決的是「預覽環境與正式環境分開」。先記錄目前狀態，再執行最小動作，最後用獨立證據確認結果。
對 OpenSEO 而言，判斷依據是：Cloudflare 部署只是應用託管層，關鍵字、排名、外鍊和稽核資料仍由 DataForSEO 計費；MCP 存取還需要單獨控制身分、專案範圍和預算。不要在這個階段順手打開更多權限。
|
|
執行後保留命令輸出和時間戳記。若輸出依賴目前終端機裡的臨時變量，開啟新終端複查一次。
DataForSEO 錯誤不要無限重試
按下面順序處理：
- 讀取實際版本和目前配置。
- 只改變與本節相關的一項設定。
- 執行一個唯讀或可撤銷的請求。
- 檢查日誌、退出碼和最終檔案。
- 失敗時恢復剛才那一項修改。
|
|
這裡的完成標準不是介面出現，而是「DataForSEO 錯誤不要無限重試」有可重複結果。
遷移前匯出專案設置
| 要檢查的內容 | 合格表現 | 需要停止的信號 |
|---|---|---|
| 遷移前匯出項目設定 | 輸入與輸出範圍明確 | 自動擴大到其他項目或帳號 |
| 權限 | 只獲得完成任務所需權限 | 要求管理員權限或完整金鑰 |
| 日誌 | 能定位失敗且已經脫敏 | 出現 Token、Cookie 或私有正文 |
| 回退 | 能恢復上一步狀態 | 修改不可逆且沒有備份 |
|
|
表格中的停止訊號一旦出現，先撤銷本節改動，不要繼續後面的自動化。
會計自託管的真實成本
圍繞「核算自託管的真實成本」準備一個成功樣本和一個失敗樣本。成功樣本驗證正常路徑，失敗樣本驗證限制是否真的生效。
|
|
建議記錄以下四項：
- 執行前的版本或 Git 提交。
- 實際輸入，不記錄秘密值。
- 可觀察的輸出、狀態碼或 diff。
- 恢復動作以及恢復後的複查結果。
如果失敗原因仍不清楚，每次只修改一個變數；不要同時更換連接埠、執行時間、Provider 和代理程式。
OpenSEO 常見問題
是否可以跳過測試環境，直接把 OpenSEO 用到正式專案？
不建議。至少先完成一次最小成功請求、一次故意失敗和一次恢復演練。
OpenSEO 指令能運行但結果不對，先查哪裡？
先查輸入範圍、實際生效的配置和上游響應，再查模型總結。進程正常不代表業務結果正確。
如何避免 OpenSEO 的金鑰或令牌進入 Git？
使用系統環境變數、Secret 管理或專案外設定文件，並在提交前搜尋 diff。發現洩漏後必須輪換密鑰。
升級 OpenSEO 時最容易漏掉什麼？
最容易漏掉配置格式、預設監聽位址、權限範圍和快取相容性。升級前儲存版本與驗證樣本。
OpenSEO 驗收問題
完成後應能回答下面的問題：
- 使用的是哪個確切版本？
- 哪些目錄、連接埠、帳號和外部服務可被存取？
- 成功結果如何回到原始資料或 Git diff？
- 上游失敗時會報錯、重試還是切換？
- 金鑰是否可能出現在日誌或歷史記錄？
- 如何在十分鐘內回到修改前狀態？
如果其中任何一項無法回答，OpenSEO 仍處於試用狀態，不應擴大權限或存取生產自動化。