name: marketing-plan-generator description: 本地生活餐飲商家營銷策劃方案生成器。基於大眾點評截圖和商家資訊，自動生成包含10個板塊的標準化營銷方案，支援儲存為Markdown檔案、上傳到釘釘文件，以及生成PPT簡報。適用於餐飲、咖啡、烘焙等本地生活類商家的小紅書/抖音/點星營銷策劃。當用戶需要為餐飲/咖啡/烘焙商家建立營銷策劃方案、基於大眾點評截圖分析商家資料、設計小紅書/抖音/點星的內容投放策略、制定達人投放預算和ROI預期、輸出可執行的內容brief和話術庫時觸發。

本地生活營銷策劃方案生成器

基於大眾點評截圖和商家資訊，自動生成標準化的10板塊營銷策劃方案，並輸出為 Markdown、釘釘文件或 PPT。

觸發條件

當用戶需要以下場景時觸發： 1. 為餐飲/咖啡/烘焙商家建立營銷策劃方案 2. 基於大眾點評截圖分析商家資料 3. 設計小紅書/抖音/點星的內容投放策略 4. 制定達人投放預算和ROI預期 5. 輸出可執行的內容brief和話術庫

使用流程

第一步：收集商家資訊

從使用者或大眾點評截圖中獲取：

第二步：生成方案

按照標準10板塊模板生成完整方案：

1. 商家基礎資訊 - 整理商家核心資料
2. 使用者評價深度洞察 - 情感分析、賣點排序、機會點、負面預警
3. 策略定位 - 差異化定位 + 策略依據
4. 平臺策略 - 三平臺配比和任務分工
5. 內容矩陣 - 素人/腰部/頭部的數量和方向
6. 內容選題 - 主路線、副路線、差異化路線
7. 關鍵話術庫 - 按場景分類的使用者原話風格話術
8. 執行細節 - 素人要求、腰部/頭部達人Brief
9. 預算板塊 - 各層級數量、單價、預算區間

詳細模板結構參考：references/template.md
AI生成提示詞參考：references/ai-prompts.md
成功案例參考：references/examples.md

第三步：輸出交付

支援四種輸出格式：

1. Markdown 檔案 - 儲存到工作區 plans/ 目錄
2. 騰訊文件 - 使用 qclaw_tdoc_mcp_call 直接建立智慧文件（推薦）
3. PPT 簡報 - 使用 scripts/generate_ppt_v4.py 生成 .pptx
4. HTML 幻燈片 - 使用 scripts/generate_html_slides.py 生成 .html（瀏覽器直接開啟，支援鍵盤導航）

預算配置

前提資訊

• 總預算金額（具體數字，如 ¥20,000）
• 城市（上海/杭州/南京/蘇州/寧波）
• 主推平臺（小紅書 / 抖音 / 點星）
• 要爆文號（是/否，如要則預留30%預算）
• 是否需要出鏡（達人是否需要出鏡拍攝）

達人價格參考

詳見 references/kol_price_table.json

精算原則： - 素人層：0元現金預算，只展示數量（套餐置換模式） - 腰部層：千粉:萬粉 = 2:1（數量比，即千粉篇數:萬粉篇數 = 2:1），按城市和平臺查表取單價 - 默認不出鏡價格（參考 kol_price_table.json） - 如上海小紅書：千粉¥100，萬粉¥200 - 如南京小紅書：千粉¥160，萬粉¥240 - 重要：2:1 指的是達人數量比例，不是預算比例 - 爆文號：如需要則預留30%預算，只展示金額不展示數量 - 按城市單價表精算，允許最低限度超出預算

預算分配公式（以上海小紅書、¥14,000預算、要爆文號為例）：

⚠️ 關鍵：2:1 指的是數量比（千粉篇數:萬粉篇數 = 2:1），不是預算比！

總預算：¥14,000

爆文號預留 30%：¥4,200（只展示金額，不展示數量）

