twitter-dance

Twitter Dance - 技能 定义

自动发推文 技能（基于 APIdance.pro API）

基本信息 名称：twitter-dance 版本：1.0.0 类型：社媒运营自动化 推荐用途：日常推文发布、内容分发 最佳实践：与 Kimi AI 结合使用 简介

Twitter Dance 是一个完全自动化的推特发布和管理系统，基于 APIdance.pro 官方 API。

核心特性：

🤖 AI 推文生成（Kimi） ⚡ 完全自动化发推 💰 超低成本（$0.05/月） 📊 完整日志和统计 🔒 安全可靠（无浏览器自动化） 📱 账户统计和分析 🔔 通知管理 💬 自动回复 📈 互动数据分析 ⏰ 互动周期优化 安装 # 1. 获取 API Key # APIdance.pro: https://t.me/shingle # TWITTER_AUTH_令牌: X.com 设置tings → Developers # KIMI_API_KEY: https://平台.moonshot.cn

# 2. 配置环境变量 导出 APIDANCE_API_KEY="..." 导出 TWITTER_AUTH_令牌="..." 导出 KIMI_API_KEY="..."

# 3. 进入 技能 目录 cd /Users/chao/.OpenClaw/workspace/技能s/twitter-dance

快速开始 生成推文（无需发布） node scripts/auto-tweet.js --draft-only

自动发推 node scripts/auto-tweet.js

批量发推 node scripts/auto-tweet.js --count=5

测试 GraphQL API node scripts/test-tweet-graphql.js "你的推文内容"

高级功能

使用 TwitterDanceEnhanced 类获得更多强大功能：

账户统计 node scripts/test-advanced-features.js stats

获取粉丝数、推文数、点赞数等详细统计

通知管理 node scripts/test-advanced-features.js 通知

获取最新的互动通知（提及、点赞、转发）

自动回复 node scripts/test-advanced-features.js reply

自动回复特定推文

推文分析 node scripts/test-advanced-features.js timeline-分析

分析时间线，找出最受欢迎的推文

互动周期分析 node scripts/test-advanced-features.js engagement-hours

找出最佳发推时间

完整功能菜单 node scripts/test-advanced-features.js

详见： ADVANCED_FEATURES.md

API 参考 TwitterDanceAPI命令行工具ent 初始化 const TwitterDanceAPI命令行工具ent = require('./src/twitter-API-命令行工具ent');

const 命令行工具ent = new TwitterDanceAPI命令行工具ent({ APIKey: process.env.APIDANCE_API_KEY, auth令牌: process.env.TWITTER_AUTH_令牌, verbose: true });

方法 tweet(text, options)

发布推文

参数：

text (string): 推文内容（≤280 字） options (object): media (array): 媒体 URL 列表（可选）

返回：

{ 成功: true, tweetId: "1234567890", timestamp: "2026-03-11T13:27:00Z", text: "推文内容", length: 150 }

示例：

const 结果 = awAIt 命令行工具ent.tweet("Hello Twitter! 🚀"); console.记录(结果.tweetId);

likeTweet(tweetId)

点赞推文

参数：

tweetId (string): 推文 ID

示例：

awAIt 命令行工具ent.likeTweet("1234567890");

retweet(tweetId)

转发推文

示例：

awAIt 命令行工具ent.retweet("1234567890");

获取Tweet(tweetId)

查询推文详情

返回：

{ 成功: true, tweet: { / 推文数据 / } }

获取User(username)

查询用户信息

示例：

const user = awAIt 命令行工具ent.获取User("elonmusk"); console.记录(user.followers_count);

搜索Tweets(查询, options)

搜索推文

参数：

查询 (string): 搜索关键词 options (object): count (number): 返回数量，默认 10 lang (string): 语言代码，默认 'en'

示例：

const 结果s = awAIt 命令行工具ent.搜索Tweets("OpenClaw", { count: 20 });

