蒲公英博主分析器.SKILL (PGY Blogger Analyzer.skill)

小红书蒲公英平台博主合作评估工具 - 自动化分析博主跨域合作笔记数据，计算外溢进店量单价达标率，为品牌方筛选合适KOL。

✨ 功能特性

• 🤖 全自动分析 - 一键访问博主详情页，自动提取所有关键数据
• 📊 智能评级 - 基于外溢进店量单价（≤¥20达标）自动评级 A/B/C/D/E
• 🔍 品牌检测 - 自动识别竞品合作记录（需提前设置竞品品牌）
• 📈 批量处理 - 支持同时分析多位博主，生成对比报告
• 📋 专业报告 - 生成详细的合作建议报告，包含风险提示

🚀 快速开始

📦 安装（3种方式）

方式一：通过 Release 下载（推荐）

1. 访问 Releases 页面
2. 下载最新版 pgy-blogger-analyzer.skill
3. 解压到 QClaw skills 目录：
   • Windows: %USERPROFILE%\.qclaw\skills\pgy-blogger-analyzer\
   • macOS/Linux: ~/.qclaw/skills/pgy-blogger-analyzer/
4. 重启 QClaw

方式二：通过 Git 克隆

# 克隆仓库
git clone https://github.com/qclaw/pgy-blogger-analyzer.git

# 复制到 skills 目录（Windows）
xcopy /E /I pgy-blogger-analyzer %USERPROFILE%\.qclaw\skills\pgy-blogger-analyzer\

# 或复制到 skills 目录（macOS/Linux）
cp -r pgy-blogger-analyzer ~/.qclaw/skills/

# 重启 QClaw

方式三：一键安装脚本（即将支持）

# 未来版本将支持
qclaw skill install pgy-blogger-analyzer

首次使用配置（重要！）

1. 配置品牌参数（必须！）

⚠️ 首次使用前必须设置你的品牌参数！

向 AI 发送：

开始配置蒲公英博主分析器

AI 会引导你设置：

• 外溢进店量单价阈值（推荐 ¥15-30）
• 竞品品牌列表
• 目标粉丝群体画像（性别/年龄/地域/兴趣）
• 下单粉丝占比目标
• 内容风格偏好

2. 配置 SSRF 白名单

编辑 ~/.qclaw/openclaw.json，添加：

{
  "browser": {
    "dangerouslyAllowPrivateNetwork": true,
    "ssrf": {
      "allowedHostnames": [
        "pgy.xiaohongshu.com",
        "xiaohongshu.com"
      ]
    }
  }
}

重启 Gateway：

openclaw gateway restart

3. 登录蒲公英账号

⚠️ 必须在沙箱浏览器中登录！

1. 打开 OpenClaw Browser
2. 访问 https://pgy.xiaohongshu.com
3. 使用品牌商家账号登录
4. 保持浏览器窗口打开

验证登录：

// 在浏览器控制台执行
if (document.querySelector('.user-info')) {
  console.log('✅ 已登录');
}

使用示例

分析单个博主

分析博主 https://pgy.xiaohongshu.com/solar/pre-trade/blogger-detail/xxx

批量分析

批量分析这些博主：
- https://pgy.xiaohongshu.com/solar/pre-trade/blogger-detail/xxx
- https://pgy.xiaohongshu.com/solar/pre-trade/blogger-detail/yyy
- https://pgy.xiaohongshu.com/solar/pre-trade/blogger-detail/zzz

📊 评估标准（用户自定义）

核心指标

指标	计算公式	达标标准
外溢进店量单价	视频报价 ÷ 外溢进店量	≤ 用户配置的阈值（默认 ¥20）

⚠️ 重要：阈值由用户在首次配置时设置！

品类	推荐阈值	说明
高客单价（>¥2000）	¥30-50	单次获客成本可接受更高
中客单价（¥500-2000）	¥15-30	平衡获客成本
低客单价（<¥500）	¥10-20	需要更低获客成本

粉丝群体画像（用户自定义）

维度	配置项	说明
性别	女性为主/男性为主/均衡	反映用户画像匹配度
年龄	18-24/25-34/35-44/45+	消费力与决策力
地域	一线/新一线/全国	经济水平与市场覆盖
兴趣	美食/家居/数码等	与品牌相关的兴趣标签

评级体系

评级	达标率	建议
A	>80%	强烈推荐合作
B	60-80%	推荐合作
C	40-60%	可考虑合作
D	20-40%	谨慎合作
E	<20%	不建议合作

📁 项目结构

pgy-blogger-analyzer/
├── SKILL.md                      # 主技能文件
├── scripts/
│   └── data_parser.py           # 数据解析脚本
├── references/
│   ├── evaluation-criteria.md   # 评估标准详解
│   ├── troubleshooting.md       # 故障排除指南
│   └── output-templates.md      # 输出模板集合
└── README.md                     # 本文件

🔧 故障排除

常见问题

1. SSRF 策略阻止

错误：Navigation blocked: strict browser SSRF policy...

解决：

• 检查 openclaw.json 配置
• 确认 dangerouslyAllowPrivateNetwork: true
• 重启 Gateway

2. 重定向到登录页

错误：页面显示小红书首页而非博主详情页

解决：

• 确认已在沙箱浏览器登录
• 检查是否使用 browser 工具
• 重新登录蒲公英账号

3. 元素找不到

错误：Element not found: ref=e123

解决：

• 每次交互后重新获取 snapshot
• 等待页面加载完成
• 检查页面结构是否变化

更多故障排除请查看 references/troubleshooting.md

📖 使用文档

• 📋 标准操作流程 (SOP.md) - 详细使用步骤
• 📊 评估标准详解 - 评级体系说明
• 🔧 故障排除指南 - 常见问题解决
• 📝 输出模板集合 - 报告格式参考
• 🚀 发布指南 - GitHub 发布步骤

🤝 贡献指南

欢迎提交 Issue 和 PR！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证开源。

🙏 致谢

• 感谢 QClaw 团队提供的 Skill 框架
• 感谢小红书蒲公英平台提供的数据支持

📸 使用截图

截图即将添加，展示分析过程和报告效果

🛣️ 路线图

• 基础博主分析功能
• 批量分析对比
• 品牌命中检测
• 历史数据对比
• Excel/CSV 导出
• 数据可视化图表
• 定时自动分析
• 更多竞品品牌支持

⭐ Star 历史

📮 contact

• 💬 问题反馈：GitHub Issues
• 📧 邮箱：1015921799@qq.com
• 🌐 项目主页：https://github.com/qclaw/pgy-blogger-analyzer

---

Made with ❤️ by QClaw Team

⭐ Star 本项目 • 🔀 Fork • 🐛 报告问题