1小时用Skill搭一个文章数据追踪系统,踩了 3 个坑

文章发到微信、掘金、知乎后,阅读量散落三处?这篇教你用 Claude Code Skill 一键汇总到 Notion。

环境:Claude Code · MCP Playwright · Notion API · Node.js 20


TL;DR(太长不看版)

读完这篇,你能省掉我浪费的 2 小时:

  • ❌ 手动登录三个平台后台抄数据?太累
  • ❌ 用表格记录?格式乱、容易忘
  • 正解:Claude Code Skill + MCP Playwright 自动抓取,Notion 数据库统一追踪

3 个坑提前告诉你

  1. Notion SDK 默认 API 版本会静默丢失属性 → 用原生 fetch
  2. 微信后台没有"点赞"指标 → 别傻找了
  3. 掘金显示的是"展现量"不是"阅读量" → 数据口径不同

想知道我怎么一步步踩坑的,继续往下看 👇


背景:为什么要追踪博文数据

作为 AI 进化岛主,我每篇文章都会发到三个平台:

平台 特点
微信公众号 私域流量,打开率高
掘金 技术社区,SEO 好
知乎 长尾流量,搜索权重高

问题来了:数据散落在三个地方

想知道一篇文章的总阅读量?得分别登录三个后台,找到文章,手动加一下。累不累?

我想要什么

一个能做到这些的系统:

  1. 统一看板 --- 所有文章、所有平台的数据在一个地方
  2. 自动抓取 --- 说一句话就能更新数据
  3. 可复用 --- 做成 Skill,以后一直能用

最终选型:Notion 数据库 + Claude Code Skill + MCP Playwright

系统架构

kotlin 复制代码
┌─────────────────────────────────────────────────────────────┐
│                    博文数据追踪系统                           │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  用户: "追踪博客数据:OpenCode 升级踩坑"                      │
│                         ↓                                   │
│  Claude Code 激活 blog-data-tracker 技能                    │
│                         ↓                                   │
│  ┌─────────────────────────────────────────────┐           │
│  │ MCP Playwright 自动化抓取                    │           │
│  │                                             │           │
│  │  微信后台 → 图文分析 → 阅读/分享/收藏/留言    │           │
│  │  掘金创作者中心 → 单篇分析 → 展现/点赞/收藏   │           │
│  │  知乎创作者中心 → 单篇分析 → 阅读/赞同/收藏   │           │
│  └─────────────────────────────────────────────┘           │
│                         ↓                                   │
│  ┌─────────────────────────────────────────────┐           │
│  │ Notion API 更新数据库                        │           │
│  │                                             │           │
│  │  平台发布记录表 ← Views/Likes/Bookmarks...   │           │
│  └─────────────────────────────────────────────┘           │
│                         ↓                                   │
│  返回汇总表格                                               │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Step 1: 设计 Notion 数据库

主表:博客发布追踪

记录每篇文章的基本信息:

字段 类型 用途
Name title 文章标题
Status select 草稿/已发布/待优化
WeChat url 微信链接
Juejin url 掘金链接
Zhihu url 知乎链接
PublishDate date 发布日期
Tags multi_select 标签

子表:平台发布记录

每个平台一条记录,追踪详细数据:

字段 类型 用途
Name title 记录名称(如"文章名 - 微信")
Article relation 关联到主表
Platform select 微信公众号/掘金/知乎
URL url 发布链接
Views number 阅读量
Likes number 点赞数
Bookmarks number 收藏数
Shares number 分享数
Comments number 评论数
UpdatedAt date 更新时间

❌ 坑 1:Notion SDK 版本陷阱

用官方 @notionhq/client SDK 创建数据库时,只有 Name 字段成功,其他属性全丢!

排查 2 小时后发现:SDK 默认用新版 API,某些属性会被静默忽略

解决方案 :放弃 SDK,用原生 fetch + 固定 API 版本:

javascript 复制代码
const NOTION_VERSION = '2022-06-28';  // 关键!

