PostLake

PostLake：AI Agent 的社交操作系统

为 Agent 提供一种可靠的社交运营方式。 PostLake 让 Agent 能够在 X、LinkedIn、Instagram、TikTok、Facebook、Threads、Bluesky、YouTube 和 Pinterest 上发布、安排发布、监控、发现、回复、管理内容并从中学习。

一次连接即可为 Agent 提供一套标准化契约，而不必分别使用 9 个平台 SDK、9 种身份验证模式和 9 种互不兼容的结果格式。它可以通过托管 MCP 服务、即插即用的 Agent 技能或 REST API 执行操作。

Agent 可以规划营销活动，在消耗额度前验证每个目标平台，发布内容或保存草稿以供审批，确认异步帖子，读取对话和评论，处理需要回复的内容，并利用结果决定下一步行动。

• 托管 MCP： https://api.postlake.dev/mcp
• 文档： https://docs.postlake.dev
• 网站： https://postlake.dev
• 机器可读文档： https://postlake.dev/llms.txt
• MCP 注册表： dev.postlake/social
• Grok Build： 从插件市场安装 postlake，或将此仓库添加为市场来源

Agent 为什么使用 PostLake

一套契约，覆盖所有社交网络

一次发布，或同时发布到所有已连接的社交网络。每个目标平台都采用相同的状态、URL、时间和错误格式，因此 Agent 只需处理一次结果，无需编写平台专属的故障恢复逻辑。

放心让 Agent 执行操作

validate_post 可在发布前免费试运行。幂等键让重试更加安全。所有者可以要求 OAuth 连接必须经过审批，这会将该 Agent 的每个发布请求都转为草稿，并防止它审批自己的工作。confirm_post 会在提供方接受帖子后检查异步处理状态；每项操作都会报告各个目标的结果，而不会掩盖部分失败。

不只是发布接口

Agent 可以读取包含通知、私信、评论和帖子表现的统一动态。然后，它可以回复、管理内容、互动、研究话题，或在采取行动前检查账号。社交管理与发布处于同一工作流中。

在适当环节保留人工控制权

通过 OAuth，账号所有者可在浏览器中批准连接。get_connect_link 让 Agent 能直接将所有者引导至审批步骤。所有者可以撤销 Agent、管理渠道、设置 Agent 限制，并在 PostLake 中要求审批。OAuth Agent 无法创建不受限制的账号密钥来绕过这些控制，也永远不需要社交网络密码。

几分钟内开始使用

托管 MCP：Cursor、Claude、ChatGPT、Gemini、Copilot 等

PostLake 是远程 Streamable HTTP MCP 服务。无需安装、运行或自行托管。在 MCP 客户端中添加此服务，然后完成一次 PostLake OAuth 审批即可。

PostLake 支持协议修订版本 2026-07-28、2025-11-25、2025-06-18 和 2025-03-26。现有客户端可以继续使用旧版握手；较新的客户端则使用 server/discover 和逐请求元数据。/mcp 和 API 密钥兼容端点 /v1/mcp 均会保留 Agent 身份、审批保护措施和发布限流。工具注解只是保守提示，并非权限。通过 OAuth 连接或受限的 Agent 无法创建不受限制的 API 密钥来绕过所有者控制。

{
  "mcpServers": {
    "postlake": {
      "url": "https://api.postlake.dev/mcp"
    }
  }
}

Cursor

打开 Settings -> Tools & MCP -> New MCP server，添加上述配置，然后选择 PostLake 的 Connect，并批准浏览器中的登录请求。

Claude Code

claude mcp add --transport http postlake https://api.postlake.dev/mcp

Grok Build

此代码仓库是 Grok Build 插件，提供托管的 MCP 服务和 Agent 技能。无需本地进程、Shell 钩子，也无需在聊天中提供 API 密钥。

将此仓库添加为市场，然后安装 postlake：

grok plugin marketplace add PostLake/postlake-mcp
grok plugin install postlake --trust

官方 xAI 目录收录该插件后，你也可以在 Grok Build 中浏览 /marketplace。

MCP 服务地址为 https://api.postlake.dev/mcp（Streamable HTTP）。首次使用时，Grok 会在浏览器中打开 PostLake OAuth。账户所有者批准 Agent 一次后，即可在 https://app.postlake.dev/app/agents 撤销授权。

此插件只会调用：

• https://api.postlake.dev（MCP 和 REST）
• https://postlake.dev 和 https://docs.postlake.dev（技能引用的文档）
• https://app.postlake.dev（OAuth 授权和控制面板）

此仓库中的 openclaw/ 是独立的 OpenClaw 软件包。Grok Build 不会加载它。

其他 MCP 客户端

将 https://api.postlake.dev/mcp 添加为远程 MCP 服务。初始 OAuth 挑战会打开主机的登录和授权流程。完整的设置说明： https://docs.postlake.dev/mcp

即装即用的技能：编码 Agent

为 Claude Code、Cursor、Codex、Windsurf 和其他兼容技能的编码 Agent 安装 PostLake 的 Agent 技能：

npx skills add postlake/postlake-mcp --all

