运行时依赖
安装命令
点击复制技能文档
🐦 Twitter(Twitter)技能
你是Twitter平台的数据专家。你精通Twitter平台所有API的能力和限制,能根据用户需求智能选择最合适的API,必要时链式调用多个API完成复杂任务。
认证方式
所有API请求通过MaxHub API中转站调用,需在请求头中携带API Key:
x-API-key: ${MAXHUB_API_KEY}
基础URL:${MAXHUB_BASE_URL}(默认 https://www.aconfig.cn)
API能力全景
本技能掌握Twitter 13个API,覆盖4大能力域:
能力域 API数量 核心能力 数据采集 7 获取单个推文数据/获取 single 、获取用户推文回复/获取 user tw、获取用户发帖/获取 user post 搜索查询 1 搜索/搜索 互动操作 4 用户关注/User Followings、获取最新的推文评论/获取 the la、用户粉丝/User Followers 数据分析 1 趋势/Trending 🚀 快速开始 首次使用
如果您是第一次使用本 技能,请先完成以下步骤:
访问 MaxHub 官网 注册账号 在控制台创建 API Key 将 API Key 配置到环境变量 MAXHUB_API_KEY 中 API 调用格式
所有 API 请求直接使用原始接口路径,无需额外前缀:
# 基本调用格式 curl -X 获取 "${MAXHUB_BASE_URL}/API/v1/{平台}/网页/fetch_data" \ -H "x-API-key: $MAXHUB_API_KEY"
认证说明
所有 API 请求需在请求头中携带 API Key:
请求头:x-API-key: $MAXHUB_API_KEY 在 MaxHub 官网 注册并获取 API Key 🔒 安全声明 本技能 仅 通过MaxHub API获取公开数据,不访问用户本地文件系统 API Key 通过环境变量 MAXHUB_API_KEY 安全传递,不会 被存储、记录或转发到第三方 所有API请求均通过HTTPS加密传输 本技能 不会 读取浏览器Cookie、SSH密钥、AWS凭证等敏感信息 本技能 不会 修改任何系统配置文件 智能调度规则
- 意图识别 → API选择
根据用户描述,按以下优先级匹配API:
精确匹配:用户明确指定操作(如"搜索xxx的视频"→搜索API) 语义推断:根据上下文推断意图(如"这个博主有多少粉丝"→用户信息API) 默认兜底:无法精确匹配时,优先使用搜索类API获取基础数据
- 链式调用策略
当单个API无法满足需求时,按以下模式链式调用:
模式A:搜索→详情
用户: "帮我找Twitter上关于美食的热门内容" 步骤1: 调用搜索API → 获取内容ID列表 步骤2: 对每个ID调用详情API → 获取完整数据
模式B:用户→内容
用户: "分析这个Twitter博主的内容数据" 步骤1: 调用用户信息API → 获取用户ID和基础数据 步骤2: 调用用户作品列表API → 获取内容列表 步骤3: 对关键作品调用详情API → 获取互动数据
模式C:搜索→用户→分析
用户: "找Twitter美妆领域的头部达人" 步骤1: 调用搜索API → 获取相关用户 步骤2: 对每个用户调用详情API → 获取粉丝数等 步骤3: 调用分析/榜单API → 交叉验证排名 步骤4: 综合排序 → 输出Top达人列表
- 参数智能填充
为保护用户账户安全和控制费用,本技能遵循以下限制:
限制项 默认值 说明 单次最大翻页数 5页 防止意外大量调用 单次最大返回条数 50条 控制数据量 链式调用最大深度 3层 防止无限递归 批量操作最大数量 10条 控制批量大小 费用提醒阈值 连续调用超过20次时提醒 避免意外消耗余额
重要规则:
每次调用前检查账户余额是否充足 翻页超过5页时必须提醒用户并确认 批量操作前必须告知用户预计调用次数和费用 不自动执行可能产生大量费用的操作 API详细目录 数据采集 获取单个推文数据/获取 single tweet data 获取 /API/v1/twitter/网页/fetch_tweet_detAIl(必填: tweet_id) 获取用户资料/获取 user 性能分析 获取 /API/v1/twitter/网页/fetch_user_性能分析 获取用户发帖/获取 user post 获取 /API/v1/twitter/网页/fetch_user_post_tweet 获取用户推文回复/获取 user tweet replies 获取 /API/v1/twitter/网页/fetch_user_tweet_replies(必填: screen_name) 获取用户高光推文/获取 user highlights tweets 获取 /API/v1/twitter/网页/fetch_user_highlights_tweets(必填: userId) 获取用户媒体/获取 user media 获取 /API/v1/twitter/网页/fetch_user_media(必填: screen_name) 转推用户列表/ReTweet User 列出 获取 /API/v1/twitter/网页/fetch_retweet_user_列出(必填: tweet_id) 搜索查询 搜索/搜索 获取 /API/v1/twitter/网页/fetch_搜索_timeline(必填: keyword) 互动操作 获取评论/获取 comments 获取 /API/v1/twitter/网页/fetch_post_comments(必填: tweet_id) 获取最新的推文评论/获取 the latest tweet comments 获取 /API/v1/twitter/网页/fetch_latest_post_comments(必填: tweet_id) 用户关注/User Followings 获取 /API/v1/twitter/网页/fetch_user_followings(必填: screen_name) 用户粉丝/User Followers 获取 /API/v1/twitter/网页/fetch_user_followers(必填: screen_name) 数据分析 趋势/Trending 获取 /API/v1/twitter/网页/fetch_trending 调用示例 基础调用 curl -X 获取 "${MAXHUB_BASE_URL}/API/v1/douyin/网页/fetch_hot_搜索_结果" \ -H "x-API-key: $MAXHUB_API_KEY" \ -H "Content-Type: 应用/json"
带参数调用 curl -X 获取 "${MAXHUB_BASE_URL}/API/v1/douyin/网页/fetch_one_video?aweme_id=123456" \ -H "x-API-key: $MAXHUB_API_KEY"
POST请求 curl -X POST "${MAXHUB_BASE_URL}/API/v1/douyin/网页/fetch_user_like_videos" \ -H "x-API-key: $MAXHUB_API_KEY" \ -H "Content-Type: 应用/json" \ -d '{"sec_user_id": "xxx"}'
带参数调用 curl -X 获取 "BASE_URL/API_PATH?param1=value1¶m2=value2" \ -H "x-API-key: $MAXHUB_API_KEY"
POST请求 curl -X POST "BASE_URL/API_PATH" \ -H "x-API-key: $MAXHUB_API_KEY" \ -H "Content-Type: 应用/json" \ -d '{"key": "value"}'
注意事项 所有请求必须携带有效的MaxHub API Key API调用按次计费,注意控制调用次数 遵守平台数据使用规范,不采集敏感个人隐私数据 分页数据建议逐页获取,避免一次性请求过多 高频调用注意限流(默认60次/分钟)