content-brief-factory

内容简报工厂

大多数内容简报都毫无价值。它们只会告诉你“这些关键词要提及 7 次”，然后就说这是策略。这项技能生成的简报包含竞争分析、从真实客户反馈中挖掘出的独特角度、SERP 特征定位，以及差异化大纲，让写作者清楚知道要创作什么，以及内容为何能获得排名。

核心原则： 一份出色的简报不只是说“写关于 X 的内容”，而是会告诉你“这些内容已经获得排名、它们为何胜出、它们遗漏了什么、哪些客户用语证明这个缺口确实重要，以及如何组织页面才能击败它们”。

批处理模式： 单次运行可处理 10-50 个关键词。增强模式下，每份简报约需 30 秒；基准模式下约需 60 秒。

适用场景

• “为这些关键词创建内容简报”
• “我需要为第二季度内容日历准备简报”
• “为我们的 pSEO 模板撰写简报”
• “根据这份关键词列表生成 20 份简报”
• “我们应该写什么关于 [topic] 的内容？给我一份完整简报。”

工具增强（可选）

与推断分析相比，使用真实 SERP 数据（实际获得排名的内容、出现的 SERP 特征）能显著提升简报质量。

面向用户的 Agent 提示词

“我可以通过竞争研究和客户用语挖掘来创建高质量的内容简报。为了获得最佳结果，尤其是准确的 SERP 分析和关键词指标，我建议接入 SERP 数据 API。”

推荐：SerpAPI（每月 100 次免费搜索，$50/月可进行 5,000 次搜索）

• 在 serpapi.com 注册 → 获取 API 密钥
• 设置 SERPAPI_KEY 环境变量

也可使用的替代方案：

• Serper.dev（2,500 次免费搜索，之后 $50/月可进行 50K 次搜索）→ 设置 SERPER_API_KEY
• DataForSEO SERP（按使用量付费，约 $0.01/次搜索）→ 设置 DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD
• ValueSERP（提供免费套餐）→ 设置 VALUESERP_API_KEY

“想使用其中一种，还是让我以基准模式继续？基准模式会使用网页搜索分析竞争页面，仍能生成优质简报，只是 SERP 特征和搜索量数据不够精确。”

模式选择

• 增强模式 — 每个关键词均使用真实 SERP 数据：确切的排名页面、现有 SERP 特征（精选摘要、PAA、视频轮播）、搜索量和关键词难度。简报会包含针对特定 SERP 特征的“赢得该特征”策略。
• 基准模式 — 使用 web_search 查找排名靠前的页面，使用 seo-domain-analyzer 分析域名指标。SERP 特征检测结果为推断所得。仍能生成出色的简报——竞争分析和客户用语部分无需 SERP API。

阶段 0：收集信息

1. 关键词 — 目标关键词列表（1-50 个）。可以是：
   • 粘贴的列表
   • CSV 文件
   • seo-opportunity-finder 的输出
   • programmatic-seo-planner 的输出（模板关键词）
2. 你的网站 URL — 用于检查现有内容覆盖情况
3. ICP — 谁会阅读这些内容？（角色、痛点、目标）
4. 品牌语气 — 正式/随意/技术性？（或提供品牌语气文档链接）
5. 内容类型偏好 — 博客文章、落地页、指南、术语表条目？
6. 简报深度 — 标准版（大纲 + 角度 + 竞争对手）还是深度版（以上全部内容 + 客户引述 + SERP 特征定位 + 内部链接）？
7. 工具偏好 — 使用带 SERP API 的增强模式，还是基准模式？（见上文“工具增强”）

阶段 1：检查现有内容覆盖情况

在你的网站上运行 site-content-catalog：

python3 skills/site-content-catalog/scripts/catalog_content.py \
  --url "<your_site_url>" \
  --output json

针对每个目标关键词，检查：

• 是否已有页面针对该关键词？→ 更新简报（而非新建页面）
• 是否有相关页面应链接到此页面？→ 内部链接候选页面
• 存在哪些内容缺口？→ 确认该关键词是否值得定位

阶段 2：逐个关键词分析（批处理）

对于每个关键词，尽可能并行运行：