在 Agent 的运行时中设置 POSTLAKE_API_KEY，然后用日常语言让它处理社交媒体事务。这些技能涵盖账户、发布、排期、媒体、收件箱对话和分析。

REST API：自定义 Agent 运行时

通过 LangGraph、CrewAI、AutoGen、OpenAI 工具调用或任何 HTTPS 客户端使用 https://api.postlake.dev/v1。REST API 和 MCP 服务使用相同的个人资料、频道、帖子和安全规则。

Agent 可以做什么

MCP 服务目前提供 63 个专用工具。这些工具围绕社交目标设计，而非针对各个平台 API。

目标	工具
了解账号	whoami、set_my_name、get_changelog、get_credits、list_profiles、list_social_accounts、get_social_account、list_account_targets、search_facebook_pages、check_allowance
连接和整理渠道	create_profile、rename_profile、delete_profile、connect_account、get_connect_link、disconnect_account
规划和验证	get_platform_capabilities、get_publish_info、validate_post
发布和安排日程	create_post、create_scheduled_calendar、get_post、confirm_post、list_posts、edit_post、edit_scheduled_posts_bulk、cancel_post、publish_draft、delete_post
媒体	upload_media、upload_media_batch、manage_media
统一收件箱	list_notifications、mark_notifications_seen、list_conversations、read_conversation、mark_conversation_read、send_message、read_comments、reply_to_comment、hide_comment、delete_comment
发现并了解社交网络	search_posts、look_up_profile、read_profile_posts、search_places、list_own_posts、list_tagged_posts
互动并管理社交形象	engage、update_profile
商务、活动和合作	list_products、list_events、create_event、find_creators
Facebook 公共主页直播	create_live_broadcast、start_live_broadcast、list_live_broadcasts、get_live_broadcast、end_live_broadcast
衡量并改进	get_post_analytics、get_analytics

set_my_name 只会更改已认证 Agent 的显示名称。账号所有者可以在 Agent Control 中设置并锁定该名称。重命名不会更改底层 API 密钥或 OAuth 客户端身份。

目前不提供 Meta 广告和 Partnership Ads 工具。不要要求 Agent 使用品牌合作伙伴、广告账号或 Partnership Ads 操作。

list_posts 支持有界游标分页，并可按状态、Agent、个人资料、网络、日期、审批状态、活动、单一或共享目标组合进行筛选，也支持通过 q 进行不区分大小写的字面说明文字搜索。这让 Agent 无需将整个账号的帖子全部载入单个工具响应，就能检查发布历史。REST 端点 GET /v1/posts 使用相同的搜索和分页行为。

edit_scheduled_posts_bulk 可在一次受保护的操作中更改最多 200 个已安排日程的帖子。先使用 dryRun: true 预览，检查每个帖子的更改前后值，然后使用返回的 snapshot 应用更改。它可以更改说明文字、各网络的说明文字、确切的目标账号、活动和素材元数据，或调整安排发布时间的 UTC 时刻。如果所选帖子在应用前发生变化，整个编辑操作都会被拒绝。create_scheduled_calendar 可在单个事务中预览并创建最多 200 个已安排日程的帖子，支持明确指定时间或按经过的 UTC 时间间隔设置频率。使用唯一的幂等键应用其预览快照。REST 批量取消端点也可以原子性地移除精确选定的一批帖子。创建新日程表和取消旧日程表仍是两个独立操作。

使用账号密钥进行身份验证的 MCP 调用方也可以使用 create_api_key，将权限交给另一项受信任的服务。OAuth Agent 看不到也无法获取此工具，因为账号密钥会绕过账号所有者设置的限制。

取消、在社交平台删除及上传内容擦除

这些是彼此独立的操作。cancel_post 会停止后续发布并保留已上传的文件。delete_post 会请求受支持的平台删除内容，并报告每个目标平台的结果；已发布到 Instagram 和 TikTok 的帖子必须在各自的应用中删除。这两种操作都不会擦除上传内容，也不会退还已花费的发布点数。

先使用 delete_post 并设置 dryRun: true，预览各目标平台是否支持删除；然后获取所有者确认，并在执行时发送返回的 snapshot。部分结果中已接受的删除请求会被记录，重试时不会重复发送。

manage_media 使用 action: "list" 列出存储的文件。使用 action: "preview_delete" 并提供媒体 ID，查看受影响的帖子并获取 snapshot。只有在所有者确认不可逆的擦除操作后，Agent 才应使用该 snapshot 执行 action: "delete"。草稿、审批请求和待发布内容必须先停止使用该文件。源文件字节和存储的预览图会被删除；已发布的社交平台副本仍会保留在线。存储失败仍可重试。已保存的引用超过 200 个时，需要由支持团队协助擦除。

上传的素材在每个开放账户中仍至少保留 90 天；对于较长的计划引用，保护期也会相应延长，目前没有自动过期机制。所有者明确要求擦除是例外情况，并非常规的过期策略。源文件和预览图使用公共 URL。请保留可长期使用的原件，且永远不要上传机密信息。 完整的 REST 合约和控制面板操作说明： https://docs.postlake.dev/media#deletion.

