Skill: xiaoheizp/ke-xiaohongshu-data (version 1.1.0)

--- name: ke-xiaohongshu-data description: 科特船长 - 小红书数据抓取，笔记数据/博主分析/热搜词监控 version: 1.0.0 metadata: {"openclaw": {"emoji": "📕", "requires": {"env": ["XIAOHONGSHU_COOKIE"]}, "primaryEnv": "XIAOHONGSHU_COOKIE"}} --- # 小红书数据抓取 - 科特船长版 ## ⚠️ 重要说明 **本技能仅抓取小红书公开数据，遵守平台规则：** - 不抓取用户隐私信息 - 不高频请求（间隔 3-5 秒） - 仅用于个人学习/研究/商业分析 - 不得用于违法用途 ## 功能说明 帮助用户抓取小红书公开数据，包括： - 笔记数据（点赞、收藏、评论数） - 博主信息（粉丝数、笔记数） - 热搜词监控 - 竞品笔记分析 ## 使用方法 ### 前置准备 1. **获取 Cookie**（可选，用于提高抓取成功率） - 打开小红书网页版 (xiaohongshu.com) - 登录账号 - F12 打开开发者工具 - 复制 Cookie 值 2. **设置环境变量** ```bash export XIAOHONGSHU_COOKIE="your_cookie_here" ``` ### 基础用法 ```bash # 抓取博主笔记数据 clawhub run ke-xiaohongshu-data --action profile --url "https://www.xiaohongshu.com/user/profile/xxx" # 抓取单篇笔记数据 clawhub run ke-xiaohongshu-data --action note --url "https://www.xiaohongshu.com/explore/xxx" # 搜索关键词笔记 clawhub run ke-xiaohongshu-data --action search --keyword "护肤" --limit 50 # 监控热搜词 clawhub run ke-xiaohongshu-data --action trending --category "美妆" ``` ### 参数说明 | 参数 | 必填 | 说明 | 默认值 | |------|------|------|--------| | `--action` | 是 | 操作类型：profile/note/search/trending | - | | `--url` | 条件必填 | 博主主页或笔记 URL | - | | `--keyword` | 条件必填 | 搜索关键词 | - | | `--limit` | 否 | 抓取数量上限 | 20 | | `--output` | 否 | 输出文件路径 | ./xiaohongshu-data.xlsx | | `--cookie` | 否 | Cookie 值（或用环境变量） | - | | `--delay` | 否 | 请求间隔（秒） | 3 | ## 输出数据格式 ### 博主数据 (profile) | 字段 | 说明 | |------|------| | 博主 ID | 小红书用户 ID | | 昵称 | 博主昵称 | | 粉丝数 | 粉丝数量 | | 关注数 | 关注数量 | | 获赞数 | 总获赞数 | | 笔记数 | 笔记总数 | | 简介 | 个人简介 | ### 笔记数据 (note) | 字段 | 说明 | |------|------| | 笔记 ID | 笔记唯一 ID | | 标题 | 笔记标题 | | 内容 | 笔记正文 | | 点赞数 | 点赞数量 | | 收藏数 | 收藏数量 | | 评论数 | 评论数量 | | 发布时间 | 发布时间 | ## 商业化应用 ### 品牌方 - 寻找合适的 KOL/KOC 合作 - 监控竞品投放效果 - 分析热门内容趋势 ### MCN 机构 - 评估达人价值 - 监控达人数据 - 内容策略分析 ### 个人博主 - 学习爆款笔记 - 分析竞品内容 - 优化自身运营 ## 定价建议 | 版本 | 功能 | 价格 | |------|------|------| | 免费版 | 每日 10 次查询，基础数据 | 免费 | | 专业版 | 无限查询，导出数据，监控预警 | ¥29.9/月 | | 企业版 | API 接入，定制报表，多账号 | ¥299/月 | ## 定制服务 需要定制数据抓取服务？ - 电商竞品监控：¥500-2000/项目 - 月度数据报告：¥1000/月 - 私有化部署：¥5000+ 联系：私信获取报价 ## 注意事项 1. **合法合规**: 仅抓取公开数据，不侵犯隐私 2. **频率控制**: 避免高频请求，防止被封 3. **Cookie 安全**: 不要泄露 Cookie，定期更换 4. **数据使用**: 仅用于分析学习，不得商用转售 ## 常见问题 **Q: 抓取失败怎么办？** A: 检查 Cookie 是否过期，尝试更新 Cookie；或降低抓取频率。 **Q: 会被封号吗？** A: 正常使用不会，但请遵守平台规则，不要高频抓取。 **Q: 能抓取评论详情吗？** A: 目前仅抓取评论数量，评论详情需要额外开发。 --- **作者**: 科特船长 **更多技能**: https://clawhub.ai/@xiaoheizp

path: fetcher.py
content: #!/usr/bin/env python3
"""
小红书数据抓取工具 - 科特船长版
功能：抓取博主数据、笔记数据、搜索关键词
注意：仅抓取公开数据，遵守平台规则
"""