获取Timeline(options)

获取 Timeline

参数：

options (object): count (number): 推文数量，默认 20 excludeReplies (boolean): 排除回复 includeRetweets (boolean): 包含转发，默认 true 检查Quota()

检查 API 配额

返回：

{ 成功: true, remAIning: 9500, total: 10000, used: 500 }

Tweet生成器 初始化 const Tweet生成器 = require('./src/tweet-生成器');

const 生成器 = new Tweet生成器({ kimiAPIKey: process.env.KIMI_API_KEY, verbose: true });

方法 生成(options)

生成单条推文

参数：

options (object): topic (object): 自定义话题（可选）

返回：

{ text: "推文内容...", source: "kimi" | "template", topic: "Crypto & 网页3", length: 180, keywords: ["Bitcoin", "Ethereum"] }

示例：

const tweet = awAIt 生成器.生成(); console.记录(tweet.text);

生成Batch(count, options)

批量生成推文

示例：

const tweets = awAIt 生成器.生成Batch(5); tweets.forEach((t, i) => { console.记录(${i + 1}. ${t.text}); });

工作流示例 场景 1：日常自动发推 # 设置 Cron 任务 0 9 * cd /path/to/twitter-dance && node scripts/auto-tweet.js >> 记录s/cron.记录 2>&1

场景 2：批量发推（一次 5 条） node scripts/auto-tweet.js --count=5

场景 3：仅生成草稿供审核 node scripts/auto-tweet.js --draft-only > tweets-to-review.txt

配置 环境变量 # 必需 APIDANCE_API_KEY=your-API-key TWITTER_AUTH_令牌=your-令牌

# 可选（推荐） KIMI_API_KEY=sk-xxx

# 日志 VERBOSE=true # 详细日志

推文主题（自定义）

编辑 src/tweet-生成器.js 中的 topics 数组：

this.topics = [ { name: 'Your Topic', keywords: ['keyword1', 'keyword2'], tone: 'Your tone' }, // ... ];

成本分析 每月费用（基于 30 条推文） 项目 用量 单价 总价 APIdance.pro API 30 条 $0.008/条 $0.24 Kimi API（可选） 30 条 ~$0.001/条 $0.03 总计 30 条 - ~$0.27 与竞品对比 ZAPIer 推特集成：$15-25/月 Make 推特场景：$10-20/月 Buffer Pro：$15+/月 Twitter Dance：$0.27/月（节省 99%） 故障排除 错误：缺少 APIDANCE_API_KEY

解决： 在 https://t.me/shingle 购买 API Key

错误：缺少 TWITTER_AUTH_令牌

解决： 从 X.com 设置tings → Developers 获取 令牌

错误：推文过长

解决： Kimi 会自动截断；本地模板已验证都 <280 字

错误：API 配额已用尽

解决： 查看配额 → 购买更多或等待重置

最佳实践

✅ 推荐

结合 Kimi API 提高推文质量 使用 --draft-only 先预览 定期检查日志分析效果 每天 1-3 条推文（高效且经济）

❌ 不推荐

一次发超过 10 条推文 禁用 Kimi 使用纯模板 完全无人审核的完全自动化 TwitterDanceEnhanced（高级 API） 初始化 const TwitterDanceEnhanced = require('./src/twitter-API-enhanced');

const 命令行工具ent = new TwitterDanceEnhanced({ APIKey: process.env.APIDANCE_API_KEY, auth令牌: process.env.TWITTER_AUTH_令牌, verbose: true });

核心方法 方法 功能 返回 获取AccountStats() 获取账户统计 粉丝、推文、点赞等数据 获取通知(options) 获取通知 最新互动列表 autoReply(tweetId, text, options) 自动回复 回复成功信息 获取Tweet指标(tweetId) 获取推文指标 点赞、转发、浏览数 获取Timeline分析(options) 时间线分析 推文统计和最佳推文 获取EngagementByHour()