不损害信任的 Agent 工作流

1. 调用 whoami 和 list_social_accounts，了解账户、限额、已连接的渠道以及当前就绪状态。
2. 如果仍需由人工连接渠道，调用 get_connect_link 并将短时有效的审批 URL 发送给对方。不要让对方自行在控制面板中寻找。
3. 创建多平台帖子前，调用 get_platform_capabilities 和 validate_post。PostLake 会返回每个目标平台的具体限制和修正方法。
4. 使用 create_post 发布、安排发布，或保存为供人工审核的 draft。如果所有者启用了 Require my approval，即使 Agent 未要求创建草稿，PostLake 也会保存草稿。请提供幂等键，以免重试导致重复发布。
5. 如果平台正在异步处理，请调用 confirm_post 获取经服务提供方确认的状态，无需等待公开 URL。
6. 使用 list_notifications、list_conversations 和 read_comments 查看需要处理的事项。仅在平台支持时回复、审核或互动。
7. 使用 get_analytics 和 get_post_analytics 将结果转化为下一步有依据的行动，而不是留给别人稍后解读的电子表格。

私信

Facebook、Instagram、X 和 Bluesky 使用统一的对话格式。Agent 使用 list_conversations 列出对话串，使用 read_conversation 打开对话，使用 mark_conversation_read 将其标记为已读，并使用 send_message 回复。消息可包含用于附件、共享媒体或服务提供方负载的 content，这类内容 PostLake 无法安全地扁平化为文本。

Facebook 和 Instagram 可以发送 message.received Webhook。X 和 Bluesky 不会将收到的私信推送到 PostLake，因此请按计划轮询 list_conversations。在 X 上发送私信需要 6 个点数；在其他受支持的收件箱平台上发送私信不会消耗点数。完整的 REST 和 MCP 指南： https://docs.postlake.dev/messages.

示例提示词

• “检查所有已连接的渠道，然后告诉我哪些操作需要人工审批。”
• “为 LinkedIn、Instagram、Threads 和 TikTok 撰写一篇发布文案。验证文案，将其保存为草稿，并向我展示针对各平台所做的调整。”
• “阅读新的私信和评论。为我提供简洁的回复草稿，但在我批准之前不要发送任何内容。”
• “查找大家对这个主题的讨论，查看最具影响力的三个账号，然后提出一篇能带来有用见解的帖子。”
• “确认昨天发布的 TikTok 帖子，然后将其表现与本周其他帖子的表现进行比较，并推荐下一篇帖子。”

了解平台特性，而非忽视平台差异

PostLake 了解会导致社交自动化在现实中失败的各种限制：媒体类型、图片数量、说明文字长度限制、创作者级别的 TikTok 设置、特定网络的隐私选项、帖子发布位置、异步发布，以及特定连接能否读取、搜索、发送消息或互动。

如果某个平台无法执行某项操作，PostLake 会在响应中明确说明。空列表绝不会含糊地表示未读取某个网络。部分发布不会假装所有发布位置都已成功。Agent 能获得安全恢复所需的信息。

此代码库包含的内容

路径	用途
skills/	Claude Code、Cursor、Codex、Windsurf（npx skills add postlake/postlake-mcp --all）
.mcp.json	Grok Build、Claude Code 插件、Cursor 插件。仅限托管 MCP。
.grok-plugin/	Grok Build 插件清单
.claude-plugin/	Claude Code / Cursor 插件清单
openclaw/	仅供 OpenClaw 使用。不属于 Grok 或 Claude 插件的一部分。

安全与所有权

对于交互式 MCP 客户端，PostLake 使用 OAuth 和 PKCE。账号所有者只需批准每个已连接的 Agent 一次，并可随时在控制面板中撤销授权。OAuth 令牌仅限该客户端使用，并会自动刷新。所有者可以设置个人资料、平台、每日额度、套餐额度和审批限制。需要审批的 Agent 无法发布自己的草稿，也无法创建不受限制的账号 API 密钥。

对于无人值守的服务，请在服务的机密存储中使用 PostLake API 密钥，而不要将其放入提示词或源文件中。密钥拥有账号级访问权限，因此应为每个受信任的服务使用单独命名的密钥，并在不再需要时将其撤销。

定价

每种套餐都包含 MCP 服务和 Agent 访问权限。每月可免费使用 20 个额度，无需绑定银行卡。发布内容时，或平台对特定操作收费时，会扣除额度。在 X 上，send_message 会消耗 6 个额度；在 Facebook、Instagram 和 Bluesky 上发送消息不消耗额度。请访问 https://postlake.dev/pricing 查看当前定价和额度费率。

文档

• MCP 设置和工具参考：https://docs.postlake.dev/mcp
• 快速入门：https://docs.postlake.dev/quickstart
• 发布和日程安排：https://docs.postlake.dev/publishing
• 阅读、收件箱和互动：https://docs.postlake.dev/reading
• API 参考：https://docs.postlake.dev

由 PostLake 构建。欢迎提交问题和拉取请求。