Qpost Mcp

io.github.arslan2012由 GitHub 帳號 arslan2012 發布v0.4.0更新於 Nov 5, 2026

MCP server for QPost — lets AI agents publish video and image posts to YouTube, TikTok, Instagram.

已驗證Streamable HTTP可網頁執行商業與電商媒體與設計

概覽

AI 產生的概覽

QPost 的 MCP 伺服器，讓 AI 助理在 YouTube、TikTok 和 Instagram 上建立、排程、修改、刪除影片或圖片貼文並查看數據。

可以做什麼
  • 列出已連接的 YouTube、TikTok、Instagram 帳號及其狀態
  • 建立並發布或排程發布影片、圖片貼文到這些平台
  • 列出貼文，或依 ID 取得單一貼文及各平台發布狀態
  • 讀取已發布貼文的即時互動數據（觀看、按讚、留言、分享）和公開連結
  • 修改貼文的說明文字、排程、時區或狀態，以及刪除貼文
  • 對先前發布失敗的貼文重新發布
適用情境
適合讓助理透過 QPost 草擬、排程並發布短影音或圖片內容到社群帳號，或查看已發布貼文的表現，而不必開啟 QPost 後台。
執行需求
需要 QPost 帳號並已連接目標社群帳號，以及在 QPost 後台產生的 API 金鑰。可使用 qpost.dev 的託管端點並帶上 x-api-key 標頭，或以 npx 執行本機 npm 套件（需 Node 20+ 並設定 QPOST_API_KEY 環境變數）。QPOST_BASE_URL 可指向自架執行個體。
安裝前請注意
API 金鑰（QPOST_API_KEY 或 x-api-key 標頭）可操作該帳號的發布功能，請勿放入共用設定。這些工具會在真實社群帳號上發布、排程、修改並永久刪除貼文，未設定排程即立即發布。託管端點要求媒體為公開連結或 base64，因此即使在本機執行橋接，內容仍會傳送到 QPost 的託管服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Qpost Mcp，將其新增到工作區。
  2. 連接 x-api-key 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.arslan2012%2Fqpost-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "qpost": {
      "type": "http",
      "url": "https://qpost.dev/mcp",
      "headers": {
        "x-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

qpost-mcp

MCP server for QPost — lets AI agents schedule and publish video/image posts to YouTube, TikTok, and Instagram through QPost's REST API.

Install

Connect your destination accounts and generate an API key at QPost API Keys, then pick one of the two options below.

Hosted (recommended — nothing to install)

QPost runs the same server at https://qpost.dev/mcp over Streamable HTTP:

bash
claude mcp add --transport http qpost https://qpost.dev/mcp \  --header "x-api-key: YOUR_API_KEY"

Any MCP client that speaks Streamable HTTP can point at that URL with an x-api-key (or Authorization: Bearer) header. The endpoint is stateless, so there is no session to manage.

Local (stdio) via npx

Use this to run the MCP bridge on your machine while QPost handles publishing:

bash
claude mcp add qpost -e QPOST_API_KEY=your_key_here -- npx -y qpost-mcp

Claude Desktop / other MCP clients

json
{  "mcpServers": {    "qpost": {      "command": "npx",      "args": ["-y", "qpost-mcp"],      "env": {        "QPOST_API_KEY": "your_key_here"      }    }  }}

QPOST_BASE_URL defaults to https://qpost.dev. Running this MCP bridge locally still uses QPost’s hosted publishing service.

Tools

ToolDescription
list_connected_accountsList connected YouTube/TikTok/Instagram accounts and their status
create_postCreate and publish (or schedule) a post, with video or image media from a URL or local path
list_postsList posts, optionally filtered by status/platform
get_postGet a single post by ID
get_post_statsViews, likes, comments and shares for a published post, plus its public URL
update_postUpdate a post's caption/schedule/timezone/status
delete_postDelete a post
retry_postRetry a failed post

Media handling differs by transport

The local stdio server can read files from your machine, so create_post accepts mediaPath as well as mediaUrl. The hosted endpoint obviously cannot reach your disk — it takes mediaUrl/imageUrls, or mediaBase64 with an optional mediaFilename to set the MIME type.

Full request/response shapes and per-platform metadata options (YouTube category/privacy, TikTok privacy level, Instagram media type, etc.) are documented at qpost.dev/docs — this server is a thin wrapper over that same REST API.

Both the stdio server and the hosted endpoint speak MCP 2026-07-28 and still accept clients on 2025-era protocol versions. The stdio server needs Node 20+.

Publishing from n8n?

Use the tested n8n video-to-draft workflow. It uses built-in HTTP Request nodes, works without a community package, and saves a draft before you publish. The page includes the downloadable JSON and the settings to change.

For TikTok app-review restrictions, see self-hosted publishing options.

Local development

bash
npm installnpm run dev   # runs src/index.ts directly via tsxnpm run build # compiles to dist/

License

MIT

來源：README.md，提交 abd3931

工具

8

list_connected_accounts

List the YouTube/TikTok/Instagram accounts connected to this QPost account. Call this before creating a post to see which platforms are available.

無需輸入參數。

create_post

Create and publish (or schedule) a video or image post to connected platforms. Media must be supplied as a publicly reachable URL (mediaUrl / imageUrls) or base64 (mediaBase64) — this is a hosted server and cannot read files from your machine. Omit scheduledFor to publish immediately.

輸入參數titlecaption必填mediaUrltimezoneimageUrlsmediaKind必填platforms必填mediaBase64scheduledFormediaFilename

list_posts

List posts on this account, optionally filtered by status or platform.

輸入參數statusplatform

get_post

Get a single post by ID, including per-platform publish status.

輸入參數id必填

get_post_stats

How a published post is doing: views, likes, comments and shares per platform, read live from the platform (TikTok so far), plus each platform's public URL.

輸入參數id必填

update_post

Update a post's caption, schedule, timezone, or status. Only the fields you pass are changed.

輸入參數id必填statuscaptiontimezonescheduledFor

delete_post

Permanently delete a post you own.

輸入參數id必填

retry_post

Retry publishing a post that previously failed.

輸入參數id必填

版本歷史

2
  1. v0.4.0最新Oct 29, 2026
  2. v0.3.0Sep 16, 2026

評分

已滿足適用檢查項的 100%

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

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分