x-comment-analyzer · diff
git:20260728.4afafa3 to git:20260728.5b15c5a
7 added, 6 removed. Audit A to A.
---
name: twitter-comment
description: X(Twitter)作品评论分析工具。输入推文链接或推文ID即可获取评论数据，支持四维情感分析（积极/负面/需求/竞品），生成精美 HTML 报告。当用户需要查看X(Twitter)推文评论、分析推文舆情、了解用户反馈时使用。触发词：X评论、Twitter评论、推文评论、评论查询、评论分析、评论舆情、看评论、twitter评论、X推文。
---
# X(Twitter)作品评论分析
## 简介
X(Twitter)作品评论分析是一款专为社交媒体运营、品牌方、市场研究人员和内容创作者设计的智能评论洞察工具。输入任意推文链接或推文ID，即可一键获取评论数据，并通过四维情感分析（积极/负面/需求/竞品）快速了解用户真实反馈，同时生成可离线保存的交互式 HTML 报告。
通过本技能，你可以：
- 📊 一键获取推文详情和全部一级评论数据
- 🤖 AI 自动完成四维情感分析，理解多语言推文语境
- 📋 生成 X 暗黑主题交互式 HTML 报告，便于保存与分享
适用于品牌舆情监测、社媒运营复盘、竞品分析、市场调研等场景。
## 功能特性
### 核心功能
- **评论获取**：粘贴推文链接或推文ID即可拉取评论数据，支持一次提交多条链接批量查询
- **多语言支持**：支持各语种推文评论，AI 分析基于原文语境
- **四维 AI 分析**：积极/负面/需求/竞品四类情感分析，各维度附代表评论引用
- **推文详情展示**：作者信息、推文内容、互动数据（点赞/转发/引用/回复/收藏/浏览）全量展示
- **HTML 报告**：X 暗黑主题交互式报告，支持离线保存与分享
- **积分保护**：多链接查询前主动提示积分消耗，确认后才执行
### 特色亮点
- **多语言语境理解**：识别 hashtag、@提及、表情符号及不同语种的表达习惯
- **数据完整展示**：推文详情、评论表格全量呈现，不截断关键信息
- **编码安全回填**：智能编码保障，中文分析内容完整无误地注入报告
## 鉴权
- 获取 API Key：前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github)
- 配置方式1：写入 `~/.openclaw/openclaw.json` → `{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }`
- 配置方式2：终端执行 `export REDFOX_API_KEY="ak_xxxx..."`
## 工作流程
> 核心执行流程详见 `references/core_workflow.md`
## 使用指南
直接用自然语言说出推文链接或推文ID即可，无需记忆固定命令。
### 推文ID获取方式
推文ID可从推文链接中直接提取。例如：
- 推文链接：`https://x.com/jiroucaigou/status/2080273986794184815`
- 推文ID：`2080273986794184815`（即链接中 `/status/` 后面的数字部分）
支持 `x.com` 和 `twitter.com` 两种域名格式。
### 常用说法速查
| 意图 | 示例话术 | 效果 |
|------|---------|------|
| 查看推文评论 | 「查看推文 2076962843841470561 的评论」 | 获取推文详情 + 全部评论 + AI分析 |
| 通过链接查询 | 粘贴 `https://x.com/username/status/2076962843841470561` | 自动提取推文ID并拉取评论 |
| 批量查询 | 一次粘贴多条链接 | 提示积分消耗确认后，逐一拉取并独立分析 |
| 生成报告 | 「需要」「生成HTML」 | 回填AI分析，生成交互式HTML报告 |
### 多链接查询
支持一次性提交多条推文链接，如：
> 「帮我分析这两条推文的评论：https://x.com/... https://x.com/...」
当检测到多条链接时，会先提示本次查询所需积分数，用户确认后才开始逐一执行。每条推文独立展示评论数据和四维分析结果。
### 输出示例
完成查询后，你将依次收到：
- 1. **推文详情**（作者信息含可点击主页链接、推文内容、作品链接、互动数据）
- 2. **评论表格 TOP 10**（按热度排序的前10条评论，含用户链接、内容、点赞/转发/回复数、时间）
- 3. **四维情感分析**（积极/负面/需求/竞品，各附代表评论）
- 4. **询问是否生成 HTML 报告**
- 5. **链接访问提示**（所有链接均为 X 平台外链，境内网络不可直接访问）
- 6. **企业服务引导**（红狐全量数据库采购方案咨询入口）
+ 1. **推文详情**（表格形式：作者信息含可点击主页链接、推文内容、作品链接、互动数据含点赞/转发/引用/回复/收藏/浏览）
+ 2. **查询范围**（该推文总评论数与实际获取条数）
+ 3. **评论列表 TOP 10**（按热度排序的前 10 条评论，表格含用户链接、内容、点赞/转发/回复数、时间）
+ 4. **四维情感分析**（积极/负面/需求/竞品四维度，表格含占比与分析）
+ 5. **询问是否生成 HTML 报告**
+ 6. **链接访问提示**（所有链接均为 X 平台外链，境内网络不可直接访问）
+ 7. **企业服务引导**（红狐全量数据库采购方案咨询入口）
## 使用场景
| 场景 | 角色 | 示例问法 | 收益 |
|------|------|---------|------|
| 舆情监测 | 品牌运营 | 「分析这条推文的用户评论情绪」 | 快速了解公众态度，及时应对舆情 |
| 竞品分析 | 市场策划 | 「看看竞品这条推文的评论反馈」 | 了解竞品优劣势，找准差异化方向 |
| 内容复盘 | 社媒运营 | 「这条推文的评论怎么样」 | 了解受众反馈，优化内容策略 |
| 市场调研 | 产品经理 | 「看看用户在这个话题下的需求」 | 挖掘真实需求，指导产品迭代 |
## 常见问答
### 安装相关
**Q1: 如何获取 REDFOX_API_KEY？**
A: 前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) 注册账号并申请 API Key，按鉴权章节说明配置到本地环境变量。
**Q2: 需要安装额外依赖吗？**
A: 不需要。脚本使用 Python 标准库 `urllib`，Python 3.6+ 环境即可直接运行。
### 使用相关
**Q3: 一次能获取多少条评论？**
A: 每次调用获取推文全部一级评论（线程回复）。如需更多深度数据或历史数据，可前往 [红狐平台](https://redfox.hk/) 联系客服获取批量能力。
**Q4: 支持获取二级评论（回复的回复）吗？**
A: 当前版本仅支持一级评论，嵌套回复暂不展开显示。
**Q5: 如有其他问题如何获取帮助？**
A: 前往 [红狐平台](https://redfox.hk/) 联系客服，或查阅技能文档。
**Q6: 一次可以查询多条推文吗？**
A: 支持。一次粘贴多条链接即可批量查询，查询前会提示本次所需积分总数，确认后逐一拉取评论并独立展示分析结果。