blog-pro-max 1.0.34

自動化 SEO 內容創作與部落格文章生成工具

blog-pro-max

自動化 SEO 內容創作與部落格文章生成工具。支援一鍵將寫作 Skill 注入到 18 種 AI 編輯器與 Assistant。

功能亮點

• AI 驅動寫作：根據關鍵字自動進行內容研究並生成 SEO 最佳化的部落格文章。
• 品牌風格一致性：自動套用品牌寫作風格規範（writing-style.md）。
• 內建風格檢查器：自動驗證產出內容是否符合排版與語氣規範。
• 多樣化模板：支援多種寫作風格（SEO 專業 / Max 個人風格 / FB 貼文 / LINE 訊息）。
• 三維度審稿專家：邏輯與事實、深度與結構、讀者視角三位專家審查，附問題點與修改前後對比。
• 時事趨勢專家：透過 DuckDuckGo 搜尋當前時事後注入 LLM，分析文章與真實趨勢的關聯，提供切入角度、高流量關鍵字/Hashtag、內容改寫示範（需安裝 ddgs，詳見 FAQ）。
• 標題專家：產出 4 個風格不同的標題建議（含英文 WordPress permalink），附加到輸出檔案供人工選擇。
• 封面提示詞專家：產出 3 組 AI 繪圖提示詞（Midjourney / DALL-E / Stable Diffusion），附加到輸出檔案。
• 插話專家：針對每個段落提供一個具體舉例說明，幫助讀者更容易理解核心概念。
• 插畫專家：針對每個段落產出 3 組風格（寫實攝影、插畫、極簡圖示）的 AI 圖片提示詞，作為段落示意圖。
• 唱反調專家：針對每個段落提出反駁觀點與建議回應，幫助作者預先化解讀者質疑、強化說服力。
• 發散專家：針對每個段落運用想像力與獨創力，從一個概念延伸到相關話題與跨領域聯想，發現更多寫作方向。
• 問題專家：針對每個段落提出 3-5 個讀者可能浮現的疑問，幫助作者發現論述缺口，也可作為 FAQ 靈感。
• 迷因專家：針對每個段落提出迷因、梗圖與幽默元素關鍵字，讓嚴肅內容更輕鬆有趣、容易分享。
• AI Skill 注入：一鍵將 Prompt 與工具鏈注入到 Claude Code, Cursor, GitHub Copilot 等 18 種平台。
• 自動格式轉換：內建 Markdown 轉 HTML 引擎，支援代碼高亮與 SEO 優化排版。

---

快速開始（5 分鐘上手）

YouTube 教學: https://youtu.be/nLnFU_Bk93s

Step 1：安裝

從 PyPI 安裝（推薦使用者）

pip install blog-pro-max

# 選用：啟用時事趨勢分析的 Web Search 功能（DuckDuckGo，免費）
pip install "blog-pro-max[web]"
# 或直接：pip install ddgs

安裝後您將獲得 blogpro 全域指令。

從 GitHub 安裝（開發者）

git clone https://github.com/max32002/blog-pro-max.git
cd blog-pro-max
pip install -e .

Step 2：設定 API 金鑰（僅 Script Mode 需要）

💡 如果你只使用 Skill Mode（透過 AI Assistant 生成文章），可跳過此步驟。 AI Assistant 使用自己內建的 LLM 能力，不需要額外的 API 金鑰。

只有在直接執行 Python 腳本（Script Mode）時，才需要設定 API 金鑰。

在您的工作目錄建立 .env 檔案：

# 推薦：GitHub PAT（免費，不需 OpenAI 帳號）
GITHUB_TOKEN=ghp_your-token-here

# 或：OpenAI API Key
OPENAI_API_KEY=sk-your-key-here

Step 3：注入 Skill 到您的 AI Assistant

blogpro init --ai claude      # 針對 Claude Code
blogpro init --ai copilot     # 針對 GitHub Copilot
blogpro init --ai cursor      # 針對 Cursor
blogpro init --ai all         # 注入到所有支援的平台

Step 4：開始創作

在已注入 Skill 的 AI Assistant 中直接輸入：