腰部剩餘 70%：¥9,800
  ├─ 千粉（篇數是萬粉的 2 倍）：約49篇 × ¥100（上海千粉不出鏡）= ¥4,900
  └─ 萬粉（篇數是千粉的 1/2）：約24篇 × ¥200（上海萬粉不出鏡）= ¥4,800

素人：80篇（0元，套餐置換）

合計：¥13,900（允許最低限度超出）

注意：不同城市單價不同，計算時必須查 kol_price_table.json 獲取對應價格

指令碼使用

HTML 幻燈片生成

使用 HTML5 + CSS3 + Vanilla JS 實現，無需任何依賴：

# 從 JSON 資料生成
python3 scripts/generate_html_slides.py plan_data.json "輸出檔案.html"

特點： - 🎨 響應式設計，支援桌面/平板/手機 - ⌨️ 鍵盤導航（←→ 空格 PageUp/PageDown Home/End） - 📊 11頁完整結構：封面→商家資訊→洞察→策略→平臺→矩陣→選題→話術→執行→預算→結尾 - 🎯 現代化 UI：卡片佈局、漸變背景、高亮框、資料表格 - 🖨️ 支援列印（每頁自動分頁） - 🌐 單檔案 HTML，無需伺服器，瀏覽器直接開啟

JSON 欄位規範（與 PPT 生成器相容）：

{
  "merchant": { "name", "category", "location", "hours", "per_capita", "rating", "reviews", "tags", "goal", "budget" },
  "insight": { "positive_pct", "neutral_pct", "negative_pct", "top_selling_points", "opportunities", "risks" },
  "strategy": { "positioning", "reasons" },
  "platform": [{ "name", "goal", "tactics", "expected_result" }],
  "content_matrix": { "tier1", "tier2", "tier3", "viral" },
  "topics": { "main", "sub", "diff" },
  "scripts": [{ "scene", "script" }],
  "execution": { "amateur_req", "waist_brief", "head_brief", "viral_brief" },
  "budget": { "total_amount", "items" }
}

PPT 生成

使用 V4 版本生成器，支援以下特性： - 首頁標題簡潔，無重複文字 - 策略定位頁定位語高亮（橙色加粗） - 執行細節分4頁展示（素人/千粉/萬粉/爆文號） - 預算板塊使用表格形式呈現

# 從 JSON 資料生成
python3 scripts/generate_ppt_v4.py plan_data.json "輸出檔案.pptx"

# JSON 資料格式參考 scripts/example_plan_data.json

JSON 欄位規範（必須與指令碼匹配）：

{
  "merchant": { "name", "category", "location", "hours", "per_capita", "rating", "reviews", "tags", "goal", "budget" },
  "insight": { "positive_pct", "neutral_pct", "negative_pct", "top_selling_points", "opportunities", "risks" },
  "strategy": { "positioning", "reasons" },
  "platform": [{ "name", "goal", "tactics", "expected_result" }],
  "content_matrix": { "tier1", "tier2", "tier3", "viral" },
  "topics": { "main", "sub", "diff" },
  "scripts": [{ "scene", "script" }],
  "execution": { "amateur_req", "waist_brief", "head_brief", "viral_brief" },
  "budget": { "total_amount", "items" }
}

關鍵修復記錄（2026-05-18）： 1. 正文文本框篩選：s.top.inches > 1.5 → >= 1.5（模板文本框 top=1.50） 2. 執行細節清空邏輯：while len(tf.paragraphs) > 1 → > 0（完全清空避免殘留"正文內容..."） 3. 預算合計欄位：使用 total_amount 而非 total

PPT 頁面結構（15頁）： 1. 封面 2. 目錄 3. 商家基礎資訊 4. 使用者評價洞察 5. 策略定位（定位語高亮） 6. 平臺策略（三卡片） 7. 內容矩陣（四卡片） 8. 內容選題 9. 關鍵話術庫 10. 執行細節 - 素人置換 11. 執行細節 - 腰部達人（千粉） 12. 執行細節 - 腰部達人（萬粉） 13. 執行細節 - 爆文號 14. 預算板塊（表格） 15. 結尾頁

騰訊文件上傳

