n8n
通过 TwexAPI 构建 n8n Twitter 工作流，实现推文搜索、用户查询、热门推文、AI Agent 与游标安全 handoff。
用 TwexAPI 构建 n8n Twitter 工作流。搜索推文、查询用户、读取热门推文并运行 AI Agent。本集成使用 TwexAPI 社区节点、HTTP Request、Webhook 与 MCP Client Tool 节点。
TwexAPI 使用单一 API 密钥与 REST 基址 https://api.twexapi.io。
选择 n8n Twitter 集成方式
TwexAPI 社区专属节点
安装 @twexapi-dev/n8n-nodes-x-api-scraper，支持推文搜索、用户搜索、资料查询、热门推文与余额检查。
HTTP Request + MCP
任意已文档化 REST 路由用 HTTP Request。AI Agent需先发现端点时用 MCP Client Tool。
前置条件
- TwexAPI API 密钥
- n8n Cloud 或自托管 n8n
- 以下配方可选 Slack 与 Google Sheets 凭证
安装社区节点
在 Settings → Community Nodes 安装 @twexapi-dev/n8n-nodes-x-api-scraper。
npm install @twexapi-dev/n8n-nodes-x-api-scraper源码：twexapi-dev/n8n-nodes-x-api-scraper
支持的操作
| 任务 | n8n 操作 | TwexAPI 路由 |
|---|---|---|
| 搜索推文 | Tweet: search | POST /twitter/advanced_search/page |
| 搜索用户 | User: search | GET /twitter/search-user/{keyword}/{target_count} |
| 查询资料 | User: get | GET /twitter/{screen_name}/about |
| 读取热门推文 | Trend: get | GET /twitter/global-trending/tweets |
| 查看余额 | Account: get balance | GET /balance |
粉丝分页、列表、社区与经批准发帖请用 REST API。TwexAPI 不提供原生账号监控或事件 webhook — recurring 作业请用定时 REST 或无代码平台 webhook。
API 密钥凭证
为 TwexAPI 创建可复用 n8n 凭证：
身份认证与鉴权
TwexAPI API 凭证或 HTTP Request 凭证选择 Header Auth。
请求头名称
Header 名称设为 Authorization。
请求头数值
凭证值粘贴 Bearer YOUR_API_KEY。
每个调用 https://api.twexapi.io 的 HTTP Request 节点使用该凭证。
具备 MCP 的 AI Agent 节点：MCP Client Tool 配置 https://api.twexapi.io/mcp，header x-api-key: YOUR_API_KEY。
结果 handoff
下一节点仅需稳定 handoff 字段时，在每个 HTTP Request 或 TwexAPI 节点后使用 Edit Fields。原始响应勿进入 Slack 消息、Sheets 行与重试队列。
推文搜索分页
存储请求查询；将每条推文 id、text、作者用户名、created_at 映射为 tweet_id、text、author_username、created_at；保留 has_next_page 与 next_cursor 供页循环。
用户画像记录
源 id 存为 user_id，外加 username、name、粉丝数与查询或搜索输入。
趋势话题榜单
存储各趋势名、主题、内容标签与国家。请求区域与工作流运行一并保留。
发推或回复写入
写操作需已保存 cookie 或 auth_token。从 n8n 发帖前用 CLI --dry-run 预览。
配方 1：MCP AI Agent X 研究
用此配方将 AI Agent 与 TwexAPI 集成。AI Agent可搜索实时推文、汇总趋势、查看资料并比较粉丝活动。
添加 AI Agent 节点
用首选聊天模型创建 AI Agent 工作流。
添加 MCP 客户端工具
Server Transport 设为 HTTP Streamable。MCP Endpoint URL 设为 https://api.twexapi.io/mcp。Authentication 设为 Header Auth，名称 x-api-key，值为 TwexAPI API 密钥。
配置 Agent 业务指令
指导 Agent 先调用 explore，再 twexapi_request，且仅返回 JSON。
建议Agent 系统 prompt：
Use TwexAPI for every X research request. Call explore before twexapi_request. Search tweets, inspect accounts, and cite the returned post URLs. Prefer small, targeted searches before broad exports.示例用户 prompt：
Find recent posts about AI agents in fintech, group them by theme, and list 5 accounts worth monitoring.
Return only JSON with route_used, tweets, has_more, and next_cursor.MCP 服务器暴露 explore 用于端点发现、twexapi_request 用于认证调用。
配方 2：推文搜索到 Slack
用 TwexAPI 社区节点或 HTTP Request 搜索推文，再告警 Slack 频道。
工作流形状
定时调度或手动触发器
定时运行或测试时手动触发。
搜索推文
用 TwexAPI 节点或 HTTP Request 调用 POST /twitter/advanced_search/page。
拆分数据行
对返回推文 Split Out。
发送通知告警
向 Slack 发送格式化文本。
HTTP Request 示例
{
"method": "POST",
"url": "https://api.twexapi.io/twitter/advanced_search/page",
"headers": {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
"body": {
"searchTerms": ["AI agents lang:en"],
"sortBy": "Latest",
"nextCursor": ""
}
}Slack 消息
Slack 前使用 Set 节点：
@{{$json.author_username || $json.user?.screen_name}}
{{$json.text || $json.full_text}}
https://x.com/i/web/status/{{$json.tweet_id || $json.id}}配方 3：搜索结果到 Google Sheets
团队需在电子表格中查看推文搜索结果时使用。
工作流形状
定时调度触发器
每日或每小时导出；测试时手动执行。
搜索推文
用 TwexAPI 节点或 HTTP Request 搜索并存储 next_cursor。
拆分数据行
对返回推文 Split Out。
追加数据行
Google Sheets Append Row 映射下方结果字段。
映射到 Google Sheets 的字段：
推文 ID
映射到 id 或 tweet_id。
作者信息
映射到作者用户名或 screen name。
文本内容
映射到 text 或 full_text。
创建时间
映射到 created_at 或 createdAt。
URL
由 https://x.com/i/web/status/{id} 构建。
较大作业在 has_next_page 或 has_more 为 true 时循环，将 next_cursor 传回搜索 body。
常用 REST 操作
搜索推文
用 POST /twitter/advanced_search/page 运行 X 查询搜索。
获取用户资料
用 GET /twitter/{screen_name}/about 获取 X 资料。
获取粉丝列表
用 POST /v3/twitter/users/followers 读取粉丝列表。
获取热门趋势
用 GET /twitter/global-trending/tweets 读取全球热门推文。
发布推文
用 POST /twitter/tweets/create 发布文本或媒体帖。
发送私信
用 POST /v3/twitter/send-dm 发送 DM。
测试清单
- 在每个 HTTP Request 或 TwexAPI 节点上使用 n8n Test Step。
- 确认每个 REST 请求含
Authorization: Bearer YOUR_API_KEY。 - 确认每个 MCP Client Tool 请求含
x-api-key。 - 分页作业每页后存储
next_cursor。 429时等待后重试并保留游标。
n8n Twitter 自动化常见问题
如何通过 TwexAPI 将 n8n 连接到 Twitter？
安装 TwexAPI 社区节点，或创建 Header Auth Authorization: Bearer YOUR_API_KEY，在每个 TwexAPI 请求上选择该凭证。
n8n Twitter 搜索如何工作？
通过社区节点或 HTTP Request 调用 POST /twitter/advanced_search/page。每页保存查询与游标。
n8n 能否发帖到 Twitter？
可以，通过 POST /twitter/tweets/create。写操作需 cookie 或 auth_token。先用 CLI 预览载荷。
能否构建 n8n Twitter AI Agent？
可以。n8n Twitter AI Agent可通过 https://api.twexapi.io/mcp 的 MCP 搜索推文、资料与趋势。
自托管 n8n 能否使用 TwexAPI？
可以。允许出站 HTTPS 到 https://api.twexapi.io。
下一步
- 阅读 Agent MCP Handoff 了解严格 JSON handoff 模式。
- 阅读 CLI 预览写操作 dry-run。
- 构建 AI Agent 工作流时使用 MCP Tools。