/blog-pro-max 寫一篇[AI 寫作工具]文章,受眾[內容行銷人員],以專業SEO風格

---

AI Assistant 整合支援

blog-pro-max 支援將寫作能力無縫整合進 18 個 AI 助手平台：

分類	平台	--ai 參數
專業開發工具	Claude Code	claude
	Cursor	cursor
	Windsurf	windsurf
	Trae	trae
	Roo Code	roocode
擴充套件	GitHub Copilot	copilot
	Continue	continue
	CodeBuddy	codebuddy
	OpenCode	opencode
	Augment	augment
終端機 / CLI	Gemini CLI	gemini
	Codex CLI	codex
	Warp	warp
新興 Agent	Antigravity	antigravity
	Kiro	kiro
	Qoder	qoder
	Droid (Factory)	droid
	KiloCode	kilocode

全域安裝（適用於電腦上所有專案）

blogpro init --ai all --global

---

使用方式

API 金鑰需求一覽：

模式	需要 API 金鑰？	說明
Skill Mode	❌ 不需要	AI Assistant 用自己的 LLM 生成
Workflow Mode	❌ 不需要	同上
Script Mode	✅ 需要	Python 腳本直接呼叫 OpenAI / GitHub Models

Skill Mode（自動啟動）

支援平台： Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment

安裝 Skill 後，AI Assistant 會自動讀取 SKILL.md，您只需用自然語言下達指令：

幫我寫一篇關於「遠端工作生產力」的 SEO 文章，目標讀者是科技業上班族

或是先貼上參考資料，再要求 AI 根據這些資料生成文章：

以下是我收集的資料：
[貼上你的資料]

請根據以上資料，用標準模板寫一篇文章，受眾是一般讀者。

用 Max 的風格寫一篇「失去才懂珍惜」的心情筆記

幫我寫一篇「時間管理」的 Facebook 貼文，受眾是上班族

用 LINE 訊息風格分享一篇「讀書心得」，讓朋友看得輕鬆

檢查 output/my-article.md 的寫作風格

Skill Mode 輸出行為

依 AI 平台能力分兩種模式：

AI 類型	範例平台	輸出方式
可執行腳本	Claude Code, Cursor, Windsurf	執行 Python 腳本，自動產出 .md + .html 檔案
純 LLM 生成	Gemini CLI, 一般聊天模式	直接生成文字輸出，詢問是否存檔為 .md

💾 如果 AI 沒有自動觸發存檔，請手動輸入：

save .md and .html

AI 會將文章存成 output/關鍵字.md 與 output/關鍵字.html。

兩種模式都會完整輸出所有 12 個區塊：

• 文章本文（依選定模板格式）
• ## 🔬 邏輯與事實專家審查報告
• ## 📐 深度與結構專家審查報告
• ## 👁️ 讀者視角專家審查報告
• ## 📰 時事趨勢分析報告
• ## 📝 推薦標題選項（4 個標題 + WordPress permalink）
• ## 🎨 推薦封面提示詞（3 組 AI 繪圖 prompt）
• ## 🌀 發散專家建議
• ## ❓ 問題專家建議
• ## 😂 迷因專家建議
• ## 💬 插話專家建議
• ## 🖼️ 插畫專家建議
• ## 🔴 唱反調專家報告

Workflow Mode（斜線命令）

支援平台： Kiro, GitHub Copilot, Roo Code, KiloCode

使用斜線命令精確控制生成參數：

/blog-pro-max 寫一篇[遠端工作生產力]文章,受眾[科技業上班族],以專業SEO風格

/blog-pro-max 寫一篇[失去才懂珍惜]文章,受眾[一般讀者],以作家Max風格

/blog-pro-max 寫一篇[時間管理心得]文章,受眾[上班族],以FB風格

/blog-pro-max 寫一篇[讀書心得分享]文章,受眾[大學生],以LINE風格

/blog-pro-max 寫一篇[Python 入門指南]文章,受眾[程式初學者],字數[2000]

斜線命令解析規則

