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 分