Telegram 帖子
使用 Publora MCP 服务器创建并定时发布帖子到 Telegram 频道和群组。支持丰富的 Markdown 格式、图片、视频以及消息投递选项。
前提条件
套餐： 可免费使用 Starter 套餐。当前限制与定价：publora.com/pricing。
开始使用
- 注册账号 于 publora.com/register（免费）
- 创建 Telegram 机器人：
- 在 Telegram 中向 @BotFather 发送消息
- 发送
/newbot并按照指示操作 - 保存机器人 Token
- 将机器人添加到你的频道：
- 将机器人添加为频道/群组的管理员
- 授予
can_post_messages权限
- 在 Publora 中连接，前往控制台，使用机器人 Token 和频道名称
- 获取 API 密钥 于 app.publora.com/dashboard/api
- 将你的智能体连接到 MCP 服务器，地址为
https://mcp.publora.com，使用Authorization: Bearer sk_YOUR_API_KEY进行身份验证。在 Claude Code 中：
claude mcp add publora --transport http https://mcp.publora.com \
--header "Authorization: Bearer sk_YOUR_API_KEY"
Claude Desktop、Cursor、Codex、OpenClaw 以及 claude.ai 连接器各自需要不同的配置文件或流程：请参阅客户端设置了解准确的路径和代码片段。
REST API 回退方案
如果 MCP 服务器不可用或返回错误，可直接使用 REST API：
基础 URL： https://api.publora.com/api/v1
身份验证： 使用 x-publora-key 头（不是 Authorization: Bearer）：
# 获取你已连接的平台
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
-H "x-publora-key: sk_your_api_key"
# 创建帖子
curl -X POST "https://api.publora.com/api/v1/create-post" \
-H "x-publora-key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"platforms": ["telegram-1001234567890"],
"content": "*公告*\n\n你的消息在此",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
平台 ID 格式： telegram-{chat_id}，其中 {chat_id} 是来自 /platform-connections 的频道/群组数字 ID。
示例 ID：telegram-1001234567890、telegram--1002345678901
📖 完整 API 文档： docs.publora.com
平台限制（Bot API）
| 功能 | 限制 |
|---|---|
| 文本消息 | 4,096 个字符 |
| 媒体标题 | 1,024 个字符（关键限制！） |
| 图片 | 最大 10 MB，每个媒体组最多 10 张 |
| 图片格式 | JPEG、PNG、GIF、BMP、WebP |
| 视频大小 | 最大 50 MB（不是 4 GB——那是普通用户的！） |
| 视频格式 | MP4、MOV、AVI、MKV、WebM |
| 速率限制 | 全局 30 条消息/秒，每个群组 20 条消息/分钟 |
关键点： Bot API 的限制远低于普通 Telegram 用户。超过 50 MB 的视频和超过 1,024 个字符的标题会失败。
Markdown 格式
Telegram 使用自己的 Markdown 风格，单个星号表示加粗：
| 语法 | 结果 |
|---|---|
*粗体* | 粗体 |
_斜体_ | 斜体 |
`代码` | 内联代码 |
代码```` | 代码块 |
[文本](url) | 超链接 |
> 文本 | 块引用 |
注意： 这与标准 Markdown 不同，标准 Markdown 中 **双星号** 表示加粗。
可用工具
create_post
创建新的 Telegram 帖子。
参数：
platforms：包含你的 Telegram 连接 ID 的数组（例如["telegram-1001234567890"]）content：消息文本（支持 Markdown）scheduledTime：ISO 8601 UTC 日期时间。可选：省略则帖子创建为草稿。传入未来的时间则定时发送。如果时间早于当前时间五分钟或更多，将返回SCHEDULED_TIME_IN_PAST错误，因此要立即发布请使用当前时间加一分钟。mediaUrls：最多 10 个公开的 https 图片或视频 URL。Publora 在服务端下载它们并在验证之前附加，因此媒体和定时通过一次调用完成。这是草稿加get_upload_url加complete_media流程的一次性替代方案。上传速率限制为每小时 60 个 URL。
get_upload_url
获取用于媒体上传的预签名 URL。
complete_media
当预签名 PUT 成功后，完成通过 get_upload_url 上传的文件。可选，因为定时也会完成待处理的媒体，但提前调用可以提前暴露格式和探测错误。对于通过 mediaUrls 附加的媒体不需要此步骤。
参数：
mediaId：get_upload_url返回的 ID
list_connections
列出你已连接的账号及其平台 ID。先调用此工具并逐字复制 ID；它们永远无法猜测。
list_posts / get_post / update_post / delete_post
管理定时和草稿帖子。update_post 还可以在草稿或定时帖子中修补 content 和 platforms，因此修复拼写错误或重新定向不再需要删除和重新创建。delete_media 和 prune_media_reference 用于清理上传的文件。
帖子选项（通过 REST API）
通过 REST API 的 platformSettings.telegram 可用的 Telegram 特定选项：
| 选项 | 描述 |
|---|---|
disableNotification | 静默发送（无声音） |
disableWebPagePreview | 无链接预览卡片 |
protectContent | 禁止转发/保存 |
标题位于媒体上方不可设置：showCaptionAboveMedia 不是可接受的键，发送它会返回 400 PLATFORM_SETTING_UNKNOWN。
注意：platformSettings 在 MCP 的 create_post 和 update_post 工具以及 REST 中均可接受。该模式是严格的：拼写错误的平台或键会被验证错误拒绝，而不是静默忽略。
示例
简单频道帖子
将以下内容发布到我的 Telegram 频道：
"*产品更新 v2.5*
我们已发布以下改进：
- _更快的 API 响应时间_（平均 45 毫秒）
- 新的 `batch` 端点用于批量操作
[阅读变更日志](https://example.com/changelog)"
格式化公告
创建具有以下格式的 Telegram 帖子：
"*重要更新*
我们明天 UTC 时间上午 10:00 发布新功能。
_新内容：_
- 功能 A 改进
- 功能 B 发布
[阅读完整公告](https://example.com/update)"
带图片的帖子
将这张图片发布到我的 Telegram 频道，并附带标题：
"*全新控制面板预览*
这是重新设计的分析控制面板的抢先预览。"
重要： 当发布带媒体的帖子时，标题必须少于 1,024 个字符。
定时帖子
将此内容定时为明天莫斯科时间上午 8 点发布：
"*早安！* 这是每日市场摘要..."
重要限制
-
标题限制为 1,024 字符：当发布带媒体（图片/视频）的帖子时，文本作为标题发送，限制为 1,024 个字符。纯文本消息允许 4,096 个字符。
-
视频最大 50 MB：Bot API 将视频限制为 50 MB（而不是普通用户的 4 GB）。大视频会失败。
-
机器人必须是管理员：你的机器人需要管理员角色和
can_post_messages权限。这在连接时会验证。 -
不允许混合媒体：单个帖子不能同时包含图片和视频。
-
标题溢出：如果媒体帖子的标题超过 1,024 个字符，它将作为单独的回复消息发送，而不是被截断。
最佳实践
内容
- 使用格式：加粗标题、斜体强调可提高可读性
- 链接预览：非常适合文章；对于简洁的公告请禁用
- 表情符号使用：在 Telegram 上常见且受欢迎
- 帖子长度：纯文本消息没有长度惩罚
时机
- 全球受众：Telegram 用户遍布全球；考虑时区发帖
- 最佳时间：目标地区的 8-10 点、12-14 点、19-21 点
- 频率：频道可以更频繁地发帖（每天 5-10 条）
互动
- 在频道设置中启用评论以进行讨论
- 使用投票提高参与度
- 置顶重要公告
故障排除
| 错误 | 原因 | 解决方案 |
|---|---|---|
| "Bot not admin" | 机器人缺少管理员权限 | 将机器人添加为管理员并授予 can_post_messages |
| "Channel not found" | 频道名称/ID 错误 | 验证 @channelname 或数字聊天 ID |
MEDIA_CAPTION_TOO_LONG | 标题超过 1,024 个字符 | 缩短标题或使用纯文本帖子 |
| "Bad Request: file is too big" | 文件超过 50 MB | 将视频/图片压缩到 50 MB 以下 |
| "Mixed media not supported" | 同一帖子中包含图片和视频 | 每个帖子仅使用一种媒体类型 |