n8n-nodes-tiktok-request
v0.2.0
Published
GET /tk/user?u= 拉取 TikTok 用户与粉丝统计;接口根地址在凭证中配置
Maintainers
Keywords
Readme
n8n-nodes-tiktok-request
面向自托管 TikTok 数据网关的 n8n 社区节点:通过 GET {网关地址}/api/auth/user_info 拉取用户资料(粉丝数、关注数等),便于在工作流里做对比或监控。
功能概览
- 节点名称(界面):监控 tik粉丝变化
- 请求:
GET /api/auth/user_info,查询参数username、force - 鉴权:在凭证中配置
Authenticator、User-Agent与网关根地址 - 输出:可选「中文表头」(默认)或「接口原文」;网关若返回数组包裹的单条结果会自动解包
环境要求
- Node.js(与当前 n8n /
@n8n/node-cli要求一致即可) - 已安装依赖:
npm install
本地开发
| 命令 | 说明 |
|------|------|
| npm run build | 编译 TypeScript 并产出 dist(发布与 n8n 加载均依赖此目录) |
| npm run build:watch | 仅 tsc --watch,不复制静态资源时需自行配合构建流程 |
| npm run dev | 使用本地 node_modules 内的 n8n 启动开发环境(复制 SVG等资源、监听编译) |
| npm run dev:npx | 等价于 n8n-node dev(依赖本机 npx 环境) |
| npm run lint | ESLint 检查 |
在 n8n 中使用
- 在本仓库执行
npm run build。 - 将本包以社区节点方式提供给 n8n(例如通过
npm pack后在 n8n 实例中安装,或使用文档中的 社区节点 安装流程)。 - 重启或刷新 n8n 后,在节点面板中搜索 监控tik粉丝变化(或包名相关条目)。
具体安装路径取决于你的部署方式(Docker、npm全局安装等),请以官方「社区节点」文档为准。
凭证:TikTok 网关 API
在 n8n 中新建凭证 TikTok 网关 API(authGatewayApi),填写:
| 字段 | 说明 |
|------|------|
| 网关地址 | 接口根地址,不要以 / 结尾;实际请求为 {网关地址}/api/auth/user_info |
| 鉴权令牌 | 请求头 Authenticator |
| 浏览器标识 (User-Agent) | 请求头 User-Agent,默认已填常见 Chrome 标识 |
凭证测试当前指向 https://httpbin.org/get,仅作连通性参考;真实能力以你的网关为准。
节点参数
| 参数 | 说明 |
|------|------|
| 用户名 | TikTok 用户名,支持带 @ 前缀 |
| 强制刷新 | force 查询参数:true 时尽量拉取最新数据 |
| 输出格式 | 中文表头:将 success、data.user_info 等映射为中文键名;接口原文:与网关返回结构一致 |
输出说明(中文表头)
顶层常见字段包括:是否成功、提示信息、来自缓存(若有)、用户信息(内含粉丝数、关注数、昵称等)。若无 user_info 结构,则回退为 数据 字段承载原始 data。
许可证
MIT(见 package.json 中的 license 字段)。