2A：SERP 分析

增强模式（SerpAPI / Serper / DataForSEO）：

# SerpAPI example
GET https://serpapi.com/search?q={keyword}&api_key={key}&num=10

按关键词提取：

• 排名靠前的 10 个 URL
• 存在的 SERP 功能（精选摘要、PAA、视频、知识面板、图片）
• 精选摘要的归属页面（如有）及摘要内容
• 「用户还会问」问题（前 5 个）
• 相关搜索
• 搜索量和关键词难度（如果 API 提供）

基线模式：

对每个关键词使用 web_search：

• 记录排名靠前的 5–10 个结果
• 根据结果格式识别明显的 SERP 功能
• 使用 seo-domain-analyzer 估算搜索量和难度

2B：竞争页面分析

对每个关键词排名靠前的 3–5 个页面，使用 fetch_webpage 抓取：

分析每个页面：

• 字数 — 排名页面有多长？
• 结构 — H1、H2 大纲和内容脉络
• 内容类型 — 操作指南、清单、对比、指南、定义
• 独特数据 — 是否包含原创研究、调查、屏幕截图？
• 时效性 — 上次更新是什么时候？
• 深度评分 — 简略概述还是全面的资源？
• 缺失主题 — 哪些内容没有涵盖，但本应涵盖？

2C：挖掘客户用语

针对该主题运行 review-site-scraper + reddit-post-finder：

# Reviews — find how ICP talks about this problem
python3 skills/capabilities/review-site-scraper/scripts/scrape_reviews.py \
  --platform g2 \
  --url "<relevant_product_review_url>" \
  --output json

# Reddit — find real questions and pain language
python3 skills/reddit-post-finder/scripts/search_reddit.py \
  --subreddit "<relevant_subs>" \
  --keywords "<keyword>,<topic>" \
  --days 365 --sort top --time year

提取：

• 人们提出的真实问题 — 应纳入的章节
• 痛点表达 — 引言开场的切入角度
• 常见误解 — 揭穿迷思的章节机会
• 具体用例 — 应纳入的具体示例
• 引述 — 可融入内容的佐证

阶段 3：生成内容简报

针对每个关键词，生成：

# Content Brief: [Target Keyword]

## Metadata
- **Target keyword:** [primary keyword]
- **Secondary keywords:** [2-5 related keywords to include naturally]
- **Search volume:** [monthly, if available] | **Difficulty:** [score, if available]
- **Content type:** [blog post / guide / comparison / glossary / landing page]
- **Target word count:** [X-Y words] (based on competing pages)
- **Priority:** [P0/P1/P2]

---

## Search Landscape

### What's Currently Ranking
| # | Page | Domain | Type | Words | Strengths | Weaknesses |
|---|------|--------|------|-------|-----------|------------|
| 1 | [title] | [domain] | [type] | [count] | [what they do well] | [what they miss] |
| 2 | ... | | | | | |
| 3 | ... | | | | | |

### SERP Features Present
- Featured snippet: [Yes/No — current holder + content]
- People Also Ask: [list of PAA questions]
- Video carousel: [Yes/No]
- Images: [Yes/No]
- Knowledge panel: [Yes/No]

### SERP Feature Targets
- [ ] **Win featured snippet** — Structure answer in [format] under H2 "[heading]"
- [ ] **Answer PAA questions** — Include sections covering: [list]
- [ ] **Image pack** — Include [type of images/diagrams]

---

## Differentiation Angle

**The gap in existing content:** [What ALL ranking pages miss or do poorly]