# 使用 qclaw_tdoc_mcp_call 建立智慧文件
qclaw_tdoc_mcp_call(
    tool_name="create_smartcanvas_by_mdx",
    arguments={
        "title": "商家名稱-營銷策劃方案",
        "mdx": "# 方案內容...",
        "content_format": "mdx"
    }
)

特點： - 無需預先建立文件，一鍵生成 - 智慧文件格式，排版美觀 - 支援完整 Markdown 語法 - 可直接分享連結給他人

注意事項

1. 必須獲取商家的大眾點評截圖才能準確分析
2. 總預算金額和核心訴求必須明確，影響整個方案結構
3. 話術庫必須基於真實使用者評價，不能編造
4. PPT 生成需要 python-pptx 庫（需手動安裝，見下方環境配置）

Python 環境配置

⚠️ Windows 使用者必讀：本 Skill 的 PPT 生成功能依賴 python-pptx 庫，需要手動安裝。

1️⃣ 檢查 Python 是否已安裝

開啟命令提示符（cmd.exe）或 PowerShell，輸入：

python --version
# 或
python3 --version

• ✅ 如果顯示版本號（如 Python 3.9.7），說明已安裝
• ❌ 如果提示"不是內部或外部命令"，需要先安裝 Python

下載 Python：訪問 https://www.python.org/downloads/ ，下載並安裝最新版（勾選 "Add Python to PATH"）

2️⃣ 安裝 python-pptx 庫

方法 1：使用 requirements.txt（推薦）

# 進入 skill 目錄
cd %USERPROFILE%\.qclaw\skills\marketing-plan-generator

# 安裝依賴
pip install -r requirements.txt

方法 2：直接安裝

# 使用 pip3（推薦）
pip3 install python-pptx

# 如果 pip3 不可用，嘗試 pip
pip install python-pptx

# 如果 pip 也不可用，使用 python -m pip
python -m pip install python-pptx

⚠️ Windows 常見問題

1. 提示"pip 不是內部或外部命令"： bash python -m pip install python-pptx

2. 提示"許可權不足"： bash pip install --user python-pptx

   發現更多技能外掛，請訪問7w4.net。

3. 提示"拒絕訪問"：

4. 右鍵點選命令提示符 → "以管理員身份執行"
5. 然後執行安裝命令

3️⃣ 驗證安裝

python -c "from pptx import Presentation; print('✅ python-pptx 已成功安裝！')"

• ✅ 如果顯示 ✅ python-pptx 已成功安裝！，說明安裝成功
• ❌ 如果提示 ModuleNotFoundError，說明安裝失敗，請檢查步驟 2

4️⃣ 測試 PPT 生成

# 進入 skill 目錄
cd %USERPROFILE%\.qclaw\skills\marketing-plan-generator

# 使用示例資料生成 PPT
python scripts\generate_ppt_v4.py scripts\example_plan_data.json 測試輸出.pptx

• ✅ 如果生成 測試輸出.pptx，說明環境配置成功
• ❌ 如果提示錯誤，檢查 template_v3.pptx 是否存在於 assets/ 目錄

5️⃣ HTML 幻燈片生成（無需額外依賴）

如果不想安裝 Python 依賴，可以使用 HTML 幻燈片生成器（無需任何依賴）：

python scripts\generate_html_slides.py scripts\example_plan_data.json 測試輸出.html

生成的 .html 檔案可以直接用瀏覽器開啟，支援鍵盤導航（←→），適合快速預覽和分享。

6️⃣ 依賴庫說明

如果不生成 PPT，只需安裝 requests：

pip install requests

參考檔案

這個營銷策劃方案工具質量很好，能自動生成專業的10板塊營銷方案，還支援匯出PPT和線上文件展示。操作流程清晰，收集完商家資訊就能一鍵生成完整方案。預算配置靈活，會根據不同城市自動計算達人投放數量。不過生成效果依賴輸入資訊的完整性，資訊越詳細方案越精準。作為餐飲商家營銷工具，專業度足夠，使用門檻也不高。