- name
- xhs-analytics
- description
- |
小红书数据分析技能
用于整理和分析小红书平台数据，支持笔记搜索、博主分析、热度追踪等功能。
配置 (用户需要自行填写)
在使用前，用户需要在脚本中配置自己的 API 凭证:
# 在 scripts/config.sh 中设置
export XHS_API_KEY="your-api-key"
export XHS_COOKIE="your-cookie"如无 API，可以使用备用方案:
- 第三方数据服务
- 手动输入
- 模拟数据测试
工具
1. 搜索笔记
根据关键词搜索小红书笔记:
# 基础搜索
python3 scripts/search_notes.py --keyword "美妆" --limit 50
# 筛选条件
python3 scripts/search_notes.py \
--keyword "护肤" \
--limit 100 \
--sort "hot" \
--category "笔记"参数:
--keyword: 搜索关键词 (必填)--limit: 返回数量，默认 50--sort: 排序方式 (hot/latest/time)--category: 笔记类型
输出: JSON 格式的笔记列表
2. 分析博主
获取博主基本信息和数据:
python3 scripts/analyze_author.py --user_id "用户ID"输出:
- 粉丝数
- 笔记数
- 获赞与收藏
- 关注数
- 近期数据趋势
3. 热度分析
分析单篇笔记或话题的热度:
python3 scripts/analyze_trend.py --note_id "笔记ID"输出:
- 点赞数
- 收藏数
- 评论数
- 分享数
- 发布时间
- 热度趋势
4. 竞品对比
对比多个博主或笔记的数据:
python3 scripts/compare.py --users "用户1,用户2,用户3"
python3 scripts/compare.py --notes "笔记1,笔记2,笔记3"5. 生成报告
综合分析生成报告:
python3 scripts/generate_report.py \
--keyword "美妆" \
--output report.md \
--format "markdown"使用示例
示例1: 分析"护肤"关键词下的热门笔记
用户: 帮我分析"护肤"关键词下的前100篇热门笔记
帕瓦:
1. 搜索笔记: python3 scripts/search_notes.py --keyword "护肤" --limit 100 --sort "hot"
2. 分析热度: python3 scripts/analyze_trend.py --note_id "每个笔记ID"
3. 生成报告: python3 scripts/generate_report.py --keyword "护肤" --output 护肤分析报告.md示例2: 对比竞品博主
用户: 对比"美妆护肤"领域的前5名博主
帕瓦:
1. 搜索领域关键词获取头部博主
2. 获取每个博主的数据
3. 生成对比表格和报告示例3: 追踪热度趋势
用户: 追踪某个话题最近7天的热度变化
帕瓦:
1. 获取话题相关笔记
2. 按时间聚合数据
3. 生成趋势图表(文字描述)数据来源
- 官方API (需要企业资质):
- 需要用户自行申请 - 配置: scripts/config.sh
- 第三方服务 (可选):
- 用户可接入自己的数据源 - 修改: scripts/api_client.py
- 手动/模拟 (测试用):
- 使用示例数据进行功能测试
输出格式
所有脚本支持 JSON 输出，方便后续处理:
python3 scripts/search_notes.py --keyword "美妆" --format json注意事项
- 遵守平台规则: 请勿高频请求，注意请求间隔
- 数据安全: 来源资料仅供分析使用，勿传播
- API限制: 注意第三方 API 的调用限制
- 隐私保护: 勿整理个人隐私信息
故障排除
Q: 搜索返回空 A: 检查 API 凭证是否正确，或尝试减少 limit
Q: 请求被限制 A: 增加请求间隔，或使用代理
Q: 数据不准确 A: 第三方数据可能有时效性，建议交叉验证