logo

Twitter 关键词帖子搜索

给搜索关键词，返回匹配的 Twitter 帖子编号与发布时间清单

数据获取X (Twitter)搜索结果

概览

想在 Twitter 上摸清某个品类或品牌有哪些相关帖子在传播？给一个或多个搜索关键词，任务在后台完成后，你会拿到匹配帖子的编号与发布时间清单，可以直接筛候选内容或交给详情类 App 继续补字段。

比起在搜索页手工翻页、逐条复制帖子链接，它把关键词下的匹配帖子一次拉成结构化列表，默认按发布时间从新到旧排列，适合当作舆情监测、话题研究和选品初筛的入口数据。

数据说明

清单取自 Twitter 公开搜索结果，按本次提交的关键词匹配返回，同一个帖子编号只出现一次。发布时间是平台展示的帖子发布时间；采集时间与更新时间分别为结果被抓取和清洗落库的时间点。排序与相关度由平台搜索算法决定，不保证与 App 内搜索页完全一致。仅覆盖公开可见帖子。单次任务可提交多个关键词，每个关键词的返回条数不超过该项设定的「最多采集条数」。

结果长什么样

每条记录是一条匹配帖子：

帖子编号匹配关键词关键词类型发布时间采集时间
2088209311877226924Shokzkeyword2026-01-16T13:43:322026-08-14T21:10:40

另有更新时间等字段；不含帖子正文与互动数。

应用场景

  • 做话题监测时，对固定「匹配关键词」定期跑任务，比对新增「帖子编号」看谁新发布了相关内容。
  • 做选品初筛时，把「帖子编号」清单交给详情类 App，补齐正文与互动数据后再排序。
  • 做竞品对比时，一次提交多个关键词，比较各词下返回帖子的规模与时间分布。
  • 搭建分析流水线时，用「发布时间」筛选近期内容，聚焦当前传播窗口。

适用边界

单次最多 20 个关键词；每个关键词的采集条数可单独设置，默认 50 条、上限 500 条。

  • 适合用于
  • 需要按关键词获取 Twitter 上相关帖子清单时
  • 选品或舆情监测时需要先捞一批候选帖子编号，再交给详情类 App 深挖时
  • 不要用于
  • 已有明确帖子编号、只需单条详情时——用帖子详情类 App
  • 需要按账号时间线拉帖子而非关键词搜索时——用账号帖子列表类 App

失败处理

作者声明的失败与重试处理方式，接入时建议一并写进系统提示词。

  1. 1任务失败或过期可原样重新提交
  2. 2关键词过于生僻或暂无匹配结果时可能返回空列表，可换更通用的词重试
  3. 3鉴权失败属不可重试错误，需先配置有效 API 密钥

输入参数

调用本 App 需要传入的参数，与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
keywords搜索关键词array<object>是—最多 20 项[{"kw":"Shokz"}]要在 Twitter 上搜索的关键词或品牌词列表，建议用品类词或品牌词，不要写整句自然语言，一次最多 20 个

输出数据

单条记录的字段结构，与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
content_id帖子编号string—匹配帖子在平台内的唯一编号
publish_time发布时间string—帖子公开发布时间
crawl_time采集时间string—本条结果被采集的时间
clean_update_time更新时间string—结果最近清洗落库的时间
keyword匹配关键词string—本条结果关联的搜索关键词
keyword_type关键词类型string—关键词匹配类型标识
biz_id业务标识string—该结果对应的业务对象标识
submitted_keyword提交关键词string—本次任务提交时填写的关键词
no_data无数据boolean—该关键词是否未采集到有效帖子

记录 Schema

输出按记录逐条返回。记录主键为 content_id，去重、增量、关联以它为准。

output.schema
{
  "type": "object",
  "properties": {
    "content_id": {
      "type": "string",
      "title": "帖子编号",
      "description": "匹配帖子在平台内的唯一编号"
    },
    "publish_time": {
      "type": "string",
      "title": "发布时间",
      "description": "帖子公开发布时间"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "本条结果被采集的时间"
    },
    "clean_update_time": {
      "type": "string",
      "title": "更新时间",
      "description": "结果最近清洗落库的时间"
    },
    "keyword": {
      "type": "string",
      "title": "匹配关键词",
      "description": "本条结果关联的搜索关键词"
    },
    "keyword_type": {
      "type": "string",
      "title": "关键词类型",
      "description": "关键词匹配类型标识"
    },
    "biz_id": {
      "type": "string",
      "title": "业务标识",
      "description": "该结果对应的业务对象标识"
    },
    "submitted_keyword": {
      "type": "string",
      "title": "提交关键词",
      "description": "本次任务提交时填写的关键词"
    },
    "no_data": {
      "type": "boolean",
      "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 配置
{
  "mcpServers": {
    "SpiderKing999__twitter-keyword-search": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=SpiderKing999/twitter-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
查看我的 API Keys →

让 AI 自己完成配置

不想手动改配置？复制安装提示词，粘贴到任意 AI 客户端对话框，由它按自身方式完成接入（提示词会让 AI 向你索要 API Key，避免凭证留在对话记录或共享配置里）。

如需在同一个 MCP 连接里指定多个 App，前往 MCP 连接页（已为你指定本 App）。

价格

提交一次关键词搜索

每提交一次任务计费一次，与返回条数无关。

¥0.05/ 次
返回一条帖子

按实际成功返回的数据条数计费，任务失败不计费。每 20 条为一个计费单位，不足 20 条按 20 条计。

¥0.006/ 20 条

多个计费事件按各自口径独立累计，具体以每一项说明为准；任务失败不计费。

查看余额

立即体验

填写参数直接运行，结果来自真实调用。

示例
参数按 input.schema 校验后提交
请先填写必填参数
¥0.006 / 20 条起