Twitter Bookmarks Skill for AI Agents

讓你的 AI Agent 讀取 Twitter 書籤 - 無需 API 付費，只授權書籤權限

---

🎯 這個 Skill 的優勢

✅ 免費 - 不需要購買 Twitter API ✅ 安全 - 只授權書籤讀取權限，不會有其他權限 ✅ 簡單 - 3 步驟完成設置 ✅ 跨設備 - 在任何電腦上登入 Safari 即可提取 Cookies

---

📋 安裝步驟

步驟 1：在 Safari 登入 Twitter

1. 打開 Safari 瀏覽器（必須是 Safari）
2. 前往 https://x.com
3. 登入你的 Twitter 帳號
4. 確認可以看到你的書籤

💡 為什麼用 Safari？ Safari 的 Cookies 只包含基本認證信息（auth_token 和 ct0），不會包含其他敏感權限。這比授權完整 API 安全得多。

---

步驟 2：提取 Safari Cookies

在終端機執行以下腳本：

curl -o ~/Downloads/extract-twitter-cookies.sh https://raw.githubusercontent.com/YOUR_REPO/twitter-bookmarks-skill/main/extract-twitter-cookies.sh

chmod +x ~/Downloads/extract-twitter-cookies.sh

~/Downloads/extract-twitter-cookies.sh

腳本會自動：

1. 從 Safari 提取 Twitter Cookies
2. 只提取 auth_token 和 ct0（書籤讀取所需的最小權限）
3. 生成 twitter-cookies.zip 文件
4. 顯示 Cookies 有效期（通常 7-14 天）

---

步驟 3：讓 Agent 安裝 Cookies

將 twitter-cookies.zip 發送給你的 Agent，然後告訴 Agent：

請安裝這個 twitter-cookies.zip，讓你能讀取我的 Twitter 書籤

Agent 會自動：

1. 解壓縮並讀取 Cookies
2. 配置書籤讀取工具
3. 驗證 Cookies 有效性

---

🤖 Agent 可以做什麼

安裝完成後，你可以要求 Agent：

📖 讀取書籤

顯示我最近的 10 個 Twitter 書籤

🔍 分析書籤

分析我的書籤，哪些適合寫成推文？

📊 分類書籤

把我的書籤分成：學習資料 vs 推文素材

🎯 找特定主題

找出我書籤中關於 AI 的內容

---

🔒 安全說明

✅ 這個方法很安全，因為：

1. 最小權限原則

   • 只提取 auth_token 和 ct0 兩個 Cookie
   • 這兩個 Cookie 只能讀取書籤，不能發推文、改設定、刪除內容

2. 只讀訪問

   • Agent 只能查看你的書籤
   • 不能修改、刪除、發布任何內容

3. 有效期限制

   • Cookies 通常 7-14 天過期
   • 過期後 Agent 會提醒你重新提取

4. 跨設備安全

   • 在其他電腦登入 Safari 提取 Cookies
   • 不需要在 Agent 所在設備登入你的 Twitter

⚠️ 注意事項

• 不要把 Cookies 分享給其他人
• 定期檢查 Cookies 有效期
• 如果懷疑 Cookies 洩漏，請到 Twitter 登出所有設備

---

🔧 技術說明

Cookie 提取原理

Safari 將 Cookies 儲存在：

~/Library/Cookies/Cookies.binarycookies

我們的腳本：

1. 讀取這個二進制文件
2. 只提取 x.com 域名的 auth_token 和 ct0
3. 打包成 zip 文件供 Agent 使用

Agent 使用方式

Agent 使用 Bird CLI 來讀取書籤：

• Bird CLI 是一個輕量級 Twitter 客戶端
• 使用 Cookie 認證（不需要 API Key）
• 只支援讀取操作（無寫入權限）

---

🆘 常見問題

Q: Cookies 多久會過期？

A: 通常 7-14 天。過期後 Agent 會提醒你重新提取。

Q: 這樣會不會給 Agent 太多權限？

A: 不會！這個方法只給讀取書籤的權限，不能發推文、改資料、刪除內容。

Q: 我可以隨時撤銷權限嗎？

A: 可以！到 Twitter → 設定 → 登出所有設備，所有 Cookies 立即失效。

Q: 為什麼不用 Twitter API？

A: Twitter API 付費且設置複雜。這個方法免費、簡單、安全。

Q: 其他瀏覽器可以嗎？

A: 建議使用 Safari，因為它的 Cookies 權限更受限，更安全。

---

📝 授權聲明

本 Skill 採用 MIT 授權條款。 你可以自由使用、修改、分發此工具。

---

🙏 致謝

感謝 Bird CLI 提供輕量級 Twitter 客戶端。

---

版本: 1.0.0 更新日期: 2026-03-05 支援平台: macOS (Safari)