twitter-hand-skill

Twitter/X 管理专家知识

Twitter API v2 参考

身份验证

Twitter API v2 使用 OAuth 2.0 Bearer Token 进行应用级访问，使用 OAuth 1.0a 执行用户级操作。

Bearer Token（只读访问 + 创建推文）：

Authorization: Bearer $TWITTER_BEARER_TOKEN

环境变量：TWITTER_BEARER_TOKEN

核心端点

获取已验证身份的用户信息：

curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  "https://api.twitter.com/2/users/me"

响应：{"data": {"id": "123", "name": "User", "username": "user"}}

发布推文：

curl -s -X POST "https://api.twitter.com/2/tweets" \
  -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello world!"}'

响应：{"data": {"id": "tweet_id", "text": "Hello world!"}}

发布回复：

curl -s -X POST "https://api.twitter.com/2/tweets" \
  -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Great point!", "reply": {"in_reply_to_tweet_id": "PARENT_TWEET_ID"}}'

发布串文（连续回复自己）：

1. 发布第一条推文 → 获取 tweet_id
2. 发布第二条推文，并将 reply.in_reply_to_tweet_id 设为第一条推文的 tweet_id
3. 对串文中的每条推文重复此操作

删除推文：

curl -s -X DELETE "https://api.twitter.com/2/tweets/TWEET_ID" \
  -H "Authorization: Bearer $TWITTER_BEARER_TOKEN"

点赞推文：

curl -s -X POST "https://api.twitter.com/2/users/USER_ID/likes" \
  -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "TARGET_TWEET_ID"}'

获取提及：

curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  "https://api.twitter.com/2/users/USER_ID/mentions?max_results=10&tweet.fields=public_metrics,created_at,author_id"

搜索近期推文：

curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  "https://api.twitter.com/2/tweets/search/recent?query=QUERY&max_results=10&tweet.fields=public_metrics"

获取推文指标：

curl -s -H "Authorization: Bearer $TWITTER_BEARER_TOKEN" \
  "https://api.twitter.com/2/tweets?ids=ID1,ID2,ID3&tweet.fields=public_metrics"

响应包含：retweet_count、reply_count、like_count、quote_count、bookmark_count、impression_count

速率限制

端点	限制	时间窗口
POST /tweets	300 条推文	3 小时
DELETE /tweets	50 次删除	15 分钟
POST /likes	50 次点赞	15 分钟
GET /mentions	180 次请求	15 分钟
GET /search/recent	180 次请求	15 分钟

始终检查响应标头：

• x-rate-limit-limit：允许的请求总数
• x-rate-limit-remaining：剩余请求数
• x-rate-limit-reset：限制重置时的 Unix 时间戳

---

内容策略框架

内容支柱

定义 3-5 个所有内容都围绕其展开的核心主题（“支柱”）：

Example for a tech founder:
  Pillar 1: AI & Machine Learning (40% of content)
  Pillar 2: Startup Building (30% of content)
  Pillar 3: Engineering Culture (20% of content)
  Pillar 4: Personal Growth (10% of content)

内容组合（7 种类型）

类型	频率	目的	模板
犀利观点	每周 2-3 次	提升互动	"不受欢迎的观点：[反主流观点]"
串文	每周 1-2 次	建立权威	"我花了 X 小时研究 Y。这是我的发现："
技巧/操作指南	每周 2-3 次	提供价值	"如何用 [N] 个步骤[解决问题]："
提问	每周 1-2 次	提升互动	"[有趣的问题]？我先来："
精选分享	每周 1-2 次	内容策展	"这个[文章/工具/代码库]将为[受众]带来巨大改变："
故事	每周 1 次	建立联系	"3 年前，我[令人共鸣的经历]。事情是这样的："
数据/统计	每周 1 次	建立权威	"[令人惊讶的统计数据]。这就是它为何重要："

最佳发布时间（以 UTC 为准，请根据受众时区调整）

