publora-bluesky

使用 Publora API 将内容发布或安排到 Bluesky。使用这个技能 当用户想要通过 Publora 发布或安排 Bluesky 帖子时。

## 概述（中文）

使用 Publora API 将内容发布或安排到 Bluesky。使用这个技能
当用户想要通过 Publora 发布或安排 Bluesky 帖子时。

## 原文

# Publora — Bluesky

Bluesky (AT Protocol) platform skill for the Publora API. For auth, core scheduling, media upload, and workspace/webhook docs, see the `publora` core skill.

**Base URL:** `https://api.publora.com/api/v1`  
**Header:** `x-publora-key: sk_YOUR_KEY`  
**Platform ID format:** `bluesky-{did}`

Where `{did}` is your Bluesky Decentralized Identifier (DID), assigned on connection.

## Requirements

- A Bluesky account connected via **username + app password** (not your main password)
- Generate an app password: Bluesky Settings → App Passwords
- Connected through the Publora dashboard

## Platform Limits (API)

| Property | Limit | Notes |
|----------|-------|-------|
| Text | **300 characters** | ⚠️ Links count toward limit in Publora's validation |
| Images | Up to **4** × **~976 KB** | All formats accepted; Publora converts everything to JPEG before upload |
| Image dimensions | Max 2000×2000 px | — |
| Video | **3 min** / **100 MB** | MP4; email verification required |
| Video (short) | <60s → 50 MB | Size tiers apply |
| Text only | ✅ Yes | — |
| Daily video limit | 25 videos / 10 GB | — |
| Rate limit | 3,000 req/5 min | — |

**Common errors:**
- `429 Too Many Requests` — rate limit exceeded, wait and retry
- Video `JOB_STATE_FAILED` — check format (MP4) and size tier

## Post a Skeet (text post)

```javascript
await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: 'Building in public on Bluesky today! Links, hashtags, and mentions all auto-detected. #buildinpublic',
    platforms: ['bluesky-did:plc:abc123']
  })
});
```

Publora automatically detects hashtags, URLs, and @mentions and creates proper AT Protocol facets.

## Schedule a Post

```javascript
body: JSON.stringify({
  content: 'Your Bluesky post here',
  platforms: ['bluesky-did:plc:abc123'],
  scheduledTime: '2026-03-20T11:00:00.000Z'
})
```

## Post with Image

> ⚠️ Bluesky has a strict **1 MB limit per image**. Compress to 80–85% JPEG quality.

```python
import requests

HEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }

# Step 1: Create post
post = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={
    'content': 'Check out this photo! 📸',
    'platforms': ['bluesky-did:plc:abc123']
}).json()

# Step 2: Get upload URL (make sure image is <1 MB and JPEG/PNG/WebP)
upload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={
    'postGroupId': post['postGroupId'],
    'fileName': 'photo.jpg',
    'contentType': 'image/jpeg',
    'type': 'image'
}).json()

# Step 3: Upload
with open('photo_compressed.jpg', 'rb') as f:
    requests.put(upload['uploadUrl'], headers={'Content-Type': 'image/jpeg'}, data=f)
```

## Platform Quirks

- **Links count in Publora's validation**: Bluesky natively excludes link URLs from the char count, but Publora validates against `content.length` — so links DO consume your 300-char budget. Plan accordingly.
- **All images → JPEG**: Publora converts ALL uploaded formats (PNG, WebP, GIF, TIFF, BMP) to JPEG via sharp before uploading to Bluesky. No manual conversion needed.
- **Image size is ~976 KB** (not 1 MB): Publora enforces 976.56 × 1024 bytes. Compress images to 80–85% JPEG quality to stay under.
- **Auto-facets**: Publora automatically detects #hashtags and URLs and creates proper Bluesky facets with correct byte offsets (handles emojis and multi-byte chars correctly)
- **`altTexts` silently ignored in API**: The `altTexts` array in `create-post` is NOT currently processed — it will be silently ignored. Alt text is only available through the Publora dashboard.
- **`test-connection` always fails for Bluesky**: Known bug — the validator checks for `accessToken` but Bluesky uses `password`. Connection still works for posting; ignore this status.
- **App password required**: Never use your main Bluesky password; create a dedicated app password in Settings → App Passwords
- **Email verification required** before video uploads (one-time step in Bluesky settings)
- **DID format**: Platform ID uses the full DID, e.g. `bluesky-did:plc:abc123xyz`