語法	對應參數	範例
[關鍵字]（第一個方括號）	--keyword	[遠端工作生產力]
受眾[值]	--audience	受眾[科技業上班族]
字數[N]	--word-count	字數[2000]
作家Max風格 / 心情筆記	--template max-personal-style
SEO風格 / 專業風格 / 部落格風格	--template blog-skill-content
FB風格 / Facebook風格 / 臉書風格	--template fb-post-style
LINE風格 / LINE訊息 / 賴風格	--template line-message-style
幫我取標題 <路徑>	呼叫標題專家	幫我取標題 output/article.md
幫我生成封面 <路徑>	呼叫封面提示詞專家	幫我生成封面 output/article.md
全科檢查 <路徑>	三位專家全面審查	全科檢查 output/article.md
檢查邏輯 <路徑>	邏輯與事實專家	檢查邏輯 output/article.md
檢查結構 <路徑>	深度與結構專家	檢查結構 output/article.md
檢查讀者 <路徑>	讀者視角專家	檢查讀者 output/article.md
分析趨勢 <路徑>	時事趨勢專家	分析趨勢 output/article.md
插話建議 <路徑>	插話專家：每段落舉例說明	插話建議 output/article.md
段落插畫 <路徑>	插畫專家：每段落 3 組 AI 圖片提示詞	段落插畫 output/article.md
唱反調 <路徑>	唱反調專家：每段落反駁觀點	唱反調 output/article.md
發散思考 <路徑>	發散專家：每段落延伸相關話題與聯想	發散思考 output/article.md
提出問題 <路徑>	問題專家：每段落提出 3-5 個相關問題	提出問題 output/article.md
迷因建議 <路徑>	迷因專家：每段落提出迷因/幽默關鍵字	迷因建議 output/article.md
檢查風格 <路徑>	執行 style_checker	檢查風格 output/article.md
列出模板	列出可用模板
專案狀態	顯示專案狀態報告

Script Mode（直接執行）

不透過 AI Assistant，直接在終端機執行：

# 生成文章
python -m blog_pro_max.content_research --keyword "Python 基礎教學" --template blog-skill-content

# 關鍵字太長？從檔案讀取（兩種方式皆可）
python -m blog_pro_max.content_research --keyword @topic.txt
python -m blog_pro_max.content_research --keyword-file topic.txt

# 只看 prompt（不呼叫 API）
python -m blog_pro_max.content_research --keyword "Python 基礎教學" --dry-run

# 檢查現有 Markdown 檔案風格
python -m blog_pro_max.content_research --keyword "Python" --check-only output/my-article.md

---

CLI 指令參考

初始化與管理

• blogpro init: 偵測環境並注入 Skill 檔案。
• blogpro uninstall: 移除已注入的 Skill。
• blogpro versions: 檢查版本與已安裝的平台狀態。
• blogpro update: 同步更新所有平台的 Skill 檔案至最新版。

Skill 對話中的斜線命令

在 AI 助理對話框中（啟用 SKILL.md 後）可使用以下命令：

命令	說明
/blog [關鍵字]	以預設模板生成文章
/blog [關鍵字] --template [模板名]	指定模板
/blog [關鍵字] --audience [受眾]	指定目標受眾
/blog [關鍵字] --language [語言]	指定輸出語言（如 en、ja，預設：繁體中文）
/blog --list-templates	列出所有可用模板
/blog --status	顯示目前設定狀態（模板、路徑等）

---

生成 Pipeline

文章生成時會自動執行完整 pipeline（全部 12 個區塊皆自動輸出）：

文章生成 → 風格檢查 → 三維度審稿(邏輯/結構/讀者) → 時事趨勢分析 → 標題建議(4個+permalink) → 封面提示詞(3組) → 發散專家 → 問題專家 → 迷因專家 → 插話專家 → 插畫專家 → 唱反調專家 → MD→HTML

每個步驟的失敗不會阻擋後續步驟。最終輸出的 .md 和 .html 包含：

• 文章本文
• 三維度審稿報告（含問題點、修改建議、修改前後對比）
• 時事趨勢報告（趨勢關聯、切入角度、關鍵字/Hashtag、改寫示範）
• 推薦標題選項（含英文 WordPress permalink）
• 推薦封面 AI 繪圖提示詞
• 發散專家建議（每段落延伸方向與後續文章題目）
• 問題專家建議（每段落 3-5 個讀者疑問）
• 迷因專家建議（每段落迷因/幽默關鍵字）
• 插話專家建議（每段落具體舉例說明）
• 插畫專家建議（每段落 3 組風格 AI 圖片提示詞）
• 唱反調專家報告（每段落反駁觀點與建議回應）