星期	最佳时间	原因
星期一	上午 8-10 点	工作周开始，大家会查看信息流
星期二	上午 10 点、下午 1 点	互动率最高的一天
星期三	上午 9 点、下午 12 点	工作周中段，注意力集中
星期四	上午 10 点、下午 2 点	互动率第二高的一天
星期五	上午 9-11 点	仅限上午，下午互动率下降
星期六	上午 10 点	轻松浏览
星期日	下午 4-6 点	为下个工作周做准备

---

推文写作最佳实践

开场钩子（第一句话至关重要）

有效的钩子：

• 反主流观点："大多数人认为 X。他们错了。"
• 数字："我分析了 500 个[对象]。这是我的发现："
• 问题："为什么 90% 的[对象]会失败？"
• 故事："2019 年，我差点[戏剧性事件]。"
• 操作指南："如何在不[常见痛点]的情况下[实现理想结果]："
• 清单："在[人生里程碑]之前，我希望自己知道的 5 件事："
• 坦白："我曾经相信[常见观点]。后来我明白了……"

写作规则

1. 每条推文只表达一个想法——不要试图面面俱到
2. 把价值放在前面——钩子必须直接提供或承诺价值
3. 使用换行——不要写成一大段，每行 1-2 句话
4. 限制为 280 个字符——每个词都必须有存在的价值
5. 使用主动语态——写“我们发布了 X”，不要写“X 被我们发布了”
6. 具体优于模糊——写“快 3 倍”，不要写“快很多”
7. 以行动号召结尾——“同意吗？转推”或“你还会补充什么？”

串文结构

Tweet 1 (HOOK): Compelling opening that makes people click "Show this thread"
  - Must stand alone as a great tweet
  - End with "A thread:" or "Here's what I found:"

Tweet 2-N (BODY): One key point per tweet
  - Number them: "1/" or use emoji bullets
  - Each tweet should add value independently
  - Include specific examples, data, or stories

Tweet N+1 (CLOSING): Summary + call to action
  - Restate the key takeaway
  - Ask for engagement: "Which resonated most?"
  - Self-reference: "If this was useful, follow @handle for more"

话题标签策略

• 每条推文使用 0-2 个话题标签（更多看起来像垃圾信息）
• 使用话题标签是为了便于发现，而非装饰
• 混合使用宽泛话题标签（#AI）和具体话题标签（#LangChain）
• 话题串中绝不使用话题标签（第 1 条推文或许例外）
• 使用前先研究你所在领域的热门话题标签

---

互动指南

回复提及

规则：

1. 在 engagement_hours 期间，2 小时内回复
2. 提供价值——不要只说“谢谢！”——要补充对方观点
3. 提出后续问题——推动对话继续
4. 真诚待人——配合对方的热情和语气
5. 绝不争吵——如果有人带有敌意，就忽略或屏蔽

回复模板：

• 赞同：“说得好！我还想补充一点：[相关见解]”
• 提问：“有意思的问题。简短回答是 [X]，不过 [细节]”
• 不同意：“我的看法不同——[尊重对方的反驳观点]。你的经历如何？”
• 致谢：“感谢你分享！[你喜欢对方推文的具体之处]”

不要互动的情况

• 巨魔或明显恶意的争论
• 政治骂战（除非这是你的内容支柱）
• 人身攻击（立即屏蔽）
• 垃圾信息或机器人账号
• 可能造成法律责任的推文

自动点赞策略

为以下内容点赞：

1. 经常与你的内容互动的人所发的推文（互惠）
2. 你所在领域的意见领袖所发的推文（提升曝光度）
3. 与你的内容支柱相关的优质内容（体现内容筛选）
4. 对你推文的回复（鼓励更多回复）

不要自动点赞：

• 有争议或政治性内容
• 你实际上没有读过的内容
• 垃圾信息或低质量话题串
• 对竞争对手的批评（显得小气）

---

内容日历模板

WEEK OF [DATE]

Monday:
  - 8 AM: [Tip/How-to] about [Pillar 1]
  - 12 PM: [Curated share] related to [Pillar 2]

Tuesday:
  - 10 AM: [Thread] deep dive on [Pillar 1]
  - 2 PM: [Hot take] about [trending topic]

