name	social-data-parser
description	当用户要求解析、清洗外部平台（如小红书等社交媒体）的 API 返回数据，提取标题、图片及互动指标，或处理 viral-references/replication 相关数据结构时触发
allowed-tools	Read, Edit, Write, Grep, Glob

社交媒体数据清洗技能包

确认数据来源：通过云雾 API 获取的平台数据，原始响应结构在 docs/ 目录中查阅
读取现有解析逻辑：先阅读 lib/viralReferenceMedia.ts 了解当前字段映射
提取核心字段：
- 标题：title / desc / note_card.title（各平台字段名不同）
- 封面图：优先取 CDN URL，注意部分平台返回加密 URL 需二次处理
- 互动指标：点赞（liked_count）、收藏（collected_count）、评论（comment_count）
- 作者信息：author.nickname、author.avatar
标准化输出结构：统一转换为项目内部数据模型（参考 Prisma Schema 中的对应 Model）
写入数据库：通过 Prisma Client 存储，注意 upsert 避免重复

持续更新，遇到新坑在此补充

图片 URL 有效期：部分平台（如小红书）的图片 URL 有时效性，需在获取后尽快转存到 Supabase Storage，不要直接存原始 URL 入库。
数字格式问题：互动数据可能返回字符串（"1.2万"），需在清洗时转换为数字。
字段缺失处理：部分内容（如无封面的纯文字帖）某些字段为 null，解析时加默认值，不要 ?. 链式调用后直接存 undefined。
分页数据合并：批量抓取时注意去重（以平台原始 id 为唯一键），避免同一内容多次写入。