Post for Me MCP Pro

postforme-mcp-pro 📱

最完整的 Post for Me MCP 服务——通过任意 MCP 客户端，在 9 个平台上发布、安排发布、编辑、删除和分析社交媒体帖子。

postforme-mcp-pro 将 Post for Me API 封装为 27 个以上完全类型化的 MCP 工具（每项操作对应一个工具），另提供 postforme_raw 备用入口和只读安全模式。与仅提供文档搜索和沙盒代码执行工具（“代码模式”）的官方 MCP 不同，这里的每项操作都是一等、可直接调用的工具，因此模型无需编写 SDK 代码即可发布帖子、安排发布并获取分析数据。

**平台：**Instagram · Facebook · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Threads

为什么选择此服务

• 27+ 个类型化工具 — create_post、schedule_post、publish_now、create_draft、upload_media、list_account_feeds、list_post_results、账户和 webhook 管理等。
• 高级快捷工具 — publish_now / schedule_post / create_draft / reschedule_post / upload_media 将常见的多步骤工作流整合为一次调用。
• 一步完成媒体上传 — upload_media 接受本地文件路径或公共 URL，获取签名 URL、上传文件内容，并返回可直接附加的 media_url。
• 按平台调整 — platform_configurations 支持 Instagram Reels、X 投票、TikTok 隐私设置、YouTube 可见性等，并允许使用新的选项。
• 只读安全模式 — POSTFORME_READONLY=true 会阻止所有写入操作，非常适合仅分析的会话。
• postforme_raw — 调用任意端点，全面覆盖 API，甚至包括全新端点。
• 弹性客户端 — 使用 Bearer 身份验证，在遇到 429/5xx 时进行退避重试，并提供可操作的错误消息。

安装

npm install
npm run build

或者，克隆仓库后也可以直接运行已发布版本：

npx -y postforme-mcp-pro

配置

将 .env.example 复制为 .env，并设置密钥：

变量	必需	描述
POSTFORME_API_KEY	✅	你的 Post for Me API 密钥（Dashboard → Settings → API Keys）。
POSTFORME_BASE_URL	—	为可自托管/开源部署覆盖 API 基础 URL。默认值为 https://api.postforme.dev。
POSTFORME_READONLY	—	true 会阻止所有写入工具（仅运行读取操作和 postforme_raw GET）。
POSTFORME_DISABLE_RAW	—	true 会移除 postforme_raw 工具。
POSTFORME_TIMEOUT_MS	—	每次请求的超时时间（默认值：60000）。
POSTFORME_MAX_RETRIES	—	遇到 429/5xx/网络错误时的最大重试次数（默认值：3）。

本地测试

npx @modelcontextprotocol/inspector node dist/index.js

添加到 Claude Code

.claude/settings.json → mcpServers：

"postforme": {
  "command": "node",
  "args": ["projects/postforme-mcp-pro/dist/index.js"],
  "env": { "POSTFORME_API_KEY": "pfm_xxx" }
}

添加到 Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json（Windows）/ ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

"postforme": {
  "command": "node",
  "args": ["/abs/path/projects/postforme-mcp-pro/dist/index.js"],
  "env": { "POSTFORME_API_KEY": "pfm_xxx" }
}

Cursor 在其 MCP 文件中使用相同的配置格式。

工具

社交账户

工具	描述
list_social_accounts	列出已连接的账户（可按平台/用户名筛选）。
get_social_account	根据 ID 获取一个账户。
create_social_account	提供凭据以连接账户。
update_social_account	更新已存储的凭据/元数据。
create_auth_url	启动 OAuth 连接流程（返回一个 URL）。
disconnect_social_account	撤销账户的访问权限。
list_account_feeds	**分析：**账户的近期动态和互动指标。

帖子

工具	描述
create_post	跨多个账户创建帖子（立即发布、定时发布或保存为草稿）。
publish_now	快捷工具：立即发布。
schedule_post	快捷工具：安排在 ISO-8601 时间发布。
create_draft	快捷工具：保存为草稿。
get_post	根据 ID 获取帖子。
list_posts	列出帖子（可按状态筛选）。
update_post	编辑说明文字/媒体/账户/发布时间/配置。
reschedule_post	快捷工具：更改已安排的发布时间。
delete_post	删除帖子。

结果和预览

工具	描述
list_post_results	**分析：**各平台的发布结果。
get_post_result	根据 ID 获取一条帖子结果。
create_post_preview	预览帖子在各平台上的呈现效果。

媒体

工具	描述
create_media_upload_url	获取签名上传 URL（两步流程）。
upload_media	**一步完成：**上传本地文件或远程 URL → 返回 media_url。

Webhook

工具	描述
list_webhooks · get_webhook · create_webhook · update_webhook · delete_webhook	管理事件订阅。

应急入口

工具	描述
postforme_raw	直接调用任意 /v1/... 端点（方法、路径、参数、请求体）。

配套技能

/postforme（位于 skill/SKILL.md）将这些工具编排为引导式工作流：post、schedule、campaign、analytics、accounts、media。将其复制到 .claude/skills/，即可在 Claude Code 中使用。

示例

You: post "Lançamos a v2 🚀" no instagram e no x, com a imagem ./hero.png
→ list_social_accounts            (get the instagram + x account ids)
→ upload_media { file_path: "./hero.png" }   → media_url
→ create_post_preview             (optional, confirm look)
→ publish_now { social_accounts: [...], caption: "...", media: [{ url: media_url }] }
→ list_post_results               (report success/links per platform)

与官方 MCP 的比较

	postforme-mcp-pro	官方 post-for-me-mcp
工具模型	27 个类型化工具，每个操作对应一个工具	2 个工具（文档搜索 + 代码执行沙箱）
调用方式	直接调用工具	模型必须在沙箱中编写 SDK 代码
快捷方式	publish_now / schedule_post / create_draft / upload_media	—
安全性	POSTFORME_READONLY 模式 + SSRF/文件读取加固	—
应急入口	postforme_raw（任意 /v1 端点）	代码执行
配套技能	/postforme 引导式工作流	—

安全性

upload_media 会加固远程获取流程以防范 SSRF（DNS 解析 + 公网单播 IP 验证、不跟随重定向、限制大小），并将本地文件读取限制为已识别的媒体扩展名（可选限制在 POSTFORME_MEDIA_DIR 内）。postforme_raw 路径经过验证，确保其位于版本化 API 范围内。完整审计请参阅 REVIEW.md。

许可证

MIT © Helbert Paranhos / Strat Academy