git:20260606.b0f0051 to git:20260608.0b5a87c

20 added, 20 removed. Audit A to A.

---

name: seo-keyword-mapper

sheetId: "1.18"

- description: "SEO 流程第四棒：用關鍵字工具（Ubersuggest / AnswerThePublic）把切角與種子字擴展成完整關鍵字地圖。對應 v2 流程圖「篩選關鍵字製作關鍵字地圖 + 整理完整關鍵字地圖」。當使用者交出 Angles 交棒包、貼上關鍵字工具匯出、說「做關鍵字地圖」時觸發。只做地圖，不分類意圖、不寫文章。"

+ description: "Fourth leg of the SEO pipeline: use keyword tools (Ubersuggest / AnswerThePublic) to expand angles and seed terms into a complete keyword map. Maps to the v2 flow diagram's 'filter keywords to build the keyword map + compile the complete keyword map'. Triggers when the user hands over an Angles handoff packet, pastes a keyword-tool export, or says '做關鍵字地圖'. Builds the map only — it does not classify intent and does not write articles."

category: brand-marketing

project: seo-keyword-mapper

platform: claude

status: WIP

author: Peter Tu

- input: "seo-angle-finder 的 SEO_PACKET ▸ Angles；使用者貼上的 Ubersuggest / AnswerThePublic 匯出（CSV/文字）"

- process: "依 keyword-checklist 擴展種子字 → 整理含搜尋量/難度的關鍵字地圖（線頭→關鍵字）→ 人工用工具補充 → 交棒"

- output: "完整關鍵字地圖（關鍵字、線頭、量/難度），交給 seo-keyword-classifier"

+ input: "seo-angle-finder's SEO_PACKET ▸ Angles; a Ubersuggest / AnswerThePublic export pasted by the user (CSV/text)"

+ process: "Expand seed terms per keyword-checklist → compile a keyword map with search volume/difficulty (thread head → keyword) → human supplements via tools → hand off"

+ output: "A complete keyword map (keywords, thread heads, volume/difficulty), handed to seo-keyword-classifier"

synergy: ["seo-keyword-classifier"]

---

# SEO Keyword Mapper

```bash

npx skills add https://github.com/peter-tu-zynkr/zynkr-skill-builder --skill seo-keyword-mapper

```

- SEO 流程第四棒，對應流程圖「找線頭：發覺關鍵字」。它把切角與種子字擴展成一張完整的關鍵字地圖。**搜尋量／難度數據來自真實工具**（Ubersuggest、AnswerThePublic、keyword planner）——這個 skill 不發明數字，它整理人工貼進來的工具匯出。

+ The fourth leg of the SEO pipeline, mapping to the flow diagram's "find the thread head: discover keywords". It expands angles and seed terms into a complete keyword map. **Search volume / difficulty data comes from real tools** (Ubersuggest, AnswerThePublic, keyword planner) — this skill does not invent numbers; it organizes the tool exports a human pastes in.

---

## Resources you'll use

- > **知識來源**：本 skill 用到的 rubric/範本優先從 SEO Knowledge Base 的「01 Rubrics & Templates」(Drive，google-workspace MCP，依名稱 search) 讀取；取不到時 fallback 本地 `./references/`。對照表見 `seo-article-pipeline/seo-pipeline-config.md`。

+ > **Knowledge source**: the rubrics/templates this skill uses are read first from the SEO Knowledge Base's "01 Rubrics & Templates" (Drive, google-workspace MCP, search by name); if unavailable, fall back to the local `./references/`. See the mapping table in `seo-article-pipeline/seo-pipeline-config.md`.

- - **關鍵字檢查清單**：`./references/keyword-checklist.md`

- - **SEO 知識庫資料夾 ID**：`<your-seo-kb-folder-id>`（存關鍵字地圖工作檔）

- - **MCP server**：`google-workspace`

- - **外部工具（人工）**：Ubersuggest、AnswerThePublic（使用者執行後貼匯出）

+ - **Keyword checklist**: `./references/keyword-checklist.md`

+ - **SEO knowledge base folder ID**: `<your-seo-kb-folder-id>` (stores the keyword-map working file)

+ - **MCP server**: `google-workspace`

+ - **External tools (manual)**: Ubersuggest, AnswerThePublic (the user runs them, then pastes the export)

- ## Step 1 — 接收切角

+ ## Step 1 — Receive the angles

- 讀取 `SEO_PACKET ▸ Angles` 與 `▸ Questions` 的種子字。

+ Read the seed terms from `SEO_PACKET ▸ Angles` and `▸ Questions`.

- ## Step 2 — 請使用者跑工具（HITL）

+ ## Step 2 — Ask the user to run the tools (HITL)

- 對應流程圖「利用工具找關鍵字 (Ubersuggest / keyword planner)」。請使用者把種子字丟進工具，貼回匯出（含搜尋量、難度、相關建議字）。**沒有工具數據時，標記為「待補量/難度」，不要捏造數字。**

+ Maps to the flow diagram's "use tools to find keywords (Ubersuggest / keyword planner)". Ask the user to feed the seed terms into the tools and paste back the export (including search volume, difficulty, related suggested terms). **When there is no tool data, mark it as "volume/difficulty pending" — do not fabricate numbers.**

- ## Step 3 — 整理關鍵字地圖

+ ## Step 3 — Compile the keyword map

- 依 `./references/keyword-checklist.md` 把字整理成地圖：線頭（種子）→ 衍生關鍵字 → 長尾，每筆附搜尋量、難度、對應切角/問題、語言（zh-TW / EN）。

+ Following `./references/keyword-checklist.md`, organize the terms into a map: thread head (seed) → derived keywords → long-tail, each entry annotated with search volume, difficulty, the corresponding angle/question, and language (zh-TW / EN).

- ## Step 4 — 交棒並存檔

+ ## Step 4 — Hand off and save

- 存成「關鍵字地圖」工作檔於本篇子資料夾，輸出：

+ Save it as a "keyword map" working file in this article's subfolder, and output:

```

SEO_PACKET ▸ KeywordMap

- 線頭：<種子> → 關鍵字：<字>（量 / 難度 / 對應切角 / 語言）

- ...（含待補標記）

關鍵字地圖已完成，可交棒給 seo-keyword-classifier 依意圖分類。

```

## Outputs

- 完整關鍵字地圖（`SEO_PACKET ▸ KeywordMap` + Drive 工作檔）。

+ A complete keyword map (`SEO_PACKET ▸ KeywordMap` + Drive working file).

## Limitations

- 不依意圖分類（下一棒）、不驗證需求／難度排序（seo-demand-validator）、不寫文章。不捏造搜尋量。

+ Does not classify by intent (the next leg), does not validate demand / rank by difficulty (seo-demand-validator), and does not write articles. Does not fabricate search volume.