核心用法
maxhub-twitter 是一款面向 Twitter/X 平台的综合数据查询技能，通过 MaxHub API 提供 12+ 活跃端点的数据服务。用户需先配置 MAXHUB_API_KEY，即可通过自然语言指令完成推文搜索、用户资料获取、评论采集、趋势追踪等操作。
交互流程：系统会自动检测 API Key 状态，支持简单查询（单次调用）与深度分析（多接口编排）两种模式，并根据用户意图自动路由至「推文数据」「用户数据」「搜索与趋势」或「深度分析」四大模块。
输出特性：中英文双语适配，数字自动人性化（中文：万/亿；英文：K/M/B），结果以 Markdown 表格或结构化列表呈现，并附带后续操作建议。
显著优点
1. 功能覆盖全面：涵盖推文详情、用户画像、关键词搜索、热搜趋势、评论/转发列表等 Twitter/X 核心数据场景
2. 智能降级机制：遇到 404/500/410 错误时，自动按预设映射切换至替代接口，提升查询成功率
3. 场景化设计：内置海外舆情监控、热点追踪、KOL影响力分析三大典型应用流程
4. 安全合规声明明确：强调只读数据查询，不涉及账号操作或平台操纵，降低合规风险
潜在局限
- 依赖第三方 API：数据源为 MaxHub 第三方服务，非 Twitter 官方 API，数据时效性与完整性受上游约束
- 需付费 API Key：使用前需在 aconfig.cn 注册并获取 API Key，存在一定使用门槛
- 网络访问限制：服务域名 www.aconfig.cn 需稳定访问，部分地区可能存在连接问题
- 错误处理复杂：涉及多版本接口降级，用户难以直观理解底层切换逻辑
适合人群
- 海外公关/舆情分析师：实时监控品牌提及与危机传播
- 社媒运营团队：追踪热点话题、分析竞品动态
- 营销投放决策者：评估 Twitter KOL 粉丝质量与互动表现
- 学术/媒体研究者：采集公开推文数据进行趋势分析
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据准确性 | 第三方数据可能与平台实时数据存在延迟或偏差 | 关键决策前交叉验证官方数据源 |
| API 服务稳定性 | 上游服务中断或接口下线导致功能不可用 | 依赖技能的降级机制，或准备备用数据源 |
| 隐私合规 | 采集用户公开数据需注意 GDPR 等法规边界 | 仅用于分析目的，避免存储敏感个人信息 |
| 密钥泄露 | MAXHUB_API_KEY 为敏感凭证 | 按指南配置环境变量，避免硬编码或日志泄露 |