作者:@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 秒)
- 開啟 https://fapi.uk 或 https://utools.readme.io 用 Twitter / Google 一鍵登入
- 在儀表盤生成 API Key(建議命名為 “OpenClaw 小龍蝦”)
- 在 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”
核心呼叫規則(小龍蝦必須嚴格遵守)
- 每次行動前 先呼叫餘額查詢介面,檢查積分是否足夠
- 所有請求 必須 帶 Header:
Authorization: Bearer {{apiKey}}
- 大部分寫操作需要
auth_token 和 ct0 引數
- 積分不足時立即停止,回覆使用者並給出充值連結
- 返回結果後,用自然流暢的中文總結關鍵資訊,不要直接貼原始 JSON(使用者要求“原始資料”時再給)
- 支援 proxyUrl 引數(需要時可問使用者要代理)
主要功能模組(小龍蝦會自動選擇對應介面)
- createTweet / CreateNoteTweet(發推文、Note推文,支援 medias、richtext、reply)
- tweetReply(回覆推文)
- createRetweet / deleteRetweet
- createBookmark / deleteBookmark
- unlikeTweet / unlikeV2
- uploadMedia / uploadMediaFile(上傳圖片/GIF/影片)
- 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(賬號資料)
- 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 充值連結
- 建議提前充值積分,避免中斷
小蔥技能7w4.net有完整的技能分類。
- 注意如果呼叫 MCP介面 使用自己的代理AI 配置 則只扣除1積分,否則MCP介面每次將會消耗100積分
如何設定 apiKey(只需做一次)
- 登入 https://fapi.uk (支援 Twitter/Google 一鍵登入)
- 前往 https://fapi.uk/api-keys 生成 Key , 並贈送100積分用於測試
- 在 OpenClaw 裡執行:
openclaw config set skills.entries.fapi-uk.apiKey "你的key"