Verosight Monitor — 社交媒体情报技能

集成 Verosight API，实现对主流社交平台的实时社交媒体监控与数字声誉管理。

快速配置

1. 获取 API 密钥

在 verosight.com 注册账号，并在 API Keys 控制台中生成 API 密钥。密钥以 vlt_live_（生产环境）或 vlt_test_（测试环境）开头。

2. 认证

使用 API 密钥换取 JWT 令牌（有效期 24 小时）：

JWT=$(curl -s -X POST "https://api.verosight.com/v1/auth/token" 
  -H "X-API-Key: vlt_live_YOUR_KEY" | jq -r '.token')

或使用内置认证脚本：

./scripts/verosight-auth.sh vlt_live_YOUR_KEY

3. 查询数据

# 情感分析
curl -s "https://api.verosight.com/v1/analytics/sentiment?query=KEYWORD&sources=x,instagram&days=7" 
  -H "Authorization: Bearer $JWT"

# 搜索帖子
curl -s "https://api.verosight.com/v1/posts?query=KEYWORD&sources=x,instagram&limit=10" 
  -H "Authorization: Bearer $JWT"

API 端点

帖子

GET /v1/posts

支持按条件筛选，在多个平台中搜索帖子。

GET /v1/posts/:id

根据 ID 获取单条帖子。

GET /v1/posts/:id/comments

获取某条帖子下的评论。

分析

GET /v1/analytics/sentiment

针对关键词执行情感分析。返回正面/负面/中性占比（加权百分比）及样例帖子。

GET /v1/analytics/volume

随时间变化的帖子/评论数量（按日拆分）。

GET /v1/analytics/trending

围绕关键词的热门帖子与热门账号。

账号档案

GET /v1/profiles?query=ACCOUNT&source=instagram

搜索社交媒体账号档案。

GET /v1/profiles/:source/:account

获取账号档案详情（如缺失则自动抓取）。

GET /v1/profiles/:source/:account/stats

获取账号的互动统计信息。

搜索

POST /v1/search

在全部内容中执行语义搜索。

请求体：

{
  "query": "keyword",
  "sources": ["x", "instagram"],
  "days": 7
}

账户

GET /v1/account/balance

查询余额（免费调用）。

GET /v1/account/usage

查询用量历史与统计信息（免费调用）。

响应格式

所有响应均遵循统一信封结构：

{
  "data": { ... },
  "meta": {
    "request_id": "uuid",
    "credits_used": 2,
    "credits_remaining": 998
  },
  "pagination": {
    "next_cursor": "base64...",
    "has_more": true,
    "total": 38113
  }
}

工作流

情感分析报告

1. 完成认证 → 获取 JWT
2. 调用 /v1/analytics/sentiment → 获取正面/负面/中性分布
3. 调用 /v1/posts 并设置 sentiment=negative → 识别活跃负面发声账号
4. 调用 /v1/analytics/volume → 分析时间趋势
5. 编撰报告：概览 → 趋势 → 叙事脉络 → 洞察 → 建议

详细工作流请参见 references/sentiment-workflow.md。

影响力人物识别

1. 检索目标话题下高互动率的帖子
2. 按点赞数、转发数、观看量排序
3. 结合情感倾向交叉分析（区分正面/负面影响力人物）
4. 对排名靠前的账号，核查其粉丝数与认证状态

机器人账号检测

1. 跨平台检索目标话题相关帖子
2. 识别可疑模式：
   • 同一账号在短时间内发布多条内容
   • 多个账号发布完全相同或高度相似的内容
   • 发布时间呈现协同性
   • 新注册账号表现出异常高的活跃度
3. 标记可疑账号供人工复核

PDF 报告生成

使用 pdfkit（Node.js）生成专业级报告，支持表格、图表与排版样式。

完整指南请参见 references/pdf-template.md。

支持的平台

积分系统

每次成功 API 调用（HTTP 2xx 响应）将消耗积分；失败调用（4xx/5xx）不扣减积分。

查询余额：

curl -s "https://api.verosight.com/v1/account/balance" 
  -H "Authorization: Bearer $JWT"

已知限制

• 新闻门户结果占总量主导（约 70%），社交平台贡献比例较低
• 语义搜索返回结果覆盖面较广，但对来源和日期的筛选能力有限
• Instagram 直接爬取常被屏蔽；请始终通过 Verosight API 获取 Instagram 数据
• 部分账号的档案元数据（如粉丝数、注册时间）可能不可用

附带资源

相关链接

• Verosight API
• API Dashboard
• Documentation
• ClawHub
• GitHub