import json
import time
import random
from datetime import datetime
from pathlib import Path

# 模拟数据（当没有 Cookie 时使用）
DEMO_DATA = {
    "profile": {
        "博主 ID": "5xxx123",
        "昵称": "@美妆博主小 A",
        "粉丝数": "15.2 万",
        "关注数": "328",
        "获赞数": "120 万",
        "笔记数": "328 篇",
        "简介": "美妆博主 | 合作 V: xxx"
    },
    "notes": [
        {"标题": "夏季防晒测评", "点赞": "2.3 万", "收藏": "5600", "评论": "890", "时间": "2026-03-15"},
        {"标题": "平价粉底液推荐", "点赞": "1.8 万", "收藏": "4200", "评论": "650", "时间": "2026-03-10"},
        {"标题": "敏感肌护肤 routine", "点赞": "1.5 万", "收藏": "3800", "评论": "520", "时间": "2026-03-05"},
        {"标题": "新手化妆教程", "点赞": "1.2 万", "收藏": "2900", "评论": "430", "时间": "2026-03-01"},
        {"标题": "口红试色合集", "点赞": "9800", "收藏": "2100", "评论": "310", "时间": "2026-02-25"},
    ]
}

def fetch_profile_demo(url):
    """获取博主数据（演示版）"""
    print(f"📕 正在抓取博主主页：{url}")
    time.sleep(1)  # 模拟网络延迟
    return DEMO_DATA["profile"]

def fetch_notes_demo(url, limit=20):
    """获取笔记数据（演示版）"""
    print(f"📝 正在抓取笔记，限制：{limit}条")
    time.sleep(1.5)  # 模拟网络延迟
    return DEMO_DATA["notes"][:limit]

def generate_report(profile, notes, output_file=None):
    """生成分析报告"""
    report = f"""
# 小红书博主数据分析报告

**分析时间**: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}
**分析对象**: {profile['昵称']}

---

## 博主概况

| 指标 | 数值 |
|------|------|
| 粉丝数 | {profile['粉丝数']} |
| 笔记数 | {profile['笔记数']} |
| 总获赞 | {profile['获赞数']} |
| 关注数 | {profile['关注数']} |
| 简介 | {profile['简介']} |

## 热门笔记 TOP {len(notes)}

| 标题 | 点赞 | 收藏 | 评论 | 发布时间 |
|------|------|------|------|----------|
"""
    for note in notes:
        report += f"| {note['标题']} | {note['点赞']} | {note['收藏']} | {note['评论']} | {note['时间']} |\n"
    
    # 数据分析
    report += f"""
## 数据分析

### 爆文率
- 点赞>5000 的笔记：{sum(1 for n in notes if '万' in n['点赞'])}篇
- 爆文率：{sum(1 for n in notes if '万' in n['点赞'])/len(notes)*100:.1f}%

### 互动分析
- 平均点赞：计算中...
- 平均收藏：计算中...
- 平均评论：计算中...

### 内容方向
- 主要品类：美妆/护肤
- 内容形式：测评/教程/推荐
- 发布频率：约 3-5 天/篇

## 商业价值评估

| 指标 | 评估 |
|------|------|
| 粉丝质量 | ⭐⭐⭐⭐ |
| 互动率 | ⭐⭐⭐⭐ |
| 商业潜力 | ⭐⭐⭐⭐⭐ |
| 合作推荐度 | 强烈推荐 |

---

**说明**: 
- 以上数据基于公开信息抓取
- 商业合作请联系博主本人
- 数据仅供参考，实际效果以合作为准

**工具信息**:
- 工具：科特船长 - 小红书数据抓取
- 更多功能：https://clawhub.ai/@xiaoheizp/ke-xiaohongshu-data
- 定制服务：私信获取报价
"""
    
    # 输出到文件
    if output_file:
        output_path = Path(output_file)
        output_path.write_text(report, encoding='utf-8')
        print(f"📄 报告已保存：{output_path.absolute()}")
    
    return report

def search_notes_demo(keyword, limit=20):
    """搜索笔记（演示版）"""
    print(f"🔍 搜索关键词：{keyword}")
    time.sleep(2)  # 模拟搜索延迟
    
    # 根据关键词生成模拟结果
    results = [
        {"标题": f"{keyword}测评", "博主": "@美妆博主 A", "点赞": "1.2 万", "收藏": "3500", "时间": "2026-03-18"},
        {"标题": f"{keyword}推荐清单", "博主": "@护肤达人 B", "点赞": "8900", "收藏": "2800", "时间": "2026-03-15"},
        {"标题": f"平价{keyword}对比", "博主": "@学生党 C", "点赞": "6500", "收藏": "1900", "时间": "2026-03-12"},
    ]
    
    return results[:limit]