async function notionRequest(endpoint, method, body) {
  return fetch(\`https://api.notion.com/v1\${endpoint}\`, {
    method,
    headers: {
      'Authorization': \`Bearer \${NOTION_API_KEY}\`,
      'Notion-Version': NOTION_VERSION,  // 必须固定
      'Content-Type': 'application/json',
    },
    body: body ? JSON.stringify(body) : undefined,
  }).then(r => r.json());
}

Step 2: MCP Playwright 自动抓取

每个平台的数据藏在不同的地方,需要分别处理。

微信公众号

路径:公众号后台 → 数据分析 → 图文分析 → 搜索文章

javascript 复制代码
// 1. 打开公众号后台
browser_navigate({ url: "https://mp.weixin.qq.com/" })

// 2. 进入图文分析
browser_click({ element: "数据分析" })
browser_click({ element: "图文分析" })

// 3. 搜索文章
browser_type({ element: "搜索框", text: "OpenCode", submit: true })

// 4. 从页面提取数据
// 阅读人数、分享人数、收藏人数、留言人数

❌ 坑 2:微信没有"点赞"指标

在微信后台找了半天"点赞数",根本没有这个字段!

微信公众号的互动指标只有:阅读人数、分享人数、收藏人数、留言人数。

解决方案:Likes 字段直接设为 0,别浪费时间找了。

掘金

路径:创作者中心 → 内容数据 → 单篇分析

javascript 复制代码
// 1. 打开创作者中心
browser_navigate({ url: "https://juejin.cn/creator/content/article/all" })

// 2. 进入单篇分析
browser_click({ element: "内容数据" })
browser_click({ element: "单篇分析" })

// 3. 搜索并选择文章
browser_type({ element: "搜索框", text: "OpenCode" })
browser_click({ element: "文章标题" })

// 4. 提取:展现量、点赞数、收藏数、评论数、转发数

⚠️ 坑 3:掘金的"阅读量"其实是"展现量"

掘金后台显示的数字叫"展现量",不是真正的阅读量!

展现量 = 文章在信息流里被展示的次数(用户可能没点进去看)

解决方案:统一用 Views 字段存储,但要知道这个数据口径和微信、知乎不同。

知乎

路径:创作者中心 → 内容分析 → 文章 → 单篇文章分析

javascript 复制代码
// 1. 打开创作者中心
browser_navigate({ url: "https://www.zhihu.com/creator/analytics" })

// 2. 进入单篇分析
browser_click({ element: "内容分析" })
browser_click({ element: "文章" })
browser_click({ element: "单篇文章分析" })

// 3. 选择文章
browser_click({ element: "请选择文章" })
browser_type({ element: "搜索框", text: "OpenCode" })
browser_click({ element: "文章标题" })

// 4. 提取:阅读量、赞同数、收藏数、评论数、分享数

Step 3: 封装成 Claude Code Skill

把整个流程封装成可复用的技能:

bash 复制代码
~/Projects/my_skils/library/blog-data-tracker/
├── SKILL.md                      # 技能主文件
├── references/
│   └── notion-api-guide.md       # API 调用指南
└── scripts/
    └── notion-update.mjs         # 命令行更新工具

SKILL.md 核心内容

yaml 复制代码
---
name: blog-data-tracker
description: 博客多平台数据追踪技能。自动从微信公众号、掘金、知乎抓取文章数据,
  更新到 Notion 数据库。当用户说"追踪博客数据"、"更新文章数据"时触发。
---

固定配置(省去每次输入)

javascript 复制代码
// scripts/notion-update.mjs
const NOTION_API_KEY = 'ntn_xxx';  // 固定 Token
const PLATFORM_RECORDS_DB = '2e43f9a6-73f7-81db-aaf7-f817b30dec58';

// 已知文章的 Page ID,便于快速更新
const KNOWN_PLATFORM_RECORDS = {
  'opencode-wechat': '2e43f9a6-73f7-81bf-ba0f-c8b9e60c00aa',
  'opencode-juejin': '2e43f9a6-73f7-813b-b535-cc62e12a73de',
  'opencode-zhihu': '2e43f9a6-73f7-813e-aa7b-c82ecca71d7d',
};

使用方式

bash 复制代码
# 直接更新已知记录
node notion-update.mjs update 2e43f9a6-73f7-81bf-ba0f-c8b9e60c00aa \
  --views 100 --likes 10 --bookmarks 5

# 或者让 Claude 自动处理
追踪博客数据:OpenCode 升级踩坑

实际效果

抓取完成后,Notion 数据库里是这样的:

平台 阅读 点赞 收藏 评论 分享
微信 57 0 2 0 0
掘金 23 0 0 0 0
知乎 71 1 1 0 0

总阅读量:151(一眼就能看到)


踩坑清单

我干了啥 啥结果
用 Notion SDK 创建数据库 ❌ 属性丢失,只有 Name
在 SDK 设置 notionVersion ❌ 报错不支持
用原生 fetch + 2022-06-28 ✅ 完美运行
微信后台找点赞数 ❌ 没有这个指标
掘金用"阅读量"字段 ⚠️ 其实是"展现量"

几点经验

  1. Notion API 版本要锁死 --- SDK 默认版本会坑你
  2. 各平台数据口径不同 --- 微信没点赞,掘金用展现量
  3. 固定参数优先 --- Token、ID 都写死到脚本,减少配置
  4. 技能目录规范 --- references/ 放文档,scripts/ 放脚本
  5. 用原生 API 而非 MCP --- Notion MCP 在多客户端环境下容易异常失败,直接用 Notion API + Token 更稳定

完整代码

技能已开源在我的 Skills 库:

bash 复制代码
~/Projects/my_skils/library/blog-data-tracker/

核心文件:

  • SKILL.md --- 技能定义和使用说明
  • scripts/notion-update.mjs --- Notion 更新脚本
  • references/notion-api-guide.md --- API 调用指南

一句话总结

Claude Code Skill + MCP Playwright + Notion API = 全自动博文数据追踪,一句话更新三大平台数据。


觉得有用?转发给同样在多平台发文的朋友 👇

你是怎么追踪博文数据的?评论区聊聊~

相关推荐
peterfei8 小时前
IfAI v0.2.8 技术深度解析:从"工具"到"平台"的架构演进
rust·ai编程
fox_mt9 小时前
AI Coding - ClaudeCode使用指南
java·ai编程
小碗细面11 小时前
OpenCode:你的开源 AI 编程助手完全指南
ai编程
IT 行者11 小时前
Claude之父AI编程技巧二:多平台协同——打破终端边界的全栈开发工作流
ai编程
一条咸鱼_SaltyFish12 小时前
[Day15] 若依框架二次开发改造记录:定制化之旅 contract-security-ruoyi
java·大数据·经验分享·分布式·微服务·架构·ai编程
leluckys12 小时前
AI-大模型-MCP实战指南
ai编程
程序新视界15 小时前
面对AI的飞速发展,我们的职业路径有什么变化?
人工智能·ai编程
DebugEve15 小时前
AI 时代的减法生活:我为什么不再追逐新工具了
aigc·ai编程
draking15 小时前
Anthropic 封杀当天,我把 OpenCode 升到 1.1.11,踩了 5 个坑
macos·ai编程