內部角色

角色	說明
🔬 邏輯與事實專家	數據正確性、邏輯一致性、錯別字、AI 幻覺偵測
📐 深度與結構專家	遺漏面向、段落轉折、論述深度、結構平衡
👁️ 讀者視角專家	口吻適配、易讀性、注意力留存、情感共鳴
📰 時事趨勢專家	趨勢關聯分析、切入角度、關鍵字/Hashtag、改寫示範
📝 部落格標題專家	產出 4 個風格標題（直述、提問、數字、情感）+ 英文 permalink slug
🎨 封面提示詞專家	產出 3 組 AI 繪圖 prompt（寫實攝影、插畫、極簡設計）
🌀 發散專家	針對每個 H2 段落延伸相關話題、跨領域聯想，提供後續文章題目建議
❓ 問題專家	針對每個 H2 段落提出 3-5 個讀者可能浮現的疑問
😂 迷因專家	針對每個 H2 段落提出迷因/梗圖/幽默關鍵字，讓氣氛輕鬆
💬 插話專家	針對每個 H2 段落提供一個具體舉例說明，建議插入位置
🖼️ 插畫專家	針對每個 H2 段落產出 3 組風格（寫實攝影、插畫、極簡圖示）的 AI 圖片提示詞
🔴 唱反調專家	針對每個 H2 段落提出反駁觀點、理由，並建議如何回應

---

參數說明

參數	說明	預設值
--keyword	核心關鍵字，或 @檔案路徑 從檔案讀取	—
--keyword-file	從指定檔案讀取關鍵字（替代 --keyword）	—
--audience	目標讀者（如：初學者、資深工程師）	30-45 歲知識工作者
--word-count	目標字數	1200
--template	寫作風格模板 (blog-skill-content / max-personal-style / fb-post-style / line-message-style)	blog-skill-content
--check-only	僅對指定檔案執行風格檢查	—
--dry-run	顯示 prompt 但不呼叫 API	—
--model	OpenAI 模型名稱	gpt-4o
--output	自訂輸出路徑	output/{keyword}.md

💡 提示：--keyword 和 --keyword-file 二擇一，至少提供一個。當關鍵字很長（如完整的文章主題描述），建議寫入檔案後使用 @ 語法讀取。

---

授權

本專案採用 MIT License 授權。 歡迎提交 Issue 或 Pull Request 參與貢獻！

---

更新到最新版本

方法一：從 PyPI 更新（pip 安裝用戶）

# 更新套件
pip install --upgrade blog-pro-max

# 更新後，刷新所有已安裝平台的 Skill 檔案
blogpro update

blogpro update 會自動掃描並重新安裝所有已安裝的平台（本地 + 全域），讓 AI 助手使用最新版的指令與功能。

方法二：從 GitHub 更新（git clone 用戶）

cd blog-pro-max
git pull
pip install -e .

# 同樣需要刷新 Skill
blogpro update

確認當前版本

blogpro versions

輸出範例：

📦 blog-pro-max
  目前版本：v1.0.20

🔌 本地已安裝平台：
  ✅ claude    v1.0.20  .claude/skills/blog-pro-max/
  ✅ copilot   v1.0.20  .github/skills/blog-pro-max/

---

📚 延伸文件

文件	說明
docs/architecture.md	系統架構說明：模組職責分工、目錄結構、完整生成 Pipeline 流程圖、函式參考表，適合想深入了解工具內部運作的開發者閱讀
docs/scripts-reference.md	腳本完整參考手冊：6 個腳本的所有函式簽名、參數說明、回傳格式範例、獨立使用情境與範例指令，以及 Skill Mode 斜線命令速查表
docs/faq.md	常見問題 FAQ：25+ 個 Q&A，涵蓋安裝設定、API 金鑰選擇、Skill 注入、各專家功能說明、輸出格式、疑難排解等