概览
想看清某条 Twitter 帖子的正文、点赞转发、评论数和作者信息——但逐条打开页面太低效?提交帖子编号清单,任务在后台完成后,你会拿到结构化的帖子详情表,可以直接做互动分析或导出给下游工具。
比起手工复制帖子内容与互动数字,它把多个帖子编号的公开字段一次拉全并对齐成统一列名,互动指标与发布信息都是取数当时的快照,适合当作舆情监测、内容对标和传播分析的数据底表。
数据说明
详情取自 Twitter 公开可见的帖子页面,按本次提交的编号逐条对应,每个编号最多一条记录。点赞数、评论数、转发数、引用数与浏览数是取数当时的公开统计值;正文为帖子公开文字内容,可能含链接与媒体引用。转发帖会标记「是否转发」,并尽量给出被转推的原帖子编号。仅覆盖公开可见内容,受保护账号或已删除帖子不在其中。
结果长什么样
每条记录是一条 Twitter 帖子:
| 帖子编号 | 作者昵称 | 点赞数 | 评论数 | 转发数 | 发布时间 |
|---|---|---|---|---|---|
| 1034243881263542272 | ヒビトラ | 11 | 0 | 1 | 2018-08-28T08:58:51 |
另有帖子正文、帖子链接、内容类型、作者粉丝数等字段。
应用场景
- 做传播分析时,按「点赞数」「转发数」「浏览数」对比多条帖子的互动表现。
- 做内容对标时,结合「帖子正文」与「内容类型」,归纳高互动帖的表述与媒介形式。
- 追踪舆情帖时,用「提交编号」对齐监测清单,定期重跑比对互动数变化。
- 串联分析流水线时,从账号帖子列表 App 拿到编号,交给本 App 补齐正文与互动明细。
适用边界
单次最多 100 个帖子编号;每个编号最多返回一条公开详情,不含私密或未公开内容。
- 适合用于
- 需要获取 Twitter 帖子的正文、点赞、转发、评论数等互动明细时
- 已有帖子编号清单,需要补齐作者信息与发布时间等字段时
- 不要用于
- 只有账号编号、需要拉时间线帖子列表时——用账号帖子列表类 App
- 需要帖子下全部评论明细时——用评论采集类 App
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务失败或过期可原样重新提交;部分编号失败时仍可拉取已成功采集的结果
- 2帖子编号无效或内容不可公开访问时,对应记录可能缺失或字段为空
- 3鉴权失败属不可重试错误,需先配置有效 API 密钥
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| post_ids | 帖子编号 | array<object> | 是 | — | 最多 100 项 | [{"kw":"1034243881263542272"}] | 要采集详情的 Twitter 帖子编号(content ID),纯数字,可从帖子链接末尾或账号帖子列表结果中获取,一次最多 100 个 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| content_id | 帖子编号 | string | — | 帖子在平台内的唯一编号 |
| content_url | 帖子链接 | string | — | 帖子页面 URL |
| content_text | 帖子正文 | string | — | 帖子文字内容 |
| content_type | 内容类型 | string | — | 帖子内容类型,如 video、text 等 |
| publish_time | 发布时间 | string | — | 帖子公开发布时间 |
| publish_location | 发布位置 | string | — | 帖子标注的发布地点 |
| crawl_time | 采集时间 | string | — | 本条详情采集完成的时间 |
| like_count | 点赞数 | string | — | 帖子点赞数,取数当时的公开统计值 |
| comment_count | 评论数 | string | — | 帖子评论数,取数当时的公开统计值 |
| forward_count | 转发数 | string | — | 帖子转发数,取数当时的公开统计值 |
| retweet_num | 转推数 | string | — | 帖子转推次数,取数当时的公开统计值 |
| quote_count | 引用数 | string | — | 帖子被引用次数,取数当时的公开统计值 |
| view_count | 浏览数 | string | — | 帖子浏览次数,取数当时的公开统计值 |
| collect_count | 收藏数 | string | — | 帖子收藏数,取数当时的公开统计值 |
| is_forward | 是否转发 | boolean | — | 该帖子是否为转发内容 |
| parent_content_id | 父帖子编号 | string | — | 回复或转发链路的父帖子编号 |
| retweeted_content_id | 被转推编号 | string | — | 被转推的原帖子编号 |
| account_id | 作者编号 | string | — | 发布者账号在平台内的唯一编号 |
| account_name | 作者昵称 | string | — | 发布者账号展示昵称 |
| biz_id | 业务编号 | string | — | 帖子关联的业务标识编号 |
| account_home_url | 作者主页 | string | — | 发布者账号主页 URL |
| account_avatar_url | 作者头像 | string | — | 发布者头像图片地址 |
| account_fans_count | 作者粉丝数 | string | — | 发布者粉丝数,取数当时的公开统计值 |
| image_urls | 图片链接 | string | — | 帖子附带的图片地址 |
| video_urls | 视频链接 | string | — | 帖子附带的视频或封面地址 |
| submitted_post_id | 提交编号 | string | — | 本次任务提交时填写的帖子编号 |
记录 Schema
输出按记录逐条返回。记录主键为 content_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "帖子编号",
"description": "帖子在平台内的唯一编号"
},
"content_url": {
"type": "string",
"title": "帖子链接",
"description": "帖子页面 URL"
},
"content_text": {
"type": "string",
"title": "帖子正文",
"description": "帖子文字内容"
},
"content_type": {
"type": "string",
"title": "内容类型",
"description": "帖子内容类型,如 video、text 等"
},
"publish_time": {
"type": "string",
"title": "发布时间",
"description": "帖子公开发布时间"
},
"publish_location": {
"type": "string",
"title": "发布位置",
"description": "帖子标注的发布地点"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "本条详情采集完成的时间"
},
"like_count": {
"type": "string",
"title": "点赞数",
"description": "帖子点赞数,取数当时的公开统计值"
},
"comment_count": {
"type": "string",
"title": "评论数",
"description": "帖子评论数,取数当时的公开统计值"
},
"forward_count": {
"type": "string",
"title": "转发数",
"description": "帖子转发数,取数当时的公开统计值"
},
"retweet_num": {
"type": "string",
"title": "转推数",
"description": "帖子转推次数,取数当时的公开统计值"
},
"quote_count": {
"type": "string",
"title": "引用数",
"description": "帖子被引用次数,取数当时的公开统计值"
},
"view_count": {
"type": "string",
"title": "浏览数",
"description": "帖子浏览次数,取数当时的公开统计值"
},
"collect_count": {
"type": "string",
"title": "收藏数",
"description": "帖子收藏数,取数当时的公开统计值"
},
"is_forward": {
"type": "boolean",
"title": "是否转发",
"description": "该帖子是否为转发内容"
},
"parent_content_id": {
"type": "string",
"title": "父帖子编号",
"description": "回复或转发链路的父帖子编号"
},
"retweeted_content_id": {
"type": "string",
"title": "被转推编号",
"description": "被转推的原帖子编号"
},
"account_id": {
"type": "string",
"title": "作者编号",
"description": "发布者账号在平台内的唯一编号"
},
"account_name": {
"type": "string",
"title": "作者昵称",
"description": "发布者账号展示昵称"
},
"biz_id": {
"type": "string",
"title": "业务编号",
"description": "帖子关联的业务标识编号"
},
"account_home_url": {
"type": "string",
"title": "作者主页",
"description": "发布者账号主页 URL"
},
"account_avatar_url": {
"type": "string",
"title": "作者头像",
"description": "发布者头像图片地址"
},
"account_fans_count": {
"type": "string",
"title": "作者粉丝数",
"description": "发布者粉丝数,取数当时的公开统计值"
},
"image_urls": {
"type": "string",
"title": "图片链接",
"description": "帖子附带的图片地址"
},
"video_urls": {
"type": "string",
"title": "视频链接",
"description": "帖子附带的视频或封面地址"
},
"submitted_post_id": {
"type": "string",
"title": "提交编号",
"description": "本次任务提交时填写的帖子编号"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"SpiderKing999__twitter-post-detail": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderKing999/twitter-post-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。