Caelario

io.github.chunkydonut21由 GitHub 帳號 chunkydonut21 發布v0.1.8更新於 Nov 8, 2026

MCP server for Instagram, TikTok, YouTube, X and Facebook data extraction and automation.

已驗證STDIO僅桌面效率與工作流網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

Caelario 是一個本機 MCP 伺服器，為助理提供具型別的的工具，用來擷取與自動化 Instagram、TikTok、YouTube、X 與 Facebook 的社群媒體資料。

可以做什麼
對五個平台執行即時與持久化擷取，取得個人檔案、貼文等社群媒體資料，並支援結果分頁與每次任務的額度估算。搜尋與探索內容和帳號，並管理批次任務與排程以進行週期性收集。透過 Caelario 工作區存取已儲存的結果與用量工作流程。在執行任務前探索可用能力。
適用情境
當你希望助理在不必自行處理各平台憑證的情況下，從 Instagram、TikTok、YouTube、X 或 Facebook 取得公開社群媒體資料，或設定週期性擷取任務時使用。
執行需求
透過 npm 套件 caelario-mcp 以 stdio 在本機執行，需要 Node.js 20 或更新版本。需要 Caelario 工作區 API 金鑰，透過環境變數 CAELARIO_API_KEY 提供；安裝程式會提示輸入並在使用者範圍註冊伺服器。另需 Caelario 帳號以及對託管 API 的網路存取。
安裝前請注意
伺服器使用可撤銷的 Caelario 工作區 API 金鑰（CAELARIO_API_KEY），應妥善保密。擷取、批次與排程任務會消耗 Caelario 額度，可能產生計費，請查看服務商的計費說明。任務會向 Caelario 的專有託管 API 送出請求，平台身分由 Caelario 管理而非由你管理。排程與批次任務會建立週期性工作，可能持續消耗額度。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Caelario，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Caelario MCP

MCP server for social media data from Instagram, TikTok, YouTube, X and Facebook. Run extractions, search and discovery, batches, schedules, saved results and usage workflows through Caelario.

Source: https://github.com/chunkydonut21/caelario-mcp

The official local server gives Codex and Claude Code typed tools for capability discovery, immediate and durable extraction, result pagination, and credit estimates.

Install for Codex

bash
npx -y caelario-mcp install codex

Install for Claude Code

bash
npx -y caelario-mcp install claude

The installer prompts for a Caelario workspace API key and registers the stdio server at user scope. It does not ask for Instagram, TikTok, YouTube, X, or Facebook credentials; provider identities are managed by Caelario.

After installation, restart the client and ask:

Use Caelario to get Nike's Instagram profile and 10 recent posts.

The package requires Node.js 20 or newer. See https://caelario.com/mcp-server for security, billing, and tool details.

The connector is released under the MIT License. Caelario's hosted API, provider implementations, acquisition infrastructure, and managed identities are separate proprietary services and are not included in this package.

The npm artifact also includes official MCP Registry metadata under io.github.chunkydonut21/caelario. npm publication must happen before the separate Registry publication step.

來源：README.md，提交 b3d6a14

工具

21

discover_platforms

List every Caelario platform, operation, limit, and price.

無需輸入參數。

get_operation_guide

Explain and validate one operation before spending credits.

輸入參數platform必填operation必填

get_account

Return workspace identity and extraction limits.

無需輸入參數。

get_credit_usage

Return available, reserved, promotional, purchased, and spent credits.

無需輸入參數。

estimate_credits

Estimate the maximum reservation for one or many targets before starting work.

輸入參數limitplatform必填operation必填target_countinclude_posts

extract_now

Run one bounded target synchronously and return a model-safe result page.

輸入參數limitcursortarget必填platform必填operation必填text_limittext_offsetresult_limitinclude_postsresult_offsetidempotency_key

create_extraction

Create one durable extraction job for work that may continue in the background.

輸入參數limitcursortarget必填platform必填operation必填include_postsidempotency_key

list_extractions

List recent durable extraction jobs without embedding their large results.

輸入參數limit

get_extraction

Get one job's progress, billing, and error metadata.

輸入參數job_id必填

get_extraction_result

Page through a completed job's structured result without flooding model context.

輸入參數limitjob_id必填offsettext_limittext_offset

wait_for_extraction

Wait briefly for a durable job to become terminal without returning its large result.

輸入參數job_id必填timeout_secondspoll_interval_seconds

cancel_extraction

Cancel a queued job or request cancellation of a running job.

輸入參數job_id必填

create_batch

Run one operation for up to 100 targets as an expandable durable batch.

輸入參數limittargets必填platform必填operation必填include_postsidempotency_key

list_batches

List recent batches and optionally their child jobs.

輸入參數limitinclude_jobs

get_batch

Get aggregate status and child jobs for one batch.

輸入參數batch_id必填

cancel_batch

Cancel queued batch children and request cancellation of running children.

輸入參數batch_id必填

list_schedules

List active and paused extraction schedules.

輸入參數limit

get_schedule

Get one schedule and its recent run history.

輸入參數schedule_id必填

create_schedule

Create a timezone-aware once, daily, weekly, or monthly extraction schedule.

輸入參數name必填limittargets必填platform必填timezone必填frequency必填operation必填starts_at必填include_posts

update_schedule

Replace a schedule definition while preserving its run history.

輸入參數name必填limittargets必填platform必填timezone必填frequency必填operation必填starts_at必填schedule_id必填include_posts

manage_schedule

Pause, resume, run now, or delete an extraction schedule.

輸入參數action必填schedule_id必填

版本歷史

1
  1. v0.1.5Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分