菜单
Smart Blog Google API 整合。PageSpeed Insights + CrUX Core Web Vitals 查詢。 無 API key 時使用免費端點，有 key 時解鎖 CrUX 真實用戶數據。 Config 儲存於 ~/.config/smart-blog-skills/。 Use when user says "pagespeed", "core web vitals", "CrUX", "page speed", "網頁速度", "效能檢測", "smart-blog google", "google api setup".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Smart Blog 防幻覺部落格引擎。34 個子技能：寫、分析、改寫、大綱、摘要簡報、 編輯行事曆、關鍵字重疊偵測、圖表、事實查核、FLOW 框架、AI 引用優化、圖片生成、 多語言稽核、文化本地化、人設語氣、跨平台二創、Schema 標記、SEO 驗證、 分類標籤、翻譯、音訊旁白、NotebookLM、策略規劃、主題群組、多語言一鍵發布、 全站稽核、效能檢測、品質監控、llms.txt 生成、品牌提及掃描、SEO 漂移監控、 AI 爬蟲分析、受眾研究、反向連結分析。雙重優化 Google 排名（E-E-A-T）和 AI 引用平台 （ChatGPT、Perplexity、AI Overview）。繁體中文優先。 Use when user says "blog", "write blog", "smart-blog", "smart blog", "寫文章", "部落格", "blog post", "分析文章", "改寫", "大綱", "內容簡報", "blog outline", "analyze blog", "rewrite blog", "blog strategy", "blog brief".
Smart Blog 改寫。優化改寫現有部落格文章，先分析品質再針對性改善。 保留作者語氣，補充過時數據，Humanizer 反 AI 修正，YouTube 影片補充。 Use when user says "rewrite blog", "改寫文章", "優化文章", "blog rewrite", "smart-blog rewrite", "update blog".
Smart Blog 寫文章。從零寫一篇新的部落格文章，包含模板選擇、研究、 YouTube 影片嵌入、Humanizer 反 AI 審稿、品質檢查。 內建反幻覺驗證，繁體中文優先。 Use when user says "write blog", "寫文章", "寫部落格", "new blog post", "smart-blog write", "blog write".
Smart Blog 品質分析。5 大類 100 分評分，包含 Humanizer 29 模式 AI 偵測、 SEO 驗證、E-E-A-T 評估、PageSpeed 整合。支援 PDF 報告輸出。 Use when user says "analyze blog", "分析文章", "blog audit", "品質評分", "smart-blog analyze", "blog analyze".
Generate audio narration of blog posts using Google Gemini TTS. Supports summary narration, full article read-aloud, and two-speaker podcast/dialogue mode with 30 voice options. Outputs MP3 with HTML5 audio embed code. Works standalone via /smart-blog-skills:audio or internally from write. Falls back gracefully when API key is not configured. Use when user says "blog audio", "narrate blog", "audio version", "text to speech", "tts", "podcast mode", "read aloud", "audio narration", "voice", "narration", "generate audio".
Full-site blog health assessment scanning all blog files for quality scores, orphan pages, topic cannibalization, stale content, and AI citation readiness. Spawns parallel subagents for comprehensive analysis. Produces per-post scores and a prioritized action queue. Use when user says "audit blog", "blog audit", "site audit", "blog health", "audit all posts", "check all blogs".
| name | |
| description | Smart Blog Google API 整合。PageSpeed Insights + CrUX Core Web Vitals 查詢。 無 API key 時使用免費端點，有 key 時解鎖 CrUX 真實用戶數據。 Config 儲存於 ~/.config/smart-blog-skills/。 Use when user says "pagespeed", "core web vitals", "CrUX", "page speed", "網頁速度", "效能檢測", "smart-blog google", "google api setup". |
| user-invokable | true |
| argument-hint | [pagespeed|crux|setup] <URL> |
整合 Google PageSpeed Insights 和 CrUX API，為 blog analyze 提供真實效能數據。
| 指令 | 功能 | 需要 API Key |
|---|---|---|
/smart-blog-skills:google setup | 設定 API key | 否 |
/smart-blog-skills:google pagespeed <URL> | PageSpeed Insights 分析 | 否（建議有） |
/smart-blog-skills:google crux <URL> | CrUX 真實用戶數據 | 是 |
| Tier | 需要什麼 | 解鎖功能 | 限制 |
|---|---|---|---|
| 0（免費） | 無需任何設定 | PageSpeed Insights（無 key） | 25 次/天（共用配額，可能被限流） |
| 1（API Key） | Google Cloud Console 免費 API Key | PageSpeed（專屬配額）+ CrUX | PageSpeed 400 次/天，CrUX 150 次/天 |
/smart-blog-skills:google setup 輸入 key~/.config/smart-blog-skills/
├── config.json ← API key 和偏好設定
└── .gitignore ← 防止意外提交
{
"google_api_key": "",
"default_strategy": "mobile",
"locale": "zh-TW",
"created": "2026-04-06",
"updated": "2026-04-06"
}
chmod 600 config.json（Unix）~/.config/ 下，不會被 git commit* 排除規則SMART_BLOG_GOOGLE_API_KEY 環境變數mkdir -p ~/.config/smart-blog-skills
echo '*' > ~/.config/smart-blog-skills/.gitignore
問使用者：
要設定 Google API Key 嗎？
- 有 Key：輸入 key，解鎖 CrUX + 專屬 PageSpeed 配額
- 沒有 Key：按 Enter 跳過，仍可使用免費 PageSpeed（共用配額）
API Key 儲存在
~/.config/smart-blog-skills/config.json，不會進入 git。
將使用者提供的資訊寫入 ~/.config/smart-blog-skills/config.json。
chmod 600 ~/.config/smart-blog-skills/config.json
Windows 環境跳過此步驟（NTFS 權限由系統管理）。
~/.config/smart-blog-skills/config.jsongoogle_api_key 有值 → Tier 1 模式Tier 0（無 key）：
WebFetch: https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url={URL}&strategy=mobile&locale=zh-TW
Tier 1（有 key）：
WebFetch: https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url={URL}&strategy=mobile&locale=zh-TW&key={API_KEY}
從回傳的 JSON 提取：
| 指標 | 欄位路徑 | 好 | 待改善 | 差 |
|---|---|---|---|---|
| Performance Score | lighthouseResult.categories.performance.score | ≥0.9 | 0.5-0.89 | <0.5 |
| FCP | lighthouseResult.audits.first-contentful-paint | ≤1.8s | 1.8-3s | >3s |
| LCP | lighthouseResult.audits.largest-contentful-paint | ≤2.5s | 2.5-4s | >4s |
| TBT | lighthouseResult.audits.total-blocking-time | ≤200ms | 200-600ms | >600ms |
| CLS | lighthouseResult.audits.cumulative-layout-shift | ≤0.1 | 0.1-0.25 | >0.25 |
| Speed Index | lighthouseResult.audits.speed-index | ≤3.4s | 3.4-5.8s | >5.8s |
## PageSpeed 報告：{URL}
**策略：** Mobile
**Performance Score：** {score}/100
### Core Web Vitals
| 指標 | 數值 | 狀態 |
|------|------|------|
| LCP（最大內容繪製） | {value} | {好/待改善/差} |
| FCP（首次內容繪製） | {value} | {好/待改善/差} |
| TBT（總阻塞時間） | {value} | {好/待改善/差} |
| CLS（累積版面偏移） | {value} | {好/待改善/差} |
| Speed Index | {value} | {好/待改善/差} |
### 改善建議（前 5 項）
| 優先級 | 問題 | 預估節省 |
|--------|------|---------|
| {高/中/低} | {描述} | {時間} |
WebFetch: https://chromeuxreport.googleapis.com/v1/records:queryRecord?key={API_KEY}
POST body:
{
"url": "{URL}",
"formFactor": "PHONE"
}
提取真實用戶的 Core Web Vitals 分佈（p75 值）：
附加到 PageSpeed 報告後方：
### CrUX 真實用戶數據（28 天）
| 指標 | p75 | 好 | 待改善 | 差 |
|------|-----|---|--------|---|
| LCP | {value} | {%} | {%} | {%} |
| INP | {value} | {%} | {%} | {%} |
| CLS | {value} | {%} | {%} | {%} |
當使用者執行 /smart-blog-skills:analyze 且文章的 frontmatter 包含 url 或 canonical 欄位時：
這讓 analyze 的「技術元素」類別（15 分）可以基於真實數據評分，而非只檢查 HTML 結構。
| 情境 | 行為 |
|---|---|
| 無 API Key + 被限流 | 提示使用者申請免費 API Key |
| API Key 無效 | 提示檢查 key，退回 Tier 0 |
| URL 無法存取 | 報告錯誤，跳過效能檢測 |
| CrUX 無數據 | 說明該 URL 流量不足，CrUX 無法提供數據 |