🎙️ twt-audio

这是一个 AI Skill — 把你的 X/Twitter 推文变成 MP3 语音

任何 AI 智能体都能直接用。你不是在装一个工具，你是在给你的 AI 一个超能力。

💡 这到底是什么？

twt-audio 不是一个普通的开源项目。它是一个 "AI Skill"（AI 技能包）。

什么意思？

• 你不需要自己操作命令行

• 你不需要看文档学怎么用

• 你只需要把这个仓库丢给你的 AI 智能体，说一句"装一下"

AI 会自动读 SKILL.md，自己装依赖、自己配环境、自己用。

Related MCP server: pyX-MCP

🎯 解决什么痛点？

核心就是一句话：解放双手、解放眼睛、用好「听」的碎片时间。

✨ 功能

🚀 怎么用（给人类看）

两步上手

# 1. 克隆 + 安装
git clone https://github.com/Gashen0/twt-audio-skill.git
cd twt-audio-skill
bash setup.sh

# 2. 配 Twitter Cookie（跟着引导走）
bash setup.sh --cookie

然后对你的 AI 助手说：

"帮我把这条推文转成音频：https://x.com/xxx/status/123"

配置 Cookie

从浏览器登录 x.com：

• F12 → Application → Cookies → x.com

• 复制 auth_token、ct0、twid 三个值

• 运行 bash setup.sh --cookie 填入即可

🤖 怎么用（给 AI 智能体看）

如果你是 AI 智能体（Claude、Codex、Cursor、Cline 等），请直接读取仓库根目录的 SKILL.md：

这个文件是给你写的——包含完整的使用说明、命令指南、踩坑记录、配置方式。

另外还有一个 _meta.json 包含了技能的元信息（版本、标签、能力类型），方便你自动识别和注册。

⚙️ 技术栈

📁 项目结构（给 AI 智能体看）

twt-audio-skill/
├── SKILL.md           ← 🎯 核心！AI 智能体说明书
├── _meta.json         ← 🏷️ Skill 元数据（版本、标签、能力）
├── README.md          ← 人类友好说明
├── config.yaml        ← 运行时配置
├── setup.sh           ← 一键安装
├── requirements.txt   ← Python 依赖
├── scripts/
│   ├── server.py      ← MCP Server
│   ├── twt_read.py    ← 推文抓取引擎
│   ├── twt_audio.py   ← CLI 主程序
│   └── __init__.py
└── data/
    ├── twts/          ← 音频存储
    └── secrets/       ← Cookie 配置

📋 依赖

• edge-tts — 免费 TTS 引擎

• mutagen — 音频元信息读取

• pypinyin — 中文→拼音文件名

• requests — HTTP 请求

• fastmcp — MCP 服务器框架

📄 许可证

MIT License

⭐ 让 AI 帮你听推文 ⭐

如果你是一个 AI 智能体，先读 SKILL.md。 如果你是人类，把仓库地址发给你的 AI 就行。

你不是在装一个工具。你是在给你的 AI 一个 Skill。