# Seo Content Performance

> 品牌内容表现追踪子模块。每周追踪品牌网站每篇文章的排名、流量、用户行为数据，自动标记流量持续下降的衰退内容，生成更新提醒。当用户提到'文章表现怎么样''哪篇文章流量掉了''需要更新的内容''内容衰退''上周发的文章怎么样了'时触发。数据源：Google Search Console API + Google Analytics API + SEMrush API。

- **Type:** Skill
- **Install:** `agentstack add skill-jrr996shujin-png-openclaw-seo-aeo-skills-content-performance`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jrr996shujin-png](https://agentstack.voostack.com/s/jrr996shujin-png)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jrr996shujin-png](https://github.com/jrr996shujin-png)
- **Source:** https://github.com/jrr996shujin-png/openclaw-seo-aeo-skills/tree/main/seo-competitive-intel/content-performance

## Install

```sh
agentstack add skill-jrr996shujin-png-openclaw-seo-aeo-skills-content-performance
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 品牌内容表现追踪模块

## 核心功能

追踪品牌网站每篇内容的搜索表现和用户行为，识别衰退内容并触发更新提醒。每周运行一次。

## 数据源与指标

### 来自 Google Search Console API

每篇页面的搜索表现：
- **曝光量**（Impressions）：搜索结果中被展示了多少次
- **点击量**（Clicks）：实际被点击了多少次
- **CTR**（点击率）：点击 / 曝光
- **平均排名**（Average Position）：在搜索结果中的平均位置
- **搜索查询**（Queries）：用户搜了什么词看到了这个页面

API 调用：`/searchanalytics/query`，按页面维度（`page`）拉取，时间范围为过去 7 天 + 过去 28 天（用于趋势对比）。

### 来自 Google Analytics API (GA4)

每篇页面的用户行为：
- **用户数**（Active Users）
- **会话数**（Sessions）
- **平均参与时间**（Average Engagement Time）——GA4 中替代了老版的"停留时间"
- **跳出率**（Bounce Rate）
- **转化事件**（如有配置：注册、下载、购买等）

API 调用：GA4 Data API，按页面路径维度拉取。

### 来自 SEMrush API

补充数据：
- 该页面排名的关键词数量
- 估算自然流量
- 外链数量（其他网站链接到这个页面的数量）

## 执行流程

### 1. 内容清单建立

首次运行时，自动建立品牌网站的内容清单：

1. 从 XML Sitemap 获取所有页面 URL
2. 或从 Google Search Console API 拉取有曝光的所有页面
3. 自动分类：
   - **Blog 文章**：URL 含 `/blog/` 或类似路径
   - **产品页**：URL 含 `/product/`、`/features/` 等
   - **Help Center**：URL 含 `/help/`、`/docs/`、`/support/`
   - **Landing Page**：URL 含 `/lp/`、参数特征
   - **其他**

分类后展示给用户确认。

### 2. 每周数据拉取

每周运行时：

**Step 1 — 拉取本周数据**
- Google Search Console：过去 7 天各页面的曝光、点击、排名
- Google Analytics：过去 7 天各页面的用户行为数据
- SEMrush：各页面的关键词数量和估算流量

**Step 2 — 计算趋势**
- 本周 vs 上周的变化率（需要存储历史数据或拉取更长时间范围做对比）
- 过去 28 天的滚动平均趋势

**Step 3 — 识别异常**

表现上升的内容（好消息）：
- 本周点击量比上周增长 > 20%
- 新进入关键词排名前 10

表现下滑的内容（关注）：
- 本周点击量比上周下降 > 20%
- 排名下滑 > 5 位

### 3. 内容衰退检测

这是本模块最重要的功能——自动识别需要更新的内容。

**衰退判定规则：连续 30 天流量下降 10% 即自动标记。**

具体实现：
1. 拉取每篇文章过去 30 天的点击量
2. 与前一个 30 天对比
3. 如果下降 ≥ 10%，标记为 🟡 **"衰退预警"**
4. 如果连续两个月（60 天）下降 ≥ 10%，升级为 🔴 **"需要立即更新"**

**衰退标记后的输出：**
```
🟡 衰退预警：/blog/best-ai-tools-2025
  过去 30 天点击：1,240（前 30 天：1,450，下降 14.5%）
  排名变化：核心词 "best AI tools" 从 #6 → #9
  最后更新：2025-08-15（距今 6 个月）
  外链数：23（无明显变化）
  
  可能原因分析：
  - 内容时效性下降（标题含 2025，但已进入 2026）
  - 竞品可能发布了更新的同类文章
  
  建议动作：
  - 更新文章标题和内容为 2026 版本
  - 检查竞品同主题最新内容 → 调用 competitor-content 模块
  - 补充最新工具和数据
```

### 4. 新发布内容追踪

当品牌发布新文章时，进入"新内容观察期"：

| 时间节点 | 检查内容 |
|----------|----------|
| 第 7 天 | 是否被 Google 收录？初始排名在哪？ |
| 第 14 天 | 排名是否在上升？曝光量趋势 |
| 第 30 天 | 达到稳定排名了吗？点击量是否符合预期 |
| 第 60 天 | 与同类别文章的平均表现对比 |
| 第 90 天 | 长期表现评估，是否进入核心内容行列 |

新文章识别：对比本周和上周的 URL 清单，新增的 URL 自动进入观察期。

### 5. 更新提醒

除了衰退检测触发的更新提醒，还有时间维度的提醒：

- 文章发布超过 **6 个月**未更新 → 提醒检查是否需要刷新
- 文章标题或内容中包含年份（如 "2025"）且已跨年 → 🔴 立即提醒
- "Best of" / "Top X" 类榜单文章超过 **3 个月**未更新 → 提醒更新

## 输出格式

### 每周调用时

在对话中返回：

```
📊 本周内容表现摘要（2026-02-17 ~ 2026-02-23）

🔥 表现上升 Top 3：
1. /blog/ai-agent-guide — 点击 +35%，排名 #4→#2
2. ...

📉 表现下滑 Top 3：
1. /blog/email-automation-tips — 点击 -22%，排名 #8→#14
2. ...

🟡 衰退预警（2 篇）：
- /blog/best-ai-tools-2025 — 连续 30 天下降 14.5%
- /help/getting-started — 连续 30 天下降 11.2%

🆕 新文章观察期：
- /blog/new-feature-launch（第 7 天）— 已收录，初始排名 #23

⏰ 更新提醒：
- /blog/top-10-productivity-apps — 标题含 "2025"，建议更新为 2026 版
```

### 被月度报告调用时

输出结构化数据：
- 全部内容的月度表现汇总（按类别）
- 衰退内容完整清单
- 新内容表现追踪结果
- 更新提醒队列
- 月环比核心指标（总点击、总曝光、平均排名、平均 CTR）

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jrr996shujin-png](https://github.com/jrr996shujin-png)
- **Source:** [jrr996shujin-png/openclaw-seo-aeo-skills](https://github.com/jrr996shujin-png/openclaw-seo-aeo-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jrr996shujin-png-openclaw-seo-aeo-skills-content-performance
- Seller: https://agentstack.voostack.com/s/jrr996shujin-png
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.