bluesky-post

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Bluesky Post

Bluesky 内容发布

Create and schedule posts to Bluesky using the Publora MCP server. Supports text posts with auto-detected hashtags and URLs, images with alt text, and videos.

使用Publora MCP服务器创建并调度发布到Bluesky的内容。支持自动检测话题标签和URL的文本内容、带替代文本的图片以及视频。

Prerequisites

前提条件

Plans: Free Starter (15 posts/month), Pro, Premium

套餐方案：免费入门版（每月15条内容）、专业版、高级版

Getting Started

快速开始

Create account at publora.com/register (free)
Generate app password in Bluesky Settings > App Passwords (NOT your main password)
Connect Bluesky in Publora Dashboard using your handle + app password
Get API key at publora.com/settings/api
Configure MCP in Claude Desktop (
```
~/.claude/claude_desktop_config.json
```
):

json

{
  "mcpServers": {
    "publora": {
      "type": "http",
      "url": "https://mcp.publora.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

创建账号：访问publora.com/register（免费）
生成应用密码：在Bluesky设置>应用密码中生成（请勿使用主密码）
连接Bluesky：在Publora控制台中使用你的用户名+应用密码进行连接
获取API密钥：访问publora.com/settings/api
配置MCP：在Claude Desktop中配置（文件路径：
```
~/.claude/claude_desktop_config.json
```
）：

json

{
  "mcpServers": {
    "publora": {
      "type": "http",
      "url": "https://mcp.publora.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

REST API Fallback

REST API 备用方案

If the MCP server is unavailable or returns errors, use the REST API directly:

Base URL:

https://api.publora.com/api/v1

Authentication: Use

x-publora-key

header (NOT

Authorization: Bearer

bash

undefined

如果MCP服务器不可用或返回错误，可直接使用REST API：

基础URL：

https://api.publora.com/api/v1

身份验证：使用

x-publora-key

请求头（请勿使用

Authorization: Bearer

格式）：

bash

undefined

Get your connected platforms

获取已连接的平台

curl -X GET "https://api.publora.com/api/v1/platform-connections"
-H "x-publora-key: sk_your_api_key"

Create a post

创建内容

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": ["bluesky-did:plc:abc123xyz"], "content": "Your post content here", "scheduledTime": "2026-03-25T10:00:00Z" }'


**Platform ID Format:** `bluesky-{did}` where `{did}` is from `/platform-connections` response.

Example IDs: `bluesky-did:plc:abc123xyz`, `bluesky-did:plc:def456uvw`

📖 **Full API documentation:** [docs.publora.com](https://docs.publora.com)

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": ["bluesky-did:plc:abc123xyz"], "content": "你的内容文本", "scheduledTime": "2026-03-25T10:00:00Z" }'


**平台ID格式**：`bluesky-{did}`，其中`{did}`来自`/platform-connections`接口的返回结果。

示例ID：`bluesky-did:plc:abc123xyz`, `bluesky-did:plc:def456uvw`

📖 **完整API文档**：[docs.publora.com](https://docs.publora.com)

Plan Limits

套餐限制

Plan	Posts/month	Price
Starter	15	Free
Pro	100/account	$2.99/account/month
Premium	500/account	$9.99/account/month

套餐	每月可发布内容数	价格
入门版	15	免费
专业版	100/账号	$2.99/账号/月
高级版	500/账号	$9.99/账号/月

Platform Limits

平台限制

Feature	Limit
Characters	300
Images	Up to 4 per post
Image size	~1 MB (976.56 KB)
Video duration	3 minutes
Video size	50-100 MB (based on duration)
Videos per day	25
Alt text	2,000 characters per image

功能	限制
字符数	300
图片数量	每条内容最多4张
图片大小	约1 MB（976.56 KB）
视频时长	3分钟
视频大小	50-100 MB（取决于时长）
每日视频数量	25
替代文本	每张图片最多2000字符

Video Size Tiers

视频大小层级

Duration	Max Size
Under 60s	50 MB
60s - 3min	100 MB

时长	最大大小
60秒以内	50 MB
60秒 - 3分钟	100 MB

Rich Text Facets

富文本格式处理

Bluesky uses a unique rich text system. Publora handles the complexity automatically:

Hashtags:
```
#hashtag
```
auto-detected and made clickable
URLs: Any URL auto-detected and made clickable
Byte offsets: Calculated correctly for multi-byte characters (emojis, CJK)

No special formatting needed - just write naturally.

Bluesky采用独特的富文本系统。Publora会自动处理相关复杂操作：

话题标签：
```
#hashtag
```
会被自动检测并设置为可点击
URL：任何URL都会被自动检测并设置为可点击
字节偏移量：针对多字节字符（表情符号、中日韩文字）计算准确

无需特殊格式——自然撰写即可。

Available Tools

可用工具

create_post

Create a new Bluesky post.

Parameters:

```
platforms
```
: Array with your Bluesky connection ID (e.g.,
```
["bluesky-did:plc:abc123xyz"]
```
)
```
content
```
: Post text (up to 300 characters)
```
scheduledTime
```
: ISO 8601 datetime (required - for immediate posting, use current time + 1 minute)
```
altTexts
```
: Array of alt text for images (optional)

创建新的Bluesky内容。

参数：

```
platforms
```
：包含你的Bluesky连接ID的数组（例如：
```
["bluesky-did:plc:abc123xyz"]
```
）
```
content
```
：文本内容（最多300字符）
```
scheduledTime
```
：ISO 8601格式的日期时间（必填——如需立即发布，使用当前时间+1分钟）
```
altTexts
```
：图片替代文本数组（可选）

get_upload_url

Get presigned URL for media uploads.

Parameters:

```
postGroupId
```
: Post ID to attach media to
```
fileName
```
: File name (e.g., "photo.jpg")
```
contentType
```
:
```
image/jpeg
```
,
```
image/png
```
,
```
video/mp4
```
```
type
```
:
```
"image"
```
or
```
"video"
```

获取媒体上传的预签名URL。

参数：

```
postGroupId
```
：要关联媒体的内容ID
```
fileName
```
：文件名（例如："photo.jpg"）
```
contentType
```
：
```
image/jpeg
```
,
```
image/png
```
,
```
video/mp4
```
```
type
```
：
```
"image"
```
或
```
"video"
```

list_posts / update_post / delete_post

Manage scheduled and draft posts.

管理已调度和草稿内容。

Examples

示例

Simple Post with Hashtags

带话题标签的简单内容

Post this to Bluesky:
"Just launched our new API documentation! Check it out at https://docs.example.com #devtools #api"

Hashtags and URLs are automatically made clickable.

发布以下内容到Bluesky：
"我们的新API文档已上线！查看地址：https://docs.example.com #devtools #api"

话题标签和URL会自动设置为可点击。

Post with Image and Alt Text

带图片和替代文本的内容

Post this to Bluesky with a dashboard screenshot:
"Our new analytics view is live! #buildinpublic"

Alt text: "Screenshot of analytics dashboard showing user growth charts"

发布以下内容到Bluesky并附上仪表盘截图：
"我们的新分析视图已上线！#buildinpublic"

替代文本："显示用户增长图表的分析仪表盘截图"

Multiple Images

多张图片

Create a Bluesky post with before/after comparison images:
"Office renovation complete! What a transformation."

Note: Up to 4 images allowed per post.

创建包含前后对比图片的Bluesky内容：
"办公室翻新完成！变化真大。"

注意：每条内容最多允许4张图片。

Video Post

视频内容

Post this 60-second demo video to Bluesky:
"Quick tour of our new mobile app features"

发布这条60秒演示视频到Bluesky：
"新移动应用功能快速导览"

Scheduled Post

调度发布内容

Schedule this for tomorrow at 10 AM:
"Good morning! Here's your daily productivity tip..."

调度以下内容在明天上午10点发布：
"早上好！这是你的每日生产力小贴士..."

Important Restrictions

重要限制

App password required: You must use a Bluesky app password, NOT your main account password. Generate one at Settings > App Passwords.
All images converted to JPEG: Regardless of input format (PNG, WebP, GIF), all images are converted to JPEG before upload.
~1 MB image limit: The AT Protocol enforces a strict ~1 MB limit. Compress images to 80-85% JPEG quality.
DID-based platform ID: Unlike other platforms using numeric IDs, Bluesky uses
```
did:plc:xxx
```
format.
Email verification for video: You must verify your email in Bluesky before uploading videos.
25 video daily limit: Maximum 25 videos OR 10 GB per day.

必须使用应用密码：你必须使用Bluesky应用密码，而非主账号密码。在设置>应用密码中生成。
所有图片将转换为JPEG格式：无论输入格式（PNG、WebP、GIF）如何，所有图片在上传前都会转换为JPEG格式。
约1MB图片限制：AT协议严格限制约1MB的大小。将图片压缩至80-85%的JPEG质量。
基于DID的平台ID：与其他使用数字ID的平台不同，Bluesky使用
```
did:plc:xxx
```
格式。
视频需验证邮箱：在上传视频前，你必须在Bluesky中验证邮箱。
每日视频限制25条：每日最多上传25条视频或10GB内容。

Best Practices

最佳实践

Content

内容创作

Concise posts: 300 chars is shorter than Twitter - be punchy
Natural hashtags: 1-2 relevant hashtags work well
Alt text: Always add alt text for accessibility
URLs work: Links are clickable (unlike some platforms)

内容简洁：300字符比Twitter更短——要简洁有力
自然使用话题标签：1-2个相关话题标签效果最佳
添加替代文本：为了可访问性，务必添加替代文本
URL可正常使用：链接是可点击的（与部分平台不同）

Timing

发布时机

Growing platform: Less crowded than X, easier to get noticed
Tech-savvy audience: Developer and early-adopter heavy
Frequency: 1-3 posts per day

增长中的平台：比X平台更不拥挤，更容易获得关注
技术导向受众：以开发者和早期用户为主
发布频率：每日1-3条内容

Engagement

互动技巧

Bluesky favors authentic conversation
Reply to comments to build community
Follow relevant users to grow network

Bluesky更倾向于真实的对话
回复评论以建立社区
关注相关用户以拓展人脉

Troubleshooting

故障排查

Error	Cause	Solution
"Invalid credentials"	Wrong password type	Use app password, not main password
"Image too large"	Over ~1 MB	Compress to 80-85% JPEG quality
"Content too long"	Over 300 chars	Shorten content (no auto-threading)
"Video daily limit"	25 videos reached	Wait 24 hours
"Email not verified"	Trying to upload video	Verify email in Bluesky settings

错误信息	原因	解决方案
"Invalid credentials"	密码类型错误	使用应用密码，而非主密码
"Image too large"	超过约1MB限制	压缩至80-85%的JPEG质量
"Content too long"	超过300字符	缩短内容（无自动分条功能）
"Video daily limit"	已达到每日25条视频限制	等待24小时
"Email not verified"	尝试上传视频但未验证邮箱	在Bluesky设置中验证邮箱