競爭對手內容摘要
抓取各競爭對手在其使用平台上最新的公開貼文，根據該帳戶自身基準線的參與度進行排名，並總結該期間內其內容的變化。
這項功能可以告知你什麼，以及不能告知你什麼
- 僅限公開、未登入的資料。不包含觸及率、儲存、點擊或受眾資料——絕對不要估算它們。
- 不同平台回傳的列表內容有所不同：
- X 的
user-tweets回傳的是該帳戶最受歡迎的近期推文（約 100 則），而非按時間順序的資訊串流。 - LinkedIn 的
company-posts回傳的是公司頁面向未登入訪客顯示的貼文，約 10 則最新貼文。 - Facebook 的
profile-posts通常只回傳頁面向未登入訪客顯示的1-2 則最新貼文。請將 Facebook 視為抽樣檢查，而非完整資訊串流，並在摘要中說明這點。
- X 的
- 僅在同一帳戶和同一平台內比較參與度。不同平台的原始讚數不具可比性。
需要先收集的輸入項
- 競爭對手及其在各平台的個人檔案網址。不要猜測使用者名稱——如果使用者沒有提供某個平台，就跳過那個平台。
- 期間（預設：過去 7 天）以及每個平台要抓取的貼文數量（預設：10 則；Facebook 的
profile-posts最多接受limit=4）。 - 先前的摘要檔案（如有），用於報告週與週之間的變化。
點數估算——執行前先顯示
每個競爭對手，每個平台一次列表呼叫：
| 平台 | 端點 | 點數 |
|---|---|---|
| TikTok | /v1/tiktok/channel-posts | 2 |
/v1/instagram/channel-posts（每則貼文 0.3；10 則貼文） | 3 | |
| YouTube | /v1/youtube/channel-videos | 2 |
| X | /v1/twitter/user-tweets | 2 |
| Threads | /v1/threads/user-posts | 2 |
/v1/linkedin/company-posts | 1 | |
/v1/facebook/profile-posts | 2 |
所有七個平台：每個競爭對手約 14 點；若加上幾個可選的詳細資訊呼叫，則約 16 點。列印所請求競爭對手和平台的總點數，檢查 GET /v1/account/balance（免費），並要求確認。
如何呼叫 Captapi
- MCP：
tiktok_channel_posts、instagram_channel_posts、youtube_channel_videos、twitter_user_tweets、threads_user_posts、linkedin_company_posts、facebook_profile_posts。 - REST：
GET https://api.captapi.com<path>?url=<personal file URL>&limit=<N>並帶有標頭Authorization: Bearer $CAPTAPI_API_KEY。Facebook 請使用limit=4；較高的值會導致 422 驗證錯誤。
失敗的呼叫不計點數。對 retryable: true 的錯誤重試一次；將 retryable: false 的錯誤記錄為該平台的答案。
步驟
- 抓取列表：針對使用者提供的每個競爭對手 × 平台。
- 過濾到指定期間：根據每則貼文的
publishedAt——列表會回傳最新貼文，無論它們有多舊。請將「此期間內沒有貼文」與「呼叫失敗」分開報告。對於 X，保留期間內的推文，並備註來源是根據受歡迎程度排序的集合。 - 合併跨平台貼文：同一競爭對手在不同平台上，時間戳記相差幾分鐘且文字重疊的貼文，視為同一則。
- 為每則貼文評分：針對同一平台上的同一帳戶進行比較：
engagement = likes + comments (+ shares/reposts 當存在時)；lift = engagement / median engagement of that account's pulled posts。 提升度（lift）≥ 2 的貼文即為「表現超群的貼文」。 - 為每則貼文加上標籤：格式（短影片、長影片、圖片、輪播、文字、連結）以及從標題推斷出的 2-4 字主題。
- 與先前的摘要進行比較（如果有提供）：發布頻率變化、新主題、被捨棄或新增的格式。
摘要格式
- 活動表格：競爭對手 × 平台 → 此期間內的貼文數（以及與上一期間相比的變化）。
- 表現超群的貼文：每個競爭對手最多 5 則——平台、日期、格式、標題的第一行、參與度和提升度、連結以及來源端點。
- 主題
[需要人工審查]：3-5 個競爭對手正在採用的主題或格式，每個主題或格式至少要有兩則相關貼文作為佐證。 - 缺口與注意事項：未提供的平台或呼叫失敗的平台、上述的 Facebook 和 X 備註，以及近似計數。
- 本次執行的點數總計。
需要人工審查的部分
- 主題標籤和主題——它們是從標題推斷出來的。
- 任何對資料的「策略」解讀；摘要僅顯示發布了什麼內容以及其在帳戶內的表現，而非原因。