Twitter 关键词帖子搜索
给搜索关键词,返回匹配的 Twitter 帖子编号与发布时间清单
概览
想在 Twitter 上摸清某个品类或品牌有哪些相关帖子在传播?给一个或多个搜索关键词,任务在后台完成后,你会拿到匹配帖子的编号与发布时间清单,可以直接筛候选内容或交给详情类 App 继续补字段。
比起在搜索页手工翻页、逐条复制帖子链接,它把关键词下的匹配帖子一次拉成结构化列表,默认按发布时间从新到旧排列,适合当作舆情监测、话题研究和选品初筛的入口数据。
数据说明
清单取自 Twitter 公开搜索结果,按本次提交的关键词匹配返回,同一个帖子编号只出现一次。发布时间是平台展示的帖子发布时间;采集时间与更新时间分别为结果被抓取和清洗落库的时间点。排序与相关度由平台搜索算法决定,不保证与 App 内搜索页完全一致。仅覆盖公开可见帖子。单次任务可提交多个关键词,每个关键词的返回条数不超过该项设定的「最多采集条数」。
结果长什么样
每条记录是一条匹配帖子:
| 帖子编号 | 匹配关键词 | 关键词类型 | 发布时间 | 采集时间 |
|---|---|---|---|---|
| 2088209311877226924 | Shokz | keyword | 2026-01-16T13:43:32 | 2026-08-14T21:10:40 |
另有更新时间等字段;不含帖子正文与互动数。
应用场景
- 做话题监测时,对固定「匹配关键词」定期跑任务,比对新增「帖子编号」看谁新发布了相关内容。
- 做选品初筛时,把「帖子编号」清单交给详情类 App,补齐正文与互动数据后再排序。
- 做竞品对比时,一次提交多个关键词,比较各词下返回帖子的规模与时间分布。
- 搭建分析流水线时,用「发布时间」筛选近期内容,聚焦当前传播窗口。
适用边界
单次最多 20 个关键词;每个关键词的采集条数可单独设置,默认 50 条、上限 500 条。
- 适合用于
- 需要按关键词获取 Twitter 上相关帖子清单时
- 选品或舆情监测时需要先捞一批候选帖子编号,再交给详情类 App 深挖时
- 不要用于
- 已有明确帖子编号、只需单条详情时——用帖子详情类 App
- 需要按账号时间线拉帖子而非关键词搜索时——用账号帖子列表类 App
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务失败或过期可原样重新提交
- 2关键词过于生僻或暂无匹配结果时可能返回空列表,可换更通用的词重试
- 3鉴权失败属不可重试错误,需先配置有效 API 密钥
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 搜索关键词
keywords必填array<object>要在 Twitter 上搜索的关键词或品牌词列表,建议用品类词或品牌词,不要写整句自然语言,一次最多 20 个数量最多 20 项示例[{"kw":"Shokz"}]
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 帖子编号
content_idstring匹配帖子在平台内的唯一编号 - 发布时间
publish_timestring帖子公开发布时间 - 采集时间
crawl_timestring本条结果被采集的时间 - 更新时间
clean_update_timestring结果最近清洗落库的时间
调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderKing999/twitter-keyword-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 20 条为一个计费单位,不足 20 条按 20 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。