**Your unique angle:** [How to approach this differently — based on customer language, product positioning, or data you have that competitors don't]

**Customer voice evidence:**
> "[Quote from review/Reddit showing the gap]" — [Source]
> "[Another quote]" — [Source]

---

## Recommended Outline

### Title Options (pick one)
1. [Title option A — SEO-optimized]
2. [Title option B — curiosity-driven]
3. [Title option C — outcome-focused]

### Meta Description
[155 characters, includes keyword, has clear value prop]

### Content Structure

**H1: [Exact H1]**

**H2: [Section 1 — Hook/Problem Statement]**
- What to cover: [specific guidance]
- Length: [~X words]
- Include: [customer pain quote as hook]

**H2: [Section 2 — Core Content]**
- What to cover: [specific guidance]
- Length: [~X words]
- Include: [comparison table / step-by-step / framework]

**H2: [Section 3 — Differentiated Angle]**
- What to cover: [the thing competitors miss]
- Length: [~X words]
- This is your competitive edge

**H2: [Section 4 — Practical Application]**
- What to cover: [concrete examples, use cases]
- Include: [screenshots, templates, or data]

**H2: [Section 5 — FAQ / PAA Answers]**
- [PAA question 1] — [brief answer guidance]
- [PAA question 2] — [brief answer guidance]
- [PAA question 3] — [brief answer guidance]

**H2: [Section 6 — CTA / Next Steps]**
- What to cover: [natural transition to your product]

---

## Internal Linking Plan
- **Link FROM this page TO:** [existing pages that are relevant]
- **Link TO this page FROM:** [existing pages that should reference this]
- **Anchor text suggestions:** [specific anchor text for each link]

---

## Content Requirements
- [ ] Include at least [N] original examples/screenshots
- [ ] Use customer language: "[specific phrases to work in]"
- [ ] Include structured data: [FAQ schema / HowTo schema / etc.]
- [ ] Add last-updated date (for freshness signals)
- [ ] Target readability: [grade level / reading time]

---

## Competitive Advantage Checklist
- [ ] Covers everything top 3 pages cover
- [ ] Adds [unique angle] they all miss
- [ ] Uses real customer language (not generic marketing speak)
- [ ] Targets [SERP feature] with optimized format
- [ ] Has stronger internal linking than competitors
- [ ] Includes original [data/images/templates] competitors lack

阶段 4：批量输出

批量运行（10 份或更多简报）时：

# Content Brief Batch — [Product/Client] — [DATE]

## Summary
- Briefs generated: [N]
- Total target search volume: [X]/month
- Content types: [N] blog posts, [N] guides, [N] comparisons, etc.

## Priority Order
| # | Keyword | Volume | Difficulty | Content Type | Unique Angle | Status |
|---|---------|--------|-----------|-------------|-------------|--------|
| 1 | [kw] | [vol] | [diff] | [type] | [angle summary] | Ready |
| 2 | [kw] | [vol] | [diff] | [type] | [angle summary] | Ready |
...

## Individual Briefs
[Brief 1]
---
[Brief 2]
---
...

保存到当前工作目录，或用户指定的位置。批量模式下，还要导出汇总 CSV。

成本

组件	成本
网站目录（一次性）	~$0.05-0.10
评论抓取工具（每个主题集群）	~$0.10-0.30
Reddit 抓取工具（每个主题集群）	~$0.05-0.10
页面抓取（每个关键词 3–5 个）	每个关键词 ~$0.01-0.03
SerpAPI（增强模式，每个关键词）	每个关键词 ~$0.01-0.05
Serper.dev（增强模式，每个关键词）	每个关键词 ~$0.001
分析	免费（大模型推理）
每份简报总计（基线）	~$0.05-0.15
每份简报总计（增强）	~$0.08-0.25
20 份简报（基线）	~$1.00-3.00
20 份简报（增强）	~$1.60-5.00

所需工具

• Apify API 令牌 — APIFY_API_TOKEN 环境变量
• 上游技能： site-content-catalog、seo-domain-analyzer、review-site-scraper、reddit-post-finder、fetch_webpage
• 可选（增强模式）： SerpAPI（SERPAPI_KEY）、Serper.dev（SERPER_API_KEY）、DataForSEO（DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD）或 ValueSERP（VALUESERP_API_KEY）

排期

对于持续的内容运营，每周运行一次：

• 输入：来自 seo-opportunity-finder 或内容日历的关键词
• 输出：提供给写作团队的新简报
• 时间：周一上午，编辑规划开始前

触发短语

• “为这些关键词创建内容简报”
• “为我简报一下[关键词]”
• “生成 20 份内容简报”
• “我们应该写什么关于[主题]的内容？”
• “为我们的内容日历制定简报”
• “批量为这些关键词制作简报”