fapi.uk Twitter 全能 API Skill（純 REST 版）

作者：@good6_api
版本：1.3.0
類別：Social / Twitter / X / Grok / Communities
官網：https://fapi.uk | https://utools.readme.io
文件：https://utools.readme.io/reference

這是什麼

這個 Skill 讓小龍蝦（OpenClaw）通過自然語言完整使用 fapi.uk 的 Twitter API（60+ 個真實介面）。
完全不需要 MCP，小龍蝦會自己閱讀本檔案，智慧選擇介面、組裝引數、帶上 apiKey + auth_token，傳送請求，並用流暢中文總結結果。

Base URL：https://fapi.uk/api/base/apitools/

必須先完成一次設定（30 秒）

1. 開啟 https://fapi.uk 或 https://utools.readme.io 用 Twitter / Google 一鍵登入
2. 在儀表盤生成 API Key（建議命名為 “OpenClaw 小龍蝦”）
3. 在 OpenClaw 中設定（強烈推薦）： openclaw config set skills.entries.fapi-twitter.apiKey "你的完整apiKey" openclaw config set skills.entries.fapi-twitter.auth_token "你的auth_token（從登入API或 https://x.com/good6_api/status/1812496182213845482 獲取）" openclaw config set skills.entries.fapi-twitter.ct0 "你的ct0（可選）" 或者直接在聊天裡說： “我的 fapi apiKey 是 xxx，我的 auth_token 是 yyy”

核心呼叫規則（小龍蝦必須嚴格遵守）

1. 每次行動前 先呼叫餘額查詢介面，檢查積分是否足夠
2. 所有請求 必須 帶 Header：Authorization: Bearer {{apiKey}}
3. 大部分寫操作需要 auth_token 和 ct0 引數
4. 積分不足時立即停止，回覆使用者並給出充值連結
5. 返回結果後，用自然流暢的中文總結關鍵資訊，不要直接貼原始 JSON（使用者要求“原始資料”時再給）
6. 支援 proxyUrl 引數（需要時可問使用者要代理）

   訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

主要功能模組（小龍蝦會自動選擇對應介面）

1. 發推 / 互動（Send Tweets）

• createTweet / CreateNoteTweet（發推文、Note推文，支援 medias、richtext、reply）
• tweetReply（回覆推文）
• createRetweet / deleteRetweet
• createBookmark / deleteBookmark
• unlikeTweet / unlikeV2
• uploadMedia / uploadMediaFile（上傳圖片/GIF/影片）

2. 獲取推文（Get Tweets）

• tweetSimple / tweetTimeline（單條推文詳情 + 回覆）
• userTimeline / userTweetsV2 / UserArticlesTweets（使用者推文）
• favoritesList / userLikeV2（喜歡列表）
• favoritersV2（推文點贊者）

3. 搜尋 & 探索（Search）

• search（關鍵詞搜尋，支援高階運算子）
• trending / trends（熱搜，需 woeid）
• explore / entertainment / sports（探索頁、娛樂、體育）
• userTweetReply（使用者回覆）

4. 使用者 & 關注（Users & Follows）

• uerByIdOrNameLookUp / userByScreenNameV2 / uerByIdRestIdV2 / usersByIdRestIds（查使用者）
• blueVerifiedFollowersV2（藍V粉絲）
• follow / unfollow
• blocksCreate / blocksDestroy（拉黑）
• accountAnalytics（賬號資料）

5. Grok 專區（Grok Tools）

• createGrok（新建對話）
• addResponse / addResponsePost（向 Grok 傳送訊息，支援 reasoning、deepsearch、圖片生成等）

6. 社群（Communities）

• CommunitiesFetchOneQuery / CommunityQueryV2
• CommunitiesMemberV2 / CommunitiesSearchV2
• CommunitiesTimelineV2 / CommunitiesTweetsTimelineV2
• TopicListV2

7. 其他實用

• get Notifications / mentionsTimeline
• DM 相關（uploadMediaDM）
• unlock（賬號解鎖，額外付費）
• tokenSync（速率限制恢復）
• usernameChanges / history 等

餘額查詢（每次必先呼叫）： - 大部分介面返回 ResultT 結構，code=200 為成功

積分與付費提醒

• 每次呼叫都會從你的 fapi.uk 賬戶扣除積分（不同介面扣分不同）
• 小龍蝦絕不會自動購買積分（OpenClaw 安全策略禁止）
• 積分不足時小龍蝦會主動說：“積分不夠啦～本次需要 X，當前剩餘 Y，要我幫你開啟 https://fapi.uk/pay 或 https://utools.readme.io/pay 充值頁面嗎？”

示例對話風格（小龍蝦會模仿）

使用者：幫我發一條推文：Grok 太強了！附上這張圖
小龍蝦：好的～先查餘額（當前 1247 積分，足夠）。正在上傳媒體併發推文... 釋出成功！推文連結：https://x.com/xxx/status/1890123456789

使用者：搜尋最近關於 OpenClaw 的推文，前 10 條
小龍蝦：已搜尋“OpenClaw”，找到最新 10 條，最熱的總結如下：1. ... 要翻頁嗎？

使用者：讓我和 Grok 聊聊“未來 AI 發展趨勢”
小龍蝦：已建立 Grok 會話，正在傳送訊息... Grok 回覆：“......”

安裝方式（一鍵安裝）

```bash npx clawhub@latest install fapi-twitter-full

積分與付費說明

• 每次呼叫 Twitter 介面會從你的 fapi.uk 賬戶扣除積分
• 積分不足此服務會返回 "You have made too many requests. Please contact the administrator to upgrade the frequency limit. "
• 小龍蝦不會自動購買積分（OpenClaw 安全策略禁止自動支付）
• 積分不足時我會主動告訴你，並給出 https://fapi.uk/pay 充值連結
• 建議提前充值積分，避免中斷
• 注意如果呼叫 MCP介面 使用自己的代理AI 配置 則只扣除1積分，否則MCP介面每次將會消耗100積分

如何設定 apiKey（只需做一次）

1. 登入 https://fapi.uk （支援 Twitter/Google 一鍵登入）
2. 前往 https://fapi.uk/api-keys 生成 Key , 並贈送100積分用於測試
3. 在 OpenClaw 裡執行： openclaw config set skills.entries.fapi-uk.apiKey "你的key"

這個 Skill 功能挺全面，能發推文、搜尋、和 Grok 聊天都支援。文件寫得清楚明白，新手也能快速上手。不過美中不足的是兩個說明檔案內容完全一樣，有點浪費空間，而且缺少更詳細的介面說明，遇到複雜需求時可能會摸不著頭腦。總體來說質量中等偏上，日常使用夠用。