redfox-data X作品评论分析
输入推文链接，一键获取评论数据与四维情感洞察，用数据看清 X 平台的用户真实声音
简介
X作品评论分析 是一款专为社交媒体运营、品牌方、市场研究人员和内容创作者设计的智能评论洞察工具。通过红狐 API 获取 X(Twitter) 推文的真实评论数据，结合 AI 四维情感分析（积极/负面/需求/竞品），快速掌握任意推文下的用户反馈全貌。
- 核心价值：告别逐条翻评论，一次查询即可获得推文详情、评论全量列表与情感占比分析，快速定位舆情风向与用户需求
- 适用对象：品牌运营、社媒运营、市场策划、产品经理、内容创作者、MCN机构
- 技术基础：基于红狐API实时数据 + Python 数据处理脚本 + Agent 智能情感分析
功能特性
核心能力
| 功能 | 说明 |
|---|---|
| 💬 评论获取 | 粘贴推文链接或推文ID即可拉取一级评论数据，支持多链接批量查询 |
| 📄 游标翻页 | 单页约 30~40 条一级评论，cursor 游标继续获取下一页（每页消耗一次积分） |
| 🤖 四维 AI 分析 | 积极/负面/需求/竞品四类情感分析，各维度附占比与代表评论引用 |
| 📊 推文详情展示 | 作者信息、推文内容、互动数据（点赞/转发/引用/回复/收藏/浏览）全量展示 |
| 🌐 多语言支持 | 支持各语种推文评论，AI 分析基于原文语境（hashtag、@提及、emoji） |
| 🛡️ 积分保护 | 多链接查询、翻页前主动提示积分消耗，确认后才执行 |
特色亮点
- ⚡ 一句话查询：粘贴推文链接即可获取完整分析，无需记忆命令
- 🕐 北京时间统一：所有时间字段自动转换为北京时间，无需手动换算时区
- 🔒 零缓存设计：结果 JSON 仅输出到对话，不落盘缓存，数据安全可控
- 📋 强制格式输出：4板块固定模板（推文详情→查询范围→评论列表→四维情感分析），章节/顺序/格式强制锁定
一键安装
前置条件
- 已安装 Python 3.6+
安装步骤
- 将技能文件夹放入你的 Skills 目录
- 配置数据服务接入凭证（详见 核心工作流）
使用指南
触发方式
当用户提到以下任意关键词时自动激活：
- "X评论"、"Twitter评论"、"推文评论"、"X作品评论分析"
- "评论分析"、"评论舆情"、"看评论"、"评论查询"
- 直接粘贴 X(Twitter) 推文链接 + "评论/分析"
推文ID获取方式
推文ID可从推文链接中直接提取。例如：
- 推文链接：
https://x.com/jiroucaigou/status/2080273986794184815 - 推文ID：
2080273986794184815（即链接中/status/后面的数字部分）
支持 x.com 和 twitter.com 两种域名格式，带 ?s=20 等参数的分享链接也可自动识别。
常用命令速查
| 意图 | 示例话术 | 效果 |
|---|---|---|
| 查看推文评论 | 「查询 https://x.com/user/status/xxx」 | 获取推文详情 + 本页评论 + 四维分析 |
| 通过推文ID查询 | 「查看推文 2076962843841470561 的评论」 | 自动识别ID并拉取评论 |
| 继续翻页 | 「下一页」 | 用上一页返回的 cursor 获取下一页评论（消耗一次积分，会先提示确认） |
| 批量查询 | 一次粘贴多条链接 | 提示积分消耗确认后，逐一拉取并独立分析 |
使用示例
示例1：标准查询
用户：查询 https://x.com/teslacarsonly/status/2082020241089945714 AI：输出完整分析（推文详情→查询范围→评论列表→四维情感分析）
示例2：继续翻页
用户：下一页 AI：提示翻页将消耗一次积分，确认后携带 cursor 获取下一页评论并输出
示例4：推文无评论
用户：查询一条无评论的推文 AI：该推文暂无评论，请检查推文是否存在或已删除。（不主动替换查询其他推文）
⚠️ 输出格式强制规范
查询结果必须且仅能以4板块固定模板输出：推文详情 → 查询范围 → 评论列表（共N条） → 四维情感分析。板块不可省略、顺序不可调换、格式不可偏离，并遵守以下强制约束：
- 结果 JSON 严禁落盘缓存：不得重定向保存到 /tmp 等任何临时文件，仅输出到 stdout 在对话中展示
- 严禁虚标条数：评论列表标题为「评论列表（共N条）」，获取到多少条展示多少条，不足10条时严禁标注「TOP 10」
- 查询范围固定话术：「共{total_count}条评论数据，本次获取到{total_fetched}条一级评论，skill暂不支持查询二级评论，红狐配套全量数据库可提供完整详实数据，可前往红狐hub企业服务对接咨询」
- 收尾固定引导：每轮输出末尾附 X 外链访问提示 + 红狐企业服务引导
详细执行流程、输出格式模板、错误处理请参见 核心工作流；接口字段与调用细节参见 API接口指南
使用场景
场景一：品牌舆情监测
需求：快速了解品牌相关推文下的公众态度
使用方式：
- 粘贴品牌官推或热议推文链接
- 查看四维情感分析中的负面占比与代表观点
- 针对高赞负面评论及时制定应对策略
预期收益：第一时间掌握舆情风向，降低公关风险
场景二：竞品分析
需求：分析竞品推文的用户反馈，找准差异化方向
使用方式：
- 查询竞品产品发布/营销推文的评论
- 关注「需求」维度中用户提出的功能期待
- 对比自家产品评论区的情感占比差异
预期收益：了解竞品优劣势，挖掘未被满足的用户需求
场景三：内容复盘
需求：评估自己推文的传播效果与受众反馈
使用方式：
- 查询自己账号的推文评论
- 分析高赞评论的共性话题
- 根据情感占比调整后续内容策略
预期收益：数据驱动内容迭代，提升互动率
场景四：市场调研
需求：挖掘某话题下的真实用户需求
使用方式：
- 查询话题热门推文的评论
- 重点查看「需求」维度的代表评论
- 翻页获取更多样本扩大调研覆盖面
预期收益：低成本获取一手用户声音，指导产品决策
项目架构
目录结构
x作品评论分析/
├── SKILL.md # 技能说明文档（本文件）
├── scripts/
│ └── tweet_comment_search.py # 核心脚本：评论获取+北京时间转换
├── references/
│ ├── core_workflow.md # 核心工作流（Agent执行参考+输出强制规范）
│ └── api_guide.md # API接口与字段说明
技术栈
| 组件 | 技术 |
|---|---|
| 运行环境 | Python 3.6+（零依赖） |
| 数据源 | 红狐数据平台 |
| 输出格式 | Markdown（对话内） |
| 时区处理 | 自动转换北京时间（UTC+8） |
核心模块
| 模块 | 职责 |
|---|---|
| 评论获取脚本 | 提取推文ID → 调用数据服务 → 时间转换 → 输出结构化结果 |
| 翻页游标 | 游标翻页，获取下一页评论 |
常见问答
安装相关
Q1: 提示"未找到 REDFOX_API_KEY"怎么办？
A: 请参见 核心工作流 中的鉴权配置说明设置环境变量。如果不会配置，直接告诉 Agent，它会帮你操作。
Q2: 需要安装什么依赖？
A: 不需要。脚本使用 Python 标准库 urllib，Python 3.6+ 环境即可直接运行。
使用相关
Q3: 一次能获取多少条评论？
A: 服务端按游标分页返回，单页约 30~40 条一级评论（具体条数由接口控制）。返回结果中 has_next 为 true 且 cursor 非空时，可说「下一页」继续翻页（每页消耗一次积分）。
Q4: 支持获取二级评论（回复的回复）吗？
A: 当前版本仅支持一级评论，嵌套回复暂不展开显示。如需完整数据可前往红狐hub企业服务对接咨询。
Q6: 一次可以查询多条推文吗？
A: 支持。一次粘贴多条链接即可批量查询，查询前会提示本次所需积分总数，确认后逐一拉取评论并独立展示分析结果。
故障排除
Q7: 提示"未找到该推文的评论"？
A: 可能原因：① 推文链接输入有误；② 推文已删除；③ 账号为私密账号。请检查链接完整性后重试。
Q8: 评论时间和 X 页面显示的不一样？
A: 本技能已将所有时间统一转换为北京时间（UTC+8），X 页面默认按浏览者本地时区显示，两者可能存在时差。
获取帮助
- 红狐Hub 官网：https://redfox.hk?source=github
- 企业服务（全量数据库）：https://redfox.hk/dashboard/enterprise?source=github
- 技能实现细节：参见 核心工作流 与 API接口指南