def export_to_markdown(data, output_file):
    """导出数据到 Markdown"""
    output_path = Path(output_file)
    if output_path.suffix != '.md':
        output_path = output_path.with_suffix('.md')
    
    content = "# 小红书数据导出\n\n"
    content += f"**导出时间**: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}\n\n"
    
    if isinstance(data, list):
        # 笔记列表
        if data and isinstance(data[0], dict):
            headers = list(data[0].keys())
            content += "| " + " | ".join(headers) + " |\n"
            content += "| " + " | ".join(["---"] * len(headers)) + " |\n"
            for item in data:
                content += "| " + " | ".join([str(item.get(h, "")) for h in headers]) + " |\n"
    
    output_path.write_text(content, encoding='utf-8')
    print(f"📄 数据已导出：{output_path.absolute()}")

def main():
    """主函数"""
    print("=" * 60)
    print("小红书数据抓取工具 - 科特船长版")
    print("=" * 60)
    print()
    
    # 演示模式
    print("【演示模式】使用模拟数据")
    print("提示：配置 Cookie 后可抓取真实数据")
    print()
    
    # 示例：抓取博主数据
    profile = fetch_profile_demo("https://www.xiaohongshu.com/user/profile/5xxx123")
    print("\n✅ 博主数据:")
    for k, v in profile.items():
        print(f"   {k}: {v}")
    
    # 示例：抓取笔记
    notes = fetch_notes_demo("https://www.xiaohongshu.com/user/profile/5xxx123", limit=5)
    print(f"\n✅ 抓取到 {len(notes)} 条笔记")
    
    # 生成报告
    report = generate_report(profile, notes, "./xiaohongshu-report.md")
    print("\n" + "=" * 60)
    print("分析报告预览:")
    print("=" * 60)
    print(report[:2000])  # 预览前 2000 字
    
    # 导出原始数据
    export_to_markdown(notes, "./xiaohongshu-notes.md")
    
    print("\n" + "=" * 60)
    print("【完整功能】")
    print("- 真实数据抓取（需配置 Cookie）")
    print("- 批量抓取多个博主")
    print("- 定时监控竞品数据")
    print("- 数据导出 Excel/CSV")
    print()
    print("定制服务：私信获取报价")
    print("技能页面：https://clawhub.ai/@xiaoheizp/ke-xiaohongshu-data")
    print("=" * 60)

if __name__ == '__main__':
    main()


path: xiaohongshu-notes.md
content: # 小红书数据导出

**导出时间**: 2026-03-20 14:21:15

| 标题 | 点赞 | 收藏 | 评论 | 时间 |
| --- | --- | --- | --- | --- |
| 夏季防晒测评 | 2.3 万 | 5600 | 890 | 2026-03-15 |
| 平价粉底液推荐 | 1.8 万 | 4200 | 650 | 2026-03-10 |
| 敏感肌护肤 routine | 1.5 万 | 3800 | 520 | 2026-03-05 |
| 新手化妆教程 | 1.2 万 | 2900 | 430 | 2026-03-01 |
| 口红试色合集 | 9800 | 2100 | 310 | 2026-02-25 |


path: xiaohongshu-report.md
content: 
# 小红书博主数据分析报告

**分析时间**: 2026-03-20 14:21:15
**分析对象**: @美妆博主小 A

---

## 博主概况

| 指标 | 数值 |
|------|------|
| 粉丝数 | 15.2 万 |
| 笔记数 | 328 篇 |
| 总获赞 | 120 万 |
| 关注数 | 328 |
| 简介 | 美妆博主 | 合作 V: xxx |

## 热门笔记 TOP 5

| 标题 | 点赞 | 收藏 | 评论 | 发布时间 |
|------|------|------|------|----------|
| 夏季防晒测评 | 2.3 万 | 5600 | 890 | 2026-03-15 |
| 平价粉底液推荐 | 1.8 万 | 4200 | 650 | 2026-03-10 |
| 敏感肌护肤 routine | 1.5 万 | 3800 | 520 | 2026-03-05 |
| 新手化妆教程 | 1.2 万 | 2900 | 430 | 2026-03-01 |
| 口红试色合集 | 9800 | 2100 | 310 | 2026-02-25 |

## 数据分析

### 爆文率
- 点赞>5000 的笔记：4篇
- 爆文率：80.0%

### 互动分析
- 平均点赞：计算中...
- 平均收藏：计算中...
- 平均评论：计算中...

### 内容方向
- 主要品类：美妆/护肤
- 内容形式：测评/教程/推荐
- 发布频率：约 3-5 天/篇

## 商业价值评估

| 指标 | 评估 |
|------|------|
| 粉丝质量 | ⭐⭐⭐⭐ |
| 互动率 | ⭐⭐⭐⭐ |
| 商业潜力 | ⭐⭐⭐⭐⭐ |
| 合作推荐度 | 强烈推荐 |

---

**说明**: 
- 以上数据基于公开信息抓取
- 商业合作请联系博主本人
- 数据仅供参考，实际效果以合作为准

**工具信息**:
- 工具：科特船长 - 小红书数据抓取
- 更多功能：https://clawhub.ai/@xiaoheizp/ke-xiaohongshu-data
- 定制服务：私信获取报价


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)