Wednesday:
  - 9 AM: [Question] to audience about [Pillar 3]
  - 1 PM: [Data/Stat] about [Pillar 2]

Thursday:
  - 10 AM: [Story] about [personal experience in Pillar 3]
  - 3 PM: [Tip/How-to] about [Pillar 1]

Friday:
  - 9 AM: [Hot take] about [week's trending topic]
  - 11 AM: [Curated share] — best thing I read this week

---

效果指标

核心指标

指标	衡量内容	良好基准
展示次数	看到这条推文的人数	因关注者数量而异
互动率	（点赞数+转推数+回复数）/展示次数	>2% 为良好，>5% 为优秀
回复率	回复数/展示次数	>0.5% 为良好
转推率	转推数/展示次数	>1% 为良好
个人资料访问量	推文发布后查看你个人资料的人数	跟踪趋势
关注者增长	每个周期新增关注者净数	跟踪趋势

互动率公式

engagement_rate = (likes + retweets + replies + quotes) / impressions * 100

Example:
  50 likes + 10 RTs + 5 replies + 2 quotes = 67 engagements
  67 / 2000 impressions = 3.35% engagement rate

内容效果分析

跟踪效果最好的内容类型和主题：

| Content Type | Avg Impressions | Avg Engagement Rate | Best Performing |
|-------------|-----------------|--------------------|--------------------|
| Hot take | 2500 | 4.2% | "Unpopular opinion: ..." |
| Thread | 5000 | 3.1% | "I analyzed 500 ..." |
| Tip | 1800 | 5.5% | "How to ... in 3 steps" |

使用这些数据优化未来的内容组合。

---

品牌语气指南

语气维度

维度	范围	描述
正式 ↔ 随意	1-5	1=企业风格，5=像给朋友发消息
严肃 ↔ 幽默	1-5	1=只谈正事，5=喜剧账号
含蓄 ↔ 大胆	1-5	1=圆融得体，5=直言不讳
通俗 ↔ 技术性	1-5	1=任何人都能理解，5=深入的专家内容

一致性规则

• 所有推文都使用相同的语气（包括犀利观点和操作指南）
• 提炼 3-5 个自然重复使用的“标志性短语”
• 如果品牌语气是“随意”，就不要突然写一串正式的推文
• 大声读出推文——听起来像同一个人写的吗？

---

安全与合规

内容指南

绝不发布：

• 歧视性内容（种族、性别、宗教、性取向、残障）
• 针对真实人物或公司的诽谤性言论
• 私人或机密信息
• 威胁、骚扰或煽动暴力的内容
• 冒充其他账号
• 将误导性说法当作事实呈现
• 违反 Twitter 服务条款的内容

审批模式队列格式

[
  {
    "id": "q_001",
    "content": "Tweet text here",
    "type": "hot_take",
    "pillar": "AI",
    "scheduled_for": "2025-01-15T10:00:00Z",
    "created": "2025-01-14T20:00:00Z",
    "status": "pending",
    "notes": "Based on trending discussion about LLM pricing"
  }
]

供人工审核的预览文件：

# Tweet Queue Preview
Generated: YYYY-MM-DD

## Pending Tweets (N total)

### 1. [Hot Take] — Scheduled: Mon 10 AM
> Tweet text here

**Notes**: Based on trending discussion about LLM pricing
**Pillar**: AI | **Status**: Pending approval

---

### 2. [Thread] — Scheduled: Tue 10 AM
> Tweet 1/5: Hook text here
> Tweet 2/5: Point one
> ...

**Notes**: Deep dive on new benchmark results
**Pillar**: AI | **Status**: Pending approval

风险评估

发布前，评估每条推文：

• 这可能被误解吗？→ 改写以提高清晰度
• 这是在欺凌弱者吗？→ 不要发布
• 如果这条内容被归到用户名下并出现在新闻报道中，你会感到自在吗？→ 如果不会，就不要发布
• 这能核实为真吗？→ 如果不确定，就加上审慎